2장. 개발 환경 구성과 LLM API 호출
도구 설치 — Git, 미니콘다, VS Code
한 줄 요약
Git(Windows만) → 미니콘다 → VS Code 순서로 설치합니다. 설치 중 나오는 선택지는 대부분 기본값 그대로 두면 됩니다.
1. Git 설치 (Windows)
Windows의 기본 터미널은 macOS·Linux와 명령이 다릅니다. Git을 설치하면 함께 들어오는 Git Bash를 쓰면 cp, ls, grep 같은 명령이 똑같이 동작합니다. 이 과정의 터미널은 Git Bash입니다.
- https://git-scm.com/downloads 에서 Windows용 설치 파일을 내려받습니다.
- 설치 파일을 실행합니다. 선택지는 전부 기본값으로 두고 Next를 눌러도 됩니다.
- 설치가 끝나면 시작 메뉴에서 Git Bash를 실행하고 다음을 입력합니다.
$ git --version
git version 2.50.1.windows.1
버전 번호가 나오면 성공입니다. 숫자는 달라도 됩니다.
macOS 사용자는 건너뜁니다. 기본 터미널을 그대로 씁니다.
2. 미니콘다 설치
미니콘다(Miniconda) 는 파이썬과 conda(가상환경 관리 도구)만 담은 가벼운 배포판입니다.
Windows
- https://www.anaconda.com/download 에 접속합니다. 이메일 입력을 요구하면 건너뛰기(Skip) 링크를 누릅니다. Miniconda Installers 영역에서 Windows 64-bit 설치 파일을 받습니다. (Anaconda가 아니라 Miniconda입니다.)
- 설치 파일을 실행합니다.
- Install for — "Just Me"를 고릅니다.
- 설치 경로 — 기본값(
C:\Users\사용자명\miniconda3)을 그대로 둡니다. Windows 사용자 이름이 한글이면C:\miniconda3처럼 영문 경로로 바꿉니다. - Advanced Options — "Add Miniconda3 to my PATH"는 체크하지 않은 기본값 그대로 둡니다. - 설치가 끝나면 시작 메뉴에 Anaconda Prompt (miniconda3) 가 생깁니다.
macOS
같은 페이지에서 사용 중인 Mac에 맞는(Apple Silicon 또는 Intel) .pkg 설치 파일을 받아 실행합니다.
3. Git Bash에서 conda를 쓸 수 있게 연결하기 (Windows)
설치 직후의 Git Bash는 conda를 모릅니다. 한 번만 연결해 줍니다.
- 시작 메뉴에서 Anaconda Prompt (miniconda3) 를 엽니다.
- 다음을 입력합니다.
$ conda init bash
- 열려 있는 Git Bash 창을 모두 닫고 새로 엽니다.
- 새 Git Bash 창에서 확인합니다.
$ conda --version
conda 25.5.1
프롬프트 맨 앞에 (base)가 붙어 있으면 연결된 것입니다.
그래도 conda: command not found가 나온다면 Git Bash에 아래 한 줄을 입력합니다(설치 경로가 기본값일 때).
$ source ~/miniconda3/etc/profile.d/conda.sh
macOS 사용자는 새 터미널에서
conda --version을 확인합니다. 안 되면conda init zsh를 한 번 실행하고 터미널을 새로 엽니다.
4. VS Code 설치
VS Code(Visual Studio Code) 는 무료 코드 편집기입니다. 이 과정에서는 파일 만들기, 코드 붙여 넣기, 실행을 모두 VS Code 한 곳에서 합니다.
- https://code.visualstudio.com 에서 설치 파일을 받아 설치합니다.
- VS Code를 실행하고, 왼쪽 확장(Extensions) 아이콘을 눌러
Python을 검색해 Microsoft의 Python 확장을 설치합니다. - (Windows) 터미널 기본값을 Git Bash로 바꿉니다.
-
Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다. -Terminal: Select Default Profile을 입력해 선택합니다. - 목록에서 Git Bash를 고릅니다.
이제 VS Code에서 Ctrl + `(백틱. 숫자 1 왼쪽 키)를 누르면 아래쪽에 Git Bash 터미널이 열립니다. 앞으로 "터미널"이라고 하면 이 창입니다.
5. 설치 확인
VS Code의 터미널을 새로 열고 두 명령이 모두 동작하는지 확인합니다.
$ git --version
$ conda --version
둘 다 버전이 나오면 도구 설치는 끝입니다.
핵심 정리
- Windows는 Git Bash를 터미널로 씁니다. Git을 설치하면 함께 들어옵니다.
- 미니콘다를 설치하고, Windows는 Anaconda Prompt에서
conda init bash를 한 번 실행합니다. - VS Code에 Python 확장을 설치하고, Windows는 기본 터미널을 Git Bash로 바꿉니다.
- VS Code 터미널에서
git --version,conda --version이 모두 나오면 통과입니다.