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

인터프리터 고르기 — 가장 많이 막히는 지점

한 줄 요약

VS Code에게 "이 프로젝트는 agentic 방의 파이썬을 쓴다" 고 알려 주는 절차입니다. 이걸 빠뜨리면 "분명히 설치했는데 ModuleNotFoundError" 라는, 이 과정에서 가장 흔한 오류가 납니다.

1. 왜 따로 알려 줘야 하나

컴퓨터 안에는 파이썬이 여러 개 있습니다.

파이썬이 여러 개 깔려 있다 — 경로에 envs/agentic 이 든 것을 골라야 한다

인터프리터(interpreter) 란 "파이썬 코드를 실제로 실행하는 프로그램"입니다. 위 목록 중 어느 것을 쓸지 VS Code가 알아서 고르는데, 기본값이 우리가 원하는 것이 아닐 수 있습니다.

라이브러리는 agentic 방 안에만 깔았는데 VS Code가 C:\Python312 를 쓰고 있으면, 코드를 실행하는 순간 이렇게 됩니다.

ModuleNotFoundError: No module named 'google'

"아까 분명히 설치했는데?" 맞습니다. 설치는 했습니다. 다른 방에 했을 뿐입니다.

2. 인터프리터 고르는 법

(1) 명령 팔레트 열기

Windows: Ctrl + Shift + P
macOS: Command + Shift + P

VS Code 위쪽에 입력창이 뜹니다.

(2) 명령 입력

Python: Select Interpreter

전체를 입력할 필요 없이 select int 정도만 쳐도 목록에 나옵니다. 엔터를 누르세요.

(3) `agentic` 고르기

파이썬 목록이 뜹니다. 그중 agentic 이라는 글자가 들어간 항목을 고릅니다.

Python 3.10.20 ('agentic')   ~/miniconda3/envs/agentic/bin/python     ★ 이것
Python 3.13.1                /usr/local/bin/python3
Python 3.12.4  ('base')      ~/miniconda3/bin/python

(4) 확인

VS Code 오른쪽 아래(또는 왼쪽 아래) 상태 표시줄에 이렇게 뜨면 성공입니다.

3.10.20 ('agentic')

목록에 agentic 이 안 보인다면 — 앞 절의 conda create 가 실패했거나, VS Code가 아직 새 환경을 발견하지 못한 것입니다. VS Code를 완전히 껐다가 다시 켜고 다시 시도하세요. 그래도 없으면 터미널에서 conda env list 로 환경이 진짜 만들어졌는지 확인합니다.

3. 터미널은 별개입니다 — 헷갈리는 지점

여기가 정말 헷갈리는 부분입니다. VS Code에는 파이썬을 고르는 자리가 두 군데 있습니다.

어디	무엇에 영향을 주나
인터프리터 선택 (방금 한 것)	코드 자동완성, 오류 표시, ▶ 실행 버튼
터미널의 `conda activate`	터미널에서 친 `python ...` 명령

파이썬을 고르는 자리는 두 군데이고, 서로 영향을 주지 않는다

이 둘은 서로 다릅니다. 인터프리터를 골랐어도, 터미널에서 conda activate agentic 을 안 했으면 터미널의 python 은 여전히 다른 방의 것입니다.

이 과정에서는 터미널로 실행합니다. 그러니 매번 (agentic) 표시를 확인하는 습관이 인터프리터 선택보다 실질적으로 더 중요합니다. 인터프리터 선택은 편집기가 빨간 줄을 잘못 긋지 않게 해 주는 용도라고 생각하세요.

터미널을 새로 열었는데 (agentic) 이 없다면:

터미널에서 실행 — 어느 위치에서든 됩니다.

conda activate agentic

VS Code가 터미널을 열 때 자동으로 activate 해 주는 경우도 있습니다. 그러면 그대로 두면 됩니다.

4. 지금 어느 파이썬을 쓰고 있는지 확인하는 법

의심스러울 때 쓰는 확인 명령입니다. 막혔을 때 여기로 돌아오세요.

터미널에서 실행 — 어느 위치에서든 됩니다.

python -c "import sys; print(sys.executable)"

경로에 envs/agentic 이 들어 있으면 맞습니다.

C:\Users\사용자명\miniconda3\envs\agentic\python.exe

/Users/사용자명/miniconda3/envs/agentic/bin/python

envs/agentic 이 안 보이면 엉뚱한 파이썬입니다. conda activate agentic 을 다시 하세요.

5. 증상별 처방

증상	진짜 원인	처방
`ModuleNotFoundError: No module named 'google'`	다른 방의 파이썬으로 실행 중	`conda activate agentic` 후 재실행
코드에 빨간 줄이 그어지는데 실행은 된다	인터프리터 미선택	`Python: Select Interpreter` → agentic
실행은 안 되는데 빨간 줄은 없다	터미널이 activate 안 됨	터미널에서 `(agentic)` 확인
터미널을 새로 열면 매번 `(base)`	정상 동작	매번 `conda activate agentic`

왜 이 문제에 한 절을 할애했는가 — 실습 환경을 준비할 때 시간을 가장 많이 잡아먹는 문제가 이것이기 때문입니다. 오류 메시지가 ModuleNotFoundError 라서 "설치가 안 됐구나" 라고 오해하고 pip install 을 반복하게 되는데, 진짜 원인은 실행한 방이 다른 것입니다. 이 구분만 몸에 익으면 앞으로 8장 내내 막히지 않습니다.

핵심 정리

컴퓨터에는 파이썬이 여러 개 있고, 어느 것으로 실행하느냐가 실습의 성패를 가릅니다.
VS Code 인터프리터 선택: Ctrl/Cmd + Shift + P → Python: Select Interpreter → agentic.
인터프리터 선택과 터미널의 conda activate 는 별개입니다. 이 과정은 터미널로 실행하므로 (agentic) 표시가 더 중요합니다.
의심되면 python -c "import sys; print(sys.executable)" — 경로에 envs/agentic 이 있어야 합니다.
ModuleNotFoundError 는 대부분 "설치 안 됨"이 아니라 "다른 방에서 실행함" 입니다.