컴퓨터·개발 기초 입문

챕터

개요

이 가이드는 RAG 안내서를 시작하기 전에 깔아두는 "0번 챕터"입니다.
터미널을 한 번도 열어본 적이 없어도, 이 가이드를 끝내면 Git 가이드 첫 줄에서 막히지 않습니다.

이 가이드는 누구를 위한 것인가

"코드를 복붙하면 돌아간다"는 말이 막막하게 들리는 분을 위한 것입니다. 개발 입문서나 RAG 안내서는 대부분 "터미널을 열고 python app.py를 실행하세요" 같은 문장으로 시작합니다. 그런데 *터미널이 뭔지, 어떻게 여는지, python이 어디서 오는지, app.py가 어느 폴더에 있어야 하는지*를 모르면 첫 줄에서 멈춥니다. 이 가이드는 바로 그 틈을 메웁니다.

전제로 두는 사전지식은 없습니다. 컴퓨터를 켜고, 인터넷을 쓰고, 파일을 더블클릭해 본 정도면 충분합니다.

기준 환경은 Windows입니다. 필요한 곳마다 macOS·Linux는 어떻게 다른지 함께 적어둡니다. 명령어 예시는 복붙하면 실제로 돌아가도록 썼습니다.

전체 그림: 우리가 짓는 것

개발 환경은 아래 다섯 조각이 맞물려 돌아갑니다. 이 가이드는 이 그림을 왼쪽부터 하나씩 채워갑니다.

flowchart LR
    A["사람<br/>(나)"] --> B["터미널<br/>(명령을 입력하는 창)"]
    B --> C["운영체제 / 파일 시스템<br/>(폴더·경로)"]
    C --> D["프로그램·런타임<br/>(예: Python)"]
    D --> E["코드 파일<br/>(.py 등)"]
    E --> F["실행 결과<br/>(출력·오류)"]
    F -.피드백.-> A

    classDef person fill:#FFF3B0,stroke:#C9A227,color:#000
    classDef tool fill:#CDE7FF,stroke:#3B82C4,color:#000
    classDef system fill:#E6D6FF,stroke:#7C4DBC,color:#000
    classDef runtime fill:#C8F0E8,stroke:#2BA88E,color:#000
    classDef result fill:#D7F2C8,stroke:#5BA63B,color:#000

    class A person
    class B,E tool
    class C system
    class D runtime
    class F result

색은 가이드 전체에서 일관되게 씁니다 — 노랑=사람/입력, 청록=런타임·프로그램, 파랑=도구, 보라=시스템·파일, 초록=좋은 결과, 빨강=오류·실패.

부별 구성

각 챕터는 앞 챕터를 전제로 합니다. 순서대로 읽는 걸 권합니다.

이 가이드를 읽는 법

손으로 따라 하세요. 읽기만 하면 절대 손에 익지 않습니다. 챕터마다 "직접 해보기" 블록이 있습니다. 모든 명령은 실제로 입력해 보세요. 틀려도 괜찮습니다 — 6부에 "오류에서 빠져나오는 법"이 있습니다.

한 번에 다 외우려 하지 마세요. 경로·터미널·환경변수는 처음엔 누구에게나 헷갈립니다. 손이 기억할 때까지 반복하면 됩니다.

다 끝내면 할 수 있는 것

이 가이드를 마치면 다음 문장이 더 이상 막막하지 않습니다.

터미널을 열고, 프로젝트 폴더로 이동한 뒤,
가상환경을 켜고, 필요한 패키지를 설치하고, 코드를 실행한다.

이게 바로 거의 모든 개발 입문서·RAG 안내서의 첫 페이지입니다. 그럼 1부부터 시작하겠습니다.