클로드 코드 설치 — VS Code 확장·데스크톱 앱·터미널, 세 가지 길
처음 하는 분에게는 VS Code 확장을 권합니다. 이유와 순서, 윈도우에서 먼저 밟아 본 함정까지. 2026년 9월 공식 문서 기준.
세 가지 방법 모두 같은 Claude Code입니다. CLAUDE.md·Skill·설정이 공유되니 나중에 바꿔도 됩니다. 처음이면 VS Code 확장을 권합니다. 화면이 채팅창 모양이라 가장 덜 낯설고, 만든 파일이 왼쪽 목록에 바로 보입니다.
길 ① VS Code 확장 — 이 수업의 기본
| 단계 | 무엇을 | 어디서 |
|---|---|---|
| 1 | VS Code | code.visualstudio.com → Windows용 Download → 기본값으로 설치 |
| 2 | Git for Windows | git-scm.com/downloads/win → 전부 기본값 Next |
| 3 | Claude Code 확장 | VS Code에서 Ctrl+Shift+X → "Claude Code" 검색 → 만든 곳 Anthropic 확인 → Install |
| 4 | 로그인 | 왼쪽 Claude 아이콘 → Sign in → 브라우저에서 Pro 계정 로그인 |
Git은 GitHub에 저장할 때 필요합니다. 설치만 해 두면 열어 볼 일은 없습니다. 이름이 비슷한 다른 확장이 있으니 3번에서 만든 곳 확인이 핵심입니다. 아이콘이 안 보이면 Ctrl+Shift+P → Developer: Reload Window.
설정 두 개만: Ctrl+Shift+P → Configure Display Language → 한국어. 그리고 입력칸에서 줄바꿈은 Shift+Enter, 보내기는 Enter.
길 ② 데스크톱 앱
claude.com/download에서 Claude 데스크톱 앱을 설치하고 Code 탭을 엽니다. 앱 안에 Claude Code가 들어 있어 따로 설치할 게 없습니다. Local → 폴더 선택 → 지시 입력. 바뀐 파일을 화면으로 비교하고, 여러 작업을 나란히 띄우고, 예약 작업을 걸 수 있습니다. VS Code가 부담스러운 분에게 맞습니다. Windows·Mac 모두 있습니다.
길 ③ 터미널
명령줄이 익숙한 분용입니다.
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Mac / Linux
curl -fsSL https://claude.ai/install.sh | bash
설치 후 프로젝트 폴더로 이동해 claude를 치면 시작합니다. Windows에서는 Git for Windows를 같이 두는 게 좋습니다. 첫 실행 때 로그인 안내가 뜹니다.
공통 — 폴더는 반드시 영문으로
C 드라이브에 work 폴더 → 그 안에 my-homepage. 영문 소문자·숫자·하이픈만. 한글·공백·OneDrive 안은 피합니다. 바탕화면과 문서 폴더가 OneDrive 안일 수 있으니 확인하세요.
윈도우 함정 — 먼저 밟아 본 사람들의 기록
| 증상 | 원인 → 해결 |
|---|---|
| Git·bash를 찾을 수 없다 | Git 미설치 → 설치 후 VS Code 재시작 |
| 한글이 깨지거나 경로 오류 | 폴더 이름에 한글·공백 → 영문으로 |
| 파일이 사라지거나 동기화 충돌 | OneDrive 안 → C:\work로 |
| 'Not logged in' | Reload Window. Pro 결제한 계정인지 확인 |
| Code 탭이 업그레이드를 요구 | 무료 플랜. Claude Code는 Pro부터 |
| 회사 노트북에서 설치가 막힘 | 보안 정책. 설치 권한 문의, 안 되면 개인 노트북 |
설치에서 막히는 게 정상입니다
노트북마다 다르게 막힙니다. 실력 문제가 아니라 노트북 사정입니다. 방법은 하나, 에러를 통째로 복사해 채팅 Claude에게 "이 오류 났어, 뭐가 문제야?" 5분 넘게 혼자 씨름하지 않습니다.
첫 파일
설치가 끝났으면 폴더를 열고 이렇게 보내 보세요.
이 폴더에 hello.html 만들어줘. 큰 글씨로 '안녕하세요, ○○입니다' 한 줄.
승인 창을 읽고 승인 → 왼쪽에 파일이 생김 → 더블클릭해 브라우저에 뜨면 성공. 말 한 문장이 진짜 파일이 된 순간입니다.
같이 읽기
- 클로드 요금제 정리 — 무료로 어디까지 되고, Pro는 언제 필요한가무료·Pro·그 위 플랜을 "이 수업 기준"으로 나눴습니다. 결제 타이밍은 정해져 있습니다. 2026년 9월 기준.기초 · 클로드코드
- 클로드 코드란 — 채팅 클로드와 무엇이 다른가말만 하던 Claude에게 손이 생깁니다. 내 컴퓨터 폴더 안에서 파일을 직접 만들고 고치는 Claude. 채팅과 언제 무엇을 쓰는지.클로드코드
- CLAUDE.md란 — 매일 새로 출근하는 신입에게 주는 매뉴얼 한 장새 대화의 Claude는 지난 대화의 규칙을 모릅니다. 폴더에 규칙 파일 한 장을 두면 대화를 열 때마다 먼저 읽고 일합니다. 뭘 적고 뭘 빼는지.클로드코드