설치, 한 시간이면 끝난다

1.1 이 장을 시작하기 전에

솔직히 말씀드리면, 이 장이 이 책에서 제일 재미없습니다. 그리고 가장 많은 분이 여기서 포기합니다. 만드는 것도 아니고 배우는 것도 아닌, 그냥 설치니까요.

그래서 두 가지만 약속드립니다.

하나. 한 시간이면 끝납니다. 순조로우면 30분, 뭔가 걸려도 한 시간입니다. 둘. 이 장을 통과하면 다시는 안 합니다. 한 번 깔면 4주 내내 그대로 씁니다.

그리고 이 장은 다른 설치 안내와 한 가지가 다릅니다. 깔라고만 하지 않고, 그게 왜 필요한지 먼저 말합니다. 이유를 모르고 깔면 나중에 뭔가 고장 났을 때 어디를 봐야 할지 알 수 없기 때문입니다.

---

1.2 왜 네 개나 깔아야 하나

설치할 것은 네 개입니다. 순서대로 하나씩 볼 텐데, 먼저 전체 그림부터 봅시다. 지금 이 그림이 안 외워져도 괜찮습니다. 나중에 뭐가 안 될 때 돌아올 자리입니다.

설치할 네 개 — VS Code 작업실 안에서 Claude Code가 코드를 쓰고, Python이 실행하고, Git이 되돌린다

한 문장씩 붙이면 이렇습니다.

여기서 가장 흔한 오해 하나를 미리 풀고 갑니다.

“Claude 하나만 깔면 되는 거 아닌가요?”

아닙니다. Claude는 코드를 쓰는 것까지 합니다. 그 코드를 실행하는 것은 Python이 하고, 잘못됐을 때 되돌리는 것은 Git이 합니다. 셋이 각각 다른 일을 합니다. 그래서 넷을 다 깝니다.

순서를 지켜 주세요. 위 표의 1 → 2 → 3 → 4 순서입니다. VS Code가 없으면 확장을 설치할 자리가 없고, Python이 없으면 Claude가 코드를 만들어도 돌려볼 수가 없습니다.

---

1.3 첫 번째 — VS Code (작업실)

VS Code(브이에스 코드)는 Microsoft가 만든 무료 프로그램입니다. 정식 이름은 Visual Studio Code입니다.

메모장이라고 생각하시면 절반은 맞습니다. 글자를 쓰고 저장하는 프로그램이니까요. 다만 여기에 다른 프로그램을 붙일 수 있다는 점이 다릅니다. 우리가 Claude를 붙일 자리가 바로 여기입니다.

설치

Windows

1. https://code.visualstudio.com/ 접속
2. Download for Windows 클릭 → 받은 .exe 파일 실행
3. 설치 옵션은 전부 기본값으로 두고 계속 Next
   • “PATH에 추가” 체크는 켜진 채로 두세요 (기본값이 켜짐입니다)

Mac

1. https://code.visualstudio.com/ 접속 → Download for Mac 클릭
2. 받은 .zip 압축 해제 → 나온 Visual Studio Code 앱을 응용 프로그램(Applications) 폴더로 드래그
3. 처음 실행할 때 “확인되지 않은 개발자” 경고가 뜨면 — 시스템 설정 → 개인정보 보호 및 보안 에서 “확인 후 열기” 클릭

설치가 끝나고 VS Code를 실행하면 시커먼 화면이 뜹니다. 아직 아무것도 안 해도 됩니다. 창은 열어둔 채로 다음으로 갑니다.

---

1.4 두 번째 — Python (코드를 실행하는 직원)

왜 필요한가

Claude에게 “엑셀 정리해줘” 라고 하면, Claude는 엑셀을 정리하는 코드를 씁니다. 그런데 코드는 글자일 뿐입니다. 누군가 그 글자를 읽고 실제로 실행해야 합니다.

그 일을 하는 것이 Python(파이썬)입니다.

📖 인터프리터(interpreter, 통역기)

사람이 쓴 코드를 한 줄씩 읽어서 컴퓨터가 알아듣게 통역해 실행하는 프로그램. Python을 설치한다는 건, 정확히는 Python 코드를 실행해 줄 통역기를 깐다는 뜻입니다. 통역기가 없으면 코드는 그냥 메모장에 적힌 글자입니다.

