2장 · 개발 환경 구성과 LLM API 호출실습 환경 한눈에 보기 — 딱 한 번만 하면 됩니다도구 설치 — Git, 미니콘다, VS Code프로젝트 폴더 세팅 — haru-market 폴더 만들기가상환경과 라이브러리 설치API 키 발급과 .env 파일따라하기 — 환경 점검따라하기 — 첫 LLM 호출정리와 체크리스트실습문제와 해답
2장. 개발 환경 구성과 LLM API 호출
실습 환경 한눈에 보기 — 딱 한 번만 하면 됩니다
한 줄 요약
이 장에서 도구 설치 → 프로젝트 폴더 세팅 → 가상환경 → 라이브러리 설치 → API 키 등록을 한 번 해 두면, 이후 24장까지는 터미널에서 conda activate myenv 한 줄만 치고 바로 실습을 시작합니다. 그리고 장의 끝에서 LLM을 처음으로 호출합니다.
이 장을 건너뛰지 마세요. 3장부터는 모든 「따라하기」가 "
haru-market폴더가 문서 폴더에 있고,myenv환경이 켜져 있다"를 전제로 시작합니다.
1. 왜 전원이 같은 환경을 쓰는가
수업에서 가장 시간을 많이 쓰는 부분은 코드가 아니라 환경 설정입니다. 파이썬 버전이나 폴더 위치, 터미널 종류가 다르면 같은 명령도 사람에 따라 실행되지 않을 수 있습니다. 그래서 이 과정은 세 가지를 통일합니다.
| 통일하는 것 | 정한 값 | 이유 |
|---|---|---|
| 프로젝트 폴더 | 문서(Documents) 폴더 안의 haru-market |
교재의 모든 명령이 이 위치를 기준으로 적혀 있습니다 |
| 파이썬 | 3.11 (myenv 가상환경) |
LangChain·LangGraph를 비롯해 수업에서 쓰는 라이브러리의 최신 버전이 모두 이 버전에서 동작함을 확인했습니다 |
| 터미널 | Git Bash (Windows) / 기본 터미널 (macOS) | cp, ls 같은 명령이 양쪽에서 똑같이 동작합니다 |
2. 준비물
| 준비물 | 어디에 쓰나 |
|---|---|
haru-market.zip |
수업에서 나눠 드리는 실습 폴더입니다. 데이터와 기본 파일이 들어 있습니다 |
| 구글 계정 | Gemini API 키를 발급받는 데 씁니다 |
| 인터넷 연결 | 도구 설치와 LLM 호출에 필요합니다 |
3. 이 장에서 설치하는 것
| 도구 | 무엇인가 | 왜 필요한가 |
|---|---|---|
| Git (Windows만) | 코드 변경 이력을 관리하는 도구 | 함께 설치되는 Git Bash 터미널을 쓰기 위해서입니다 |
| 미니콘다(Miniconda) | 파이썬과 가상환경 관리 도구 | 이 과정 전용 파이썬 환경을 만듭니다 |
| VS Code | 코드 편집기 | 파일 만들기, 코드 붙여 넣기, 실행을 모두 여기서 합니다 |
가상환경은 "이 과정 전용 파이썬 방"입니다. 다른 프로젝트의 라이브러리와 섞이지 않게 격리해 줍니다. 방 이름은 myenv로 정합니다.
4. 이 장의 순서
- 도구 설치 — Git(Windows), 미니콘다, VS Code
- 프로젝트 폴더 세팅 — zip을 문서 폴더에 풀기
- 가상환경 만들기와 라이브러리 설치
- API 키 발급과
.env파일 - 따라하기 — 환경 점검
- 따라하기 — 첫 LLM 호출
이미 설치된 도구는 버전만 확인하고 건너뛰어도 됩니다.
핵심 정리
- 프로젝트 폴더는 문서 폴더 안의
haru-market, 파이썬은 3.11(myenv), 터미널은 Git Bash(Windows)로 통일합니다. - 이 장의 설정은 한 번만 하면 됩니다.
- 이후 실습은 매번
conda activate myenv로 시작합니다.