1장 · 실습 환경과 첫 호출 — 절 목차01. 이 과정에서 만들 것 02. LLM이 답하지 못하는 세 가지 질문 03. 미니콘다 설치하기 04. 파이썬 3.10 가상환경 만들기 05. VS Code 설치와 프로젝트 폴더 열기 06. 인터프리터 고르기 가장 많이 막히는 지점 07. 폴더 구조와 실습 데이터 그리고 라이브러리 설치 08. API키를 env 파일에 넣기 09. 따라하기 설치 점검과 첫 LLM 호출 10. 정리 자주 나는 오류 5가지

VS Code 설치와 프로젝트 폴더 열기

한 줄 요약

이 과정의 모든 실습은 VS Code 한 곳에서 합니다. 코드 작성도, 실행(터미널)도 여기서 끝냅니다. 이 절에서 VS Code를 깔고, 내려받은 실습 폴더를 통째로 엽니다.

1. VS Code 설치

VS Code(Visual Studio Code) 는 마이크로소프트가 만든 무료 코드 편집기입니다. 메모장으로도 파이썬 코드를 쓸 수는 있지만, VS Code는 오타를 잡아 주고 실행 버튼도 제공합니다.

https://code.visualstudio.com 접속 → 큰 다운로드 버튼을 누르면 내 OS에 맞는 파일이 받아집니다 → 기본값으로 설치.

Python 확장 설치 — 빠뜨리지 마세요

VS Code를 켜고 왼쪽 세로 막대에서 네모 4개 아이콘(Extensions, 확장) 을 클릭합니다. 검색창에 Python 을 치고, Microsoft 가 만든 Python 확장을 설치합니다.

이 확장이 있어야 다음 절에서 할 인터프리터 선택이 가능합니다. 이 과정에서 가장 많이 막히는 지점이 그것이므로, 지금 확실히 설치해 두세요.

2. 실습 폴더를 어디에 둘 것인가

내려받은 agentic_ai 폴더를 다음 위치에 둡니다.

OS	권장 위치	실제 경로 예
Windows	`문서(Documents)` 안	`C:\Users\사용자명\Documents\agentic_ai`
macOS	`서류(Documents)` 안	`/Users/사용자명/Documents/agentic_ai`

압축 파일로 받았다면 압축을 푼 뒤 위 위치로 옮기세요.

바탕화면(Desktop)이나 다운로드(Downloads) 폴더는 피하세요. 특히 OneDrive나 iCloud가 동기화하는 폴더 안에 두면, 파일이 클라우드에만 있고 로컬에는 없는 상태가 되어 실습 중 이상한 오류가 납니다. 문서 폴더가 가장 안전합니다.

폴더 이름은 그대로 두세요. 교재의 모든 명령이 agentic_ai 를 기준으로 적혀 있습니다.

굳이 바꾸고 싶다면 바꿔도 동작은 합니다 — 코드가 자기 위치를 기준으로 경로를 계산하기 때문입니다. 다만 공백과 한글은 피하세요. 일부 도구가 공백이나 한글이 든 경로에서 말썽을 부립니다.

압축을 풀면 이렇게 생겼습니다

압축을 풀면 나오는 agentic_ai 폴더의 구조

code/ 안에 지금은 common.py 하나뿐입니다. ch01_hello.py 부터 ch08_multi_agent.py 까지 8개 파일은 여러분이 각 장에서 직접 만들어 넣습니다.

3. 폴더를 통째로 열기 — 중요

VS Code를 켜고 File(파일) → Open Folder…(폴더 열기) 를 선택합니다. macOS는 File → Open… 입니다.

그리고 agentic_ai 폴더 자체를 선택합니다.

code 폴더를 여는 게 아닙니다. agentic_ai 를 여는 것입니다.

코드는 자기 위치의 한 단계 위에서 data/ 와 .env 를 찾습니다. code 폴더만 열면 그 기준이 어긋나 "데이터 폴더가 없다"는 오류가 납니다.

제대로 열렸다면 VS Code 왼쪽 탐색기(Explorer)에 이렇게 보입니다.

폴더를 제대로 열었다면 탐색기에 이 네 개가 보인다

macOS에서 "이 폴더의 작성자를 신뢰합니까?" 같은 창이 뜨면 Yes, I trust the authors 를 누릅니다.

4. VS Code 안에서 터미널 열기

이제 별도의 터미널 앱을 켤 필요가 없습니다. VS Code 안에서 다 합니다.

상단 메뉴 Terminal(터미널) → New Terminal(새 터미널) 을 선택합니다.

Windows 단축키: Ctrl + ` (백틱, 숫자 1 왼쪽)
macOS 단축키: Control + `

VS Code 아래쪽에 터미널 창이 열립니다. 경로가 agentic_ai 로 잡혀 있는지 확인하세요.

C:\Users\사용자명\Documents\agentic_ai>

방에 들어갑니다

VS Code 안의 터미널에서 실행 — agentic_ai 폴더를 연 상태에서.

conda activate agentic

(agentic) 이 앞에 붙으면 준비 완료입니다.

(agentic) C:\Users\사용자명\Documents\agentic_ai>

(Windows) 터미널에서 conda 를 못 찾는다면 — VS Code의 기본 터미널이 PowerShell이라 그렇습니다. 터미널 창 오른쪽 위의 + 옆 아래 화살표(∨) → Command Prompt 를 선택해 새 터미널을 여세요. 그래도 안 되면 이 절은 건너뛰고 Anaconda Prompt 에서 cd 명령으로 폴더까지 이동해 실습해도 됩니다.

5. 앞으로의 작업 방식

각 장에서 이 순서로 진행합니다.

교재에서 코드를 복사한다
VS Code 왼쪽 탐색기에서 code 폴더를 오른쪽 클릭 → New File(새 파일)
파일 이름을 정확히 입력한다 (예: ch01_hello.py)
복사한 코드를 붙여 넣고 저장한다 (Ctrl+S / Cmd+S)
아래 터미널에서 실행한다

VS Code 안의 터미널에서 실행 — agentic_ai 폴더를 연 상태에서.

python code/ch01_hello.py

코드를 직접 타이핑할 필요는 없습니다. 복사해 붙여 넣고 돌려 본 뒤, 교재 설명을 보며 한 줄씩 이해하는 방식으로 갑니다.

핵심 정리

VS Code를 설치하고 Microsoft의 Python 확장을 반드시 함께 설치합니다.
agentic_ai 폴더는 문서(Documents) 안에 둡니다. 바탕화면·다운로드·클라우드 동기화 폴더는 피합니다.
VS Code에서는 agentic_ai 폴더를 통째로 엽니다. code 폴더만 열면 데이터 경로가 어긋납니다.
터미널도 VS Code 안에서 엽니다 (Ctrl/Control + `). 열 때마다 conda activate agentic.
다음 절에서 인터프리터 선택을 합니다. 이 과정에서 가장 많이 막히는 지점입니다.