Python 문법을 배울 필요는 없습니다. 코드는 Claude가 씁니다. 우리는 그 코드를 돌려줄 통역기만 깔아두면 됩니다.

설치

설치할 버전은 3.11.9 입니다. 최신 버전이 아닙니다.

⚠️ 최신 버전을 받지 마세요

Python은 버전이 빠르게 올라가는데, 너무 최신이면 아직 안 맞는 도구가 있습니다. 3.11.9는 강의에서 4주 내내 문제없이 돌아간 버전입니다. 굳이 최신을 받았다가 오류를 만나느니, 검증된 버전으로 가는 게 훨씬 빠릅니다.

Windows

1. https://www.python.org/downloads/release/python-3119/ 접속
2. 페이지 맨 아래로 스크롤 → Windows installer (64-bit) 클릭해 내려받기
3. 받은 .exe 실행 — 여기서 화면을 잘 보셔야 합니다

⚠️ 이 책에서 제일 중요한 체크박스

설치 첫 화면 아래쪽에 Add python.exe to PATH 라는 작은 체크박스가 있습니다. 반드시 켜세요.

기본값이 꺼짐이라 그냥 Install Now를 누르면 십중팔구 놓칩니다. 강의에서 설치 문제의 절반 이상이 이 체크박스 하나였습니다.

켰으면 Install Now 클릭.

체크박스를 켠다는 게 무슨 뜻이냐면 — 컴퓨터에게 “Python을 여기 깔았으니, 누가 찾으면 알려줘” 라고 등록하는 것입니다. 안 켜면 Python은 깔려 있는데 Claude가 못 찾습니다. “분명 깔았는데 없다고 나와요”의 정체가 이겁니다.

[그림 1-3: Python 설치 첫 화면. 하단 “Add python.exe to PATH” 체크박스에 빨간 원과 번호 ①, “Install Now” 버튼에 ② 표시]

Mac

1. 같은 주소 접속 → 페이지 맨 아래 macOS 64-bit universal2 installer 내려받기
2. 받은 .pkg 실행 → 전부 기본값으로 계속 진행
3. Mac은 PATH 체크박스가 없습니다. 설치 프로그램이 알아서 해줍니다

잘 깔렸는지 확인

확인은 터미널이라는 검은 창에서 합니다.

📖 터미널(terminal)

마우스로 클릭하는 대신 글자를 쳐서 컴퓨터에게 명령하는 창입니다. 지금은 딱 한 줄만 칠 겁니다. 무서워하지 않으셔도 됩니다. 이 책에서 터미널을 본격적으로 쓰는 건 3부에 가서입니다.

Windows — 시작 메뉴에서 cmd 검색 → 명령 프롬프트 실행 → 아래를 치고 Enter

python --version

Mac — Spotlight(Cmd + Space)에서 터미널 검색 → 실행 → 아래를 치고 Enter

python3 --version

Python 3.11.9 라고 나오면 됐습니다. 다른 게 나오거나 “찾을 수 없습니다”가 뜨면 1.9절로 가세요.

---

1.5 세 번째 — Git (되돌리기 장치)

왜 필요한가

Claude와 일하다 보면 반드시 이런 순간이 옵니다.

“아까가 더 나았는데. 아까로 돌려줘.”

이때를 위한 것이 Git(깃)입니다.

📖 버전 관리(version control)

파일이 바뀔 때마다 바뀌기 전 상태를 통째로 저장해 두는 것. 그래서 언제든 예전 상태로 되돌아갈 수 있습니다.

보고서_최종.docx, 보고서_최종_진짜최종.docx, 보고서_최종_찐막.docx — 이걸 손으로 하던 걸, 프로그램이 자동으로 해준다고 보시면 됩니다. 그 일을 하는 대표적인 프로그램이 Git 입니다.

Git을 지금 배우지는 않습니다. 4부에서 다룹니다. 지금 까는 이유는 두 가지입니다. 하나는 나중에 쓰기 위해서, 다른 하나는 Claude Code가 내부적으로 Git을 사용하기 때문입니다. 없으면 Claude Code 자체가 제대로 안 돕니다.

설치

Windows

1. https://git-scm.com/downloads 접속 → Windows 선택해 내려받기
2. 받은 .exe 실행
3. 설치 화면이 아주 많이 나옵니다. 전부 기본값으로 Next만 누르세요.
   • 옵션 하나하나를 이해할 필요 없습니다. 기본값이 정답입니다
   • 단, “Git Bash Here” 항목은 체크된 채로 두세요 (기본값이 켜짐입니다)
