시작설치는 한 줄
PowerShell 열고, 명령 한 줄 붙여넣기
이 페이지 목표Windows에서 Claude Code를 설치하고, claude --version으로 확인한 뒤, 로그인까지 끝낸다.
Step 1
PowerShell 열기
시작 → "PowerShell" 검색
→
Step 2
설치 명령 실행
한 줄 붙여넣고 Enter
→
Step 3
버전 확인
claude --version
→
Step 4
로그인
claude 실행 → 브라우저
준비요구사항
필요한 것
| 항목 | 내용 |
|---|---|
| 운영체제 | Windows 10 이상 (64비트) |
| Node.js | 아래 권장(네이티브) 설치를 쓰면 별도로 깔 필요 없음. npm 방식만 Node 필요 |
| Git for Windows | 강력 권장 — Claude가 Bash 명령을 쓸 수 있게 해준다 (없으면 PowerShell로 대체) |
고르기두 가지 방법
어느 방법으로 설치할까?
대부분은 방법 A(PowerShell 한 줄)면 충분하다. Node.js를 이미 쓰고 있다면 방법 B(npm)를 써도 된다.
방법 A · 대부분
PowerShell 한 줄 (권장)
관리자 권한 불필요 · 자동 업데이트
irm https://claude.ai/install.ps1 | iex
irm https://claude.ai/install.ps1 | iex
또는
방법 B · Node.js 있음
npm 설치
이미 Node.js를 쓰는 중이라면
npm install -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code
방법 A권장 · 네이티브
PowerShell 한 줄 설치
가장 쉬운 방법. Node.js 없이 설치되고, 이후 자동 업데이트된다. 시작 메뉴에서 "PowerShell"을 검색해 연 뒤, 아래를 붙여넣고 Enter.
irm https://claude.ai/install.ps1 | iex
Downloading Claude Code...
Installed. Restart your terminal to use `claude`.
PowerShell 여는 법키보드 Win → PowerShell 입력 → Windows PowerShell 클릭. 프롬프트가 PS C:\Users\나> 모양이면 제대로 열린 것.
설치 후터미널을 완전히 닫았다가 다시 열어야 claude 명령이 인식된다.
방법 B대안 · npm
이미 Node.js가 있다면
Node.js를 이미 쓰고 있다면 npm으로도 설치할 수 있다.
npm install -g @anthropic-ai/claude-code
added 1 package
참고npm 방식은 업데이트를 직접 해야 한다: npm update -g @anthropic-ai/claude-code
확인제대로 깔렸나
버전·진단
claude --version
2.x.x (Claude Code)
claude doctor
Installation: OK
Git: found
설치 상태를 점검해 문제를 알려준다.
"claude 명령을 찾을 수 없음"터미널을 새로 열지 않았을 때 대부분 발생한다. PowerShell을 닫고 다시 연 뒤 재시도.
권장Git for Windows
Git도 함께 설치
필수는 아니지만 강력 권장. 설치해 두면 Claude가 Bash(유닉스) 명령까지 쓸 수 있어 더 매끄럽게 동작한다. 아래에서 받아 기본값으로 설치하면 된다.
https://git-scm.com/downloads/win
설치 후 PowerShell을 새로 열고 git --version이 나오면 성공.
로그인첫 실행
계정 연결
프로젝트 폴더로 이동해 claude를 실행하면, 첫 실행 시 브라우저가 열리며 로그인 화면이 뜬다.
cd C:\Users\나\Documents\my-project
claude
Sign in to continue. Opening browser...
Logged in as you@example.com
| 계정 종류 | 설명 |
|---|---|
| Claude Pro / Max (구독) | 초보자 권장. 월 구독으로 사용량 포함 |
| Claude Console (API) | 쓴 만큼 크레딧 차감 (console.anthropic.com) |
계정 바꾸기세션 안에서 /login을 입력하면 다시 브라우저가 열려 다른 계정으로 로그인할 수 있다.
Windows알아두기
PowerShell vs 명령 프롬프트(CMD)
Windows에는 검은 창이 두 종류다. 이 문서의 명령은 모두 PowerShell 기준 — 지금 내 창이 뭔지 3초 만에 판별하자.
프롬프트가 PS 로 시작
PowerShell (권장)
PS C:\Users\나>
→ 이 문서의 명령을 그대로 사용
→ 이 문서의 명령을 그대로 사용
vs
PS 가 안 보이면
명령 프롬프트(CMD)
C:\Users\나>
→ 시작 메뉴에서 PowerShell을 새로 열자
→ 시작 메뉴에서 PowerShell을 새로 열자
| 구분 | PowerShell (권장) | CMD |
|---|---|---|
| 프롬프트 모양 | PS C:\Users\나> | C:\Users\나> |
| 설치 명령 | irm ... | iex | PowerShell 사용 권장 |
프롬프트 맨 앞에 PS가 붙어 있으면 PowerShell이다. 이 문서의 명령은 모두 PowerShell 기준.
실습따라하기
지금 해보기
설치하고 버전 확인하기
약 5분- 시작 메뉴에서 PowerShell을 검색해 연다. 프롬프트가 PS C:\...> 인지 확인.
- irm https://claude.ai/install.ps1 | iex 붙여넣고 Enter.
- PowerShell을 닫았다 다시 연다.
- claude --version 입력 → 버전 번호가 보이면 성공.
- (권장) claude doctor로 설치 상태 점검.
예상 결과
✓ claude --version → 2.x.x (Claude Code) 형태의 줄이 출력된다.
✓ claude doctor → 설치·Git 상태가 OK/found로 표시된다.
막히면: "claude 명령을 찾을 수 없음"은 대부분 터미널을 새로 안 연 경우다.
다음공식 문서 → 03 첫 세션 따라하기에서 Claude와 첫 대화·첫 수정을 해본다. ▸ 첫 세션 시작
클로드코드 시작하기공식 문서 · 02 설치 & 로그인