4. 확인: 바탕화면에서 마우스 오른쪽 클릭 → 메뉴에 Git Bash Here 가 보이면 완료
   • Windows 11에서는 오른쪽 클릭 후 “더 많은 옵션 표시” 를 눌러야 보일 수 있습니다

Mac

Mac에는 Git이 대부분 이미 들어 있습니다. 확인부터 하세요.

1. 터미널 실행 → git --version 입력
2. git version 2.x.x 처럼 나오면 이미 있는 겁니다. 넘어가세요
3. 안 깔려 있으면 설치하라는 팝업이 자동으로 뜹니다 → 그대로 진행

---

1.6 네 번째 — Claude Code 확장 (AI 본체)

드디어 주인공입니다.

📖 확장(extension, 익스텐션)

VS Code에 기능을 하나 더 붙이는 부품. 스마트폰에 앱을 하나 더 까는 것과 같습니다. VS Code 자체는 글자를 쓰고 저장하는 일만 하는데, 확장을 붙이면 거기에 새로운 능력이 하나씩 더해집니다.

우리가 붙일 확장의 이름이 Claude Code 입니다.

설치

Windows와 Mac이 같습니다.

1. VS Code 실행
2. 왼쪽 세로 막대에서 네모 블록 모양 아이콘(확장) 클릭
   • 단축키: Windows Ctrl + Shift + X / Mac Cmd + Shift + X
3. 위쪽 검색창에 Claude Code 입력
4. 만든 곳이 Anthropic 인 것을 확인하고 Install 클릭
   • ⚠️ 비슷한 이름의 다른 확장이 함께 나옵니다. 만든 곳이 Anthropic 인지 반드시 확인하세요
5. 설치가 끝나면 왼쪽 세로 막대에 Claude 아이콘이 새로 생깁니다

[그림 1-4: VS Code 확장 화면. ① 왼쪽 확장 아이콘 ② 검색창의 “Claude Code” ③ 제작사 Anthropic 표시 ④ Install 버튼]

---

1.7 로그인, 그리고 결제

로그인

1. 왼쪽 세로 막대의 Claude 아이콘 클릭 → 오른쪽에 패널이 열립니다
2. Sign in 버튼 클릭
3. 브라우저가 자동으로 열립니다 → claude.ai 계정으로 로그인
   • 계정이 없으면 여기서 가입하시면 됩니다
4. 인증이 끝나면 자동으로 VS Code로 돌아옵니다

⚠️ Sign in을 눌러도 브라우저가 안 열릴 때

10초쯤 기다려 보세요. 느릴 수 있습니다. 그래도 안 열리면 기본 브라우저 설정을 확인하세요 (Chrome·Edge·Safari 권장).

결제

0장에서 미리 말씀드린 부분입니다. 유료 플랜이 필요합니다.

1. https://claude.ai 로그인
2. 왼쪽 아래 프로필 클릭 → Settings → Plans & Billing
3. Pro 이상 선택 → 결제
4. VS Code의 Claude Code 확장에 같은 계정으로 로그인하면 자동으로 인식됩니다

무료로도 로그인은 됩니다. 다만 이 책의 실습을 하다 보면 중간에 사용량 한도에 막힙니다. 한창 뭔가 만들다가 멈추는 게 제일 답답합니다. 미리 결제하고 시작하시길 권합니다.

---

1.8 마지막 — 폴더 열고 말 걸어보기

설치는 끝났습니다. 이제 실제로 되는지 확인합니다.

실습 폴더 만들기

Claude Code는 폴더 하나를 열어놓고 그 안에서 일합니다. 그러니 일할 폴더가 있어야 합니다.

지금은 빈 폴더 하나를 직접 만들어도 충분합니다.

• Windows: C:\claude-lecture\
• Mac: ~/claude-lecture/

⚠️ 폴더 위치를 아무 데나 잡지 마세요

나중에 반드시 문제가 되는 세 가지입니다.

피할 것	왜
한글이 들어간 경로	C:\내문서\작업 같은 경로에서 도구가 오작동합니다
공백이 들어간 경로	이름 중간의 빈칸을 경계로 착각하는 도구가 있습니다
OneDrive·iCloud·구글드라이브 폴더	동기화가 파일을 계속 만지면서 충돌합니다

그래서 C:\claude-lecture\ 처럼 짧고, 영어고, 드라이브 바로 아래를 권합니다. 멋없어 보여도 이게 제일 안전합니다.

폴더 열기

VS Code에서 File → Open Folder 를 눌러 방금 만든 폴더를 선택합니다.

• Windows 단축키: Ctrl + K 를 누르고 이어서 Ctrl + O
• Mac 단축키: Cmd + K 를 누르고 이어서 Cmd + O
• Mac은 메뉴가 File → Open 입니다

“이 폴더의 작성자를 신뢰합니까?” 같은 물음이 뜨면 신뢰함(Yes, I trust) 을 선택하세요. 내가 만든 폴더입니다.

[그림 1-6: 폴더를 연 직후의 VS Code 전체 화면. ① 왼쪽 파일 탐색기 ② 오른쪽 Claude 패널 ③ 아래 터미널 영역 — 세 구역에 이름표]

첫 마디

Claude 패널 아래쪽 입력창에 딱 이렇게 치고 Enter를 누르세요.

이 폴더 뭐 있어?

Claude가 폴더 안을 들여다보고 대답하면 — 설치 끝입니다.

빈 폴더를 만드셨다면 “비어 있다”고 답할 겁니다. 그것도 정답입니다. 중요한 건 답의 내용이 아니라, Claude가 내 컴퓨터의 폴더를 실제로 들여다봤다는 사실입니다.

웹 Claude는 이걸 못 합니다. 방금 그 한 줄이 이 책 전체의 출발점입니다.

---

1.9 안 될 때 — 자주 나는 여섯 가지

강의에서 실제로 나왔던 것들입니다. 증상으로 찾으세요.

① 확장 검색에 Claude Code가 안 나온다

VS Code 버전이 낮습니다. Help → Check for Updates 로 업데이트한 뒤 다시 검색하세요. 회사 PC라면 방화벽이 막고 있을 수도 있습니다.

② (Windows) “python을 찾을 수 없습니다”

1.4절의 그 체크박스를 놓친 것입니다. 거의 100% 이 경우입니다.

고치는 법: Python을 지우고 다시 깝니다. 이번엔 Add python.exe to PATH 를 켜고요. 환경 변수를 손으로 고치는 방법도 있지만, 재설치가 훨씬 빠르고 안전합니다.

③ (Windows) Git Bash Here가 안 보인다

• Git이 설치가 안 됐을 수 있습니다 → 1.5절 다시
• Windows 11이면 오른쪽 클릭 후 “더 많은 옵션 표시” 를 눌러야 나옵니다
• 바탕화면 말고 다른 폴더 안에서 오른쪽 클릭해 보세요

④ Sign in을 눌러도 브라우저가 안 열린다

10초 기다려 보고, 그래도 안 되면 기본 브라우저를 Chrome이나 Edge로 바꿔 보세요.

⑤ 메시지를 보냈는데 답이 없다

순서대로 확인하세요.

1. 로그인 상태 — Claude 패널 아래쪽에 계정이 표시되나요?
2. 인터넷 연결
3. VS Code를 껐다 켜기 — 놀랍게도 이걸로 자주 해결됩니다

⑥ 회사 PC라 설치가 아예 막힌다

회사 보안 정책으로 설치가 안 되는 경우가 실제로 있습니다.

• IT팀에 VS Code·Python·Git 설치가 가능한지 먼저 확인하세요
• 안 되면 개인 PC를 쓰시는 편이 빠릅니다
• claude.ai 웹 버전으로 대체할 수는 없습니다. 웹 Claude는 내 컴퓨터의 파일을 열지 못합니다. 그게 이 책이 하려는 일의 전부인데요

---

1.10 정리

이 장에서 나온 낱말 셋 — 인터프리터, 버전 관리, 확장. 지금 다 안 외워도 됩니다. 부록 E에 다시 모아뒀습니다.

다음 장에서는 방금 연 그 폴더에서 본격적으로 첫 대화를 합니다. 그리고 곧 화면에 창이 하나 뜰 텐데 — 0장에서 말씀드린 바로 그 창입니다. 이번엔 그게 뭔지 알고 누르게 됩니다.

---