클로드 코드(Claude Code) 윈도우 설치 완벽 가이드 (2026)

“클로드 코드(Claude Code)를 써보고 싶은데, 설치부터 막힌다.”

이 글을 읽고 있다면 아마 이런 상황일 겁니다. 터미널? PowerShell? npm? 처음 듣는 용어들이 쏟아지고, 공식 문서는 영어에 개발자 위주라 어디서부터 시작해야 할지 막막하죠.

걱정 마세요. 이 글에서는 윈도우 컴퓨터에 클로드 코드를 처음부터 끝까지 설치하는 방법을 단계별로 안내합니다. 웹사이트에서 직접 다운로드받고, PowerShell에 명령어를 입력하는 방식으로 진행합니다. 컴퓨터 초보자도 따라할 수 있도록 모든 과정을 하나하나 설명하겠습니다.

설치 순서 미리 보기

시작하기 전에, 전체 과정을 먼저 훑어보겠습니다. 총 7단계입니다:

순서	설치 항목	소요 시간	필수 여부
1단계	PowerShell 열기	1분	✅ 필수
2단계	Git for Windows	5~10분	✅ 필수
3단계	Python	5~10분	⭐ 권장
4단계	Node.js	5~10분	⭐ 권장
5단계	Claude Code	3~5분	✅ 필수
6단계	Claude Code 로그인	2~3분	✅ 필수
7단계	bkit 플러그인	2~3분	⭐ 권장

💡 Python과 Node.js가 “권장”인 이유: 클로드 코드 자체는 네이티브 인스톨러로 설치하면 Python이나 Node.js 없이도 동작합니다. 하지만 실제 개발 작업을 하려면 대부분 필요하고, bkit 플러그인도 Node.js가 있어야 일부 기능이 원활합니다. 처음 환경을 세팅하는 거라면 다 설치하는 걸 추천합니다.

전체 소요 시간은 인터넷 속도에 따라 약 30~45분입니다.

1단계: PowerShell 열기

PowerShell은 윈도우에 기본으로 설치되어 있는 명령어 입력 도구입니다. 마우스로 클릭하는 대신 글자를 타이핑해서 컴퓨터에 명령을 내리는 창이라고 생각하면 됩니다.

여는 방법

키보드에서 Windows 키를 누릅니다 (키보드 왼쪽 아래 깃발 모양)
“PowerShell”이라고 타이핑합니다
검색 결과에서 “Windows PowerShell”을 클릭합니다

파란색 배경의 검은 글자 창이 뜨면 성공입니다.

⚠️ “관리자 권한으로 실행”은 하지 마세요. 일반 모드로 여는 것이 안전합니다. 관리자 권한이 필요한 경우에는 별도로 안내합니다.

확인: PowerShell 버전 체크

PowerShell 창에 아래 명령어를 복사해서 붙여넣고 Enter를 누릅니다:

$PSVersionTable.PSVersion

숫자가 나오면 됩니다 (예: 5.1.xxxx). 버전은 크게 중요하지 않으니 넘어갑시다.

💡 팁: 명령어 복사-붙여넣기 방법

이 글에서 명령어를 드래그해서 Ctrl+C로 복사

PowerShell 창에서 마우스 오른쪽 클릭 (Ctrl+V도 가능)

Enter 키를 눌러 실행

2단계: Git for Windows 설치

Git은 코드의 변경 이력을 관리하는 도구입니다. 클로드 코드는 내부적으로 Git Bash라는 프로그램을 사용하기 때문에 반드시 먼저 설치해야 합니다.

다운로드

웹 브라우저를 열고 아래 주소로 이동합니다:

https://git-scm.com/download/win

페이지에 들어가면 자동으로 다운로드가 시작됩니다
다운로드된 파일 이름은 Git-2.53.0-64-bit.exe 같은 형식입니다 (버전 숫자는 다를 수 있음)

설치

다운로드된 .exe 파일을 더블 클릭합니다
“이 앱이 디바이스를 변경할 수 있도록 허용하시겠어요?” → 예 클릭
설치 마법사가 시작됩니다

설치 중 여러 선택 화면이 나오는데, 모두 기본값(Next)으로 진행하면 됩니다. 총 10개 정도의 화면을 Next → Next → … → Install 순서로 클릭합니다.

⚠️ 딱 한 가지 확인할 것: “Adjusting your PATH environment” 화면에서 “Git from the command line and also from 3rd-party software” (기본값)가 선택되어 있는지 확인하세요. 이게 선택되어 있어야 PowerShell에서 git 명령어를 사용할 수 있습니다.

설치 확인

설치가 끝나면 PowerShell을 한 번 닫았다가 다시 엽니다 (중요!). 그리고 아래 명령어를 입력합니다:

git --version

아래처럼 나오면 성공입니다:

git version 2.53.0.windows.2

3단계: Python 설치

Python은 세계에서 가장 많이 쓰이는 프로그래밍 언어 중 하나입니다. 클로드 코드 자체에는 필요 없지만, 데이터 분석, 자동화, AI 관련 프로젝트를 할 때 거의 반드시 필요합니다.

다운로드

웹 브라우저에서 아래 주소로 이동합니다:

https://www.python.org/downloads/

노란색 “Download Python 3.14.x” 버튼을 클릭합니다 (x는 최신 마이너 버전)
.exe 파일이 다운로드됩니다

설치

다운로드된 .exe 파일을 더블 클릭합니다
🚨 가장 중요한 부분: 설치 화면 맨 아래에 있는 “Add python.exe to PATH” 체크박스를 반드시 체크하세요!

┌─────────────────────────────────────────┐
│  Install Python 3.14.x                  │
│                                         │
│  ☐ Use admin privileges when installing │
│  ☑ Add python.exe to PATH   ← 반드시!  │
│                                         │
│  [Install Now]  [Customize installation]│
└─────────────────────────────────────────┘

“Install Now”를 클릭합니다
“이 앱이 디바이스를 변경할 수 있도록 허용하시겠어요?” → 예
설치가 완료되면 “Close” 클릭

⚠️ “Add python.exe to PATH”를 깜빡했다면? Python을 제거(언인스톨)하고 다시 설치하는 게 가장 확실합니다. PATH에 추가되지 않으면 PowerShell에서 python 명령어를 인식하지 못합니다.

설치 확인

PowerShell을 닫았다가 다시 열고 아래 명령어를 입력합니다:

python --version

결과:

Python 3.14.3

pip(파이썬 패키지 관리자)도 함께 확인합니다:

pip --version

결과 (예시):

pip 25.x.x from C:\Users\사용자이름\AppData\...

두 명령어 모두 버전이 나오면 성공입니다.

4단계: Node.js 설치

Node.js는 JavaScript를 컴퓨터에서 실행할 수 있게 해주는 환경입니다. npm(Node Package Manager)이라는 패키지 관리자도 함께 설치됩니다. bkit 플러그인의 일부 기능과 웹 개발 프로젝트에 필요합니다.

다운로드

웹 브라우저에서 아래 주소로 이동합니다:

https://nodejs.org/en/download

사이트가 자동으로 여러분의 운영체제를 감지합니다
“Windows Installer (.msi)”를 선택하고 “LTS” (Long-Term Support, 장기 지원 버전)를 클릭합니다
.msi 파일이 다운로드됩니다

💡 LTS vs Current: LTS는 안정적인 버전, Current는 최신 기능이 포함된 버전입니다. 초보자는 무조건 LTS를 선택하세요.

설치

다운로드된 .msi 파일을 더블 클릭합니다
“Welcome to the Node.js Setup Wizard” → Next
라이선스 동의 → 체크 후 Next
설치 경로 → 기본값 그대로 Next
커스텀 설정 → 기본값 그대로 Next
“Tools for Native Modules” 화면이 나올 수 있는데, 체크하지 않아도 됩니다 → Next
Install 클릭
“이 앱이 디바이스를 변경할 수 있도록 허용하시겠어요?” → 예
설치 완료 후 Finish

설치 확인

PowerShell을 닫았다가 다시 열고 (매번 닫았다 여는 이유는 환경 변수가 새 창에서만 적용되기 때문입니다):

node --version

결과:

v24.14.1

npm도 확인합니다:

npm --version

결과 (예시):

11.x.x

5단계: 클로드 코드(Claude Code) 설치

드디어 본론입니다! 클로드 코드를 윈도우에 설치하는 방법은 크게 두 가지가 있습니다:

방법	장점	단점
네이티브 인스톨러 (추천)	Node.js 불필요, 자동 업데이트	간혹 PATH 문제
npm 설치	안정적, 검증된 방법	Node.js 필요

이 글에서는 두 가지 방법을 모두 알려드립니다. 네이티브 인스톨러를 먼저 시도하고, 문제가 생기면 npm 방법을 사용하세요.

방법 A: 네이티브 인스톨러 (추천)

PowerShell을 열고 아래 명령어를 복사-붙여넣기한 후 Enter:

irm https://claude.ai/install.ps1 | iex

이게 전부입니다. 이 한 줄이 Claude Code를 다운로드하고 설치합니다.

💡 명령어 해석:

irm = Invoke-RestMethod (인터넷에서 스크립트를 가져옴)

https://claude.ai/install.ps1 = Anthropic의 공식 설치 스크립트

| = 파이프 (가져온 결과를 다음 명령어로 전달)

iex = Invoke-Expression (스크립트를 실행)

설치가 완료되면 “Installation complete!” 메시지가 나타납니다.

방법 B: npm으로 설치

네이티브 인스톨러가 잘 안 되면, 4단계에서 설치한 npm을 활용합니다:

npm install -g @anthropic-ai/claude-code

⚠️ 주의: sudo를 사용하지 마세요. 윈도우에서는 sudo가 기본적으로 없고, 권한 문제가 생길 수 있습니다.

설치 확인

중요: PowerShell을 반드시 닫았다가 새로 열어주세요! PATH 변경이 새 창에서만 적용됩니다.

claude --version

결과 (예시):

claude v2.1.x

버전 번호가 나오면 클로드 코드 설치에 성공한 것입니다!

🔧 트러블슈팅: “claude를 인식할 수 없습니다” 오류

만약 claude를 입력했는데 “‘claude’ 용어가 cmdlet, 함수, 스크립트 파일…” 같은 오류가 나온다면:

1. PowerShell을 새로 열었는지 확인

설치 후 반드시 PowerShell을 완전히 닫고 다시 여세요.

2. PATH에 수동으로 추가

아래 명령어로 Claude가 어디에 설치되었는지 확인합니다:

ls ~/.local/bin/claude*

파일이 보이면, PATH에 추가합니다:

$env:PATH += ";$HOME\.local\bin"

이 설정을 영구적으로 적용하려면:

[Environment]::SetEnvironmentVariable("PATH", "$([Environment]::GetEnvironmentVariable('PATH', 'User'));$HOME\.local\bin", "User")

그 후 PowerShell을 새로 열고 다시 claude --version을 시도하세요.

3. 그래도 안 되면 npm 방법으로 재설치

npm install -g @anthropic-ai/claude-code

6단계: Claude Code 로그인

클로드 코드를 사용하려면 Anthropic 계정이 필요합니다. Claude Pro, Max, Team, Enterprise 구독이 있으면 추가 비용 없이 사용할 수 있습니다.

로그인 방법

PowerShell에서 아래 명령어를 입력합니다:

claude

처음 실행하면 로그인 화면이 나타납니다. 두 가지 인증 방법이 있습니다:

방법 1: 구독 계정으로 로그인 (추천)

Claude Pro/Max/Team/Enterprise 구독이 있다면 이 방법을 사용하세요.

claude를 실행하면 “How would you like to authenticate?” 질문이 나옵니다
“Log in with Claude.ai account”을 선택합니다
웹 브라우저가 자동으로 열리면서 로그인 페이지가 나타납니다
Claude.ai 계정으로 로그인합니다
“Authorize Claude Code” 화면에서 허가를 클릭합니다
브라우저에 “You may now close this window” 메시지가 나타나면 성공
PowerShell로 돌아오면 로그인이 완료되어 있습니다

💡 이 방법으로 로그인하면 구독 사용량에 포함됩니다. 별도 API 요금이 청구되지 않습니다.

방법 2: API 키 사용

구독 대신 종량제(사용한 만큼 결제)를 원한다면:

브라우저에서 https://console.anthropic.com 접속
로그인 후 왼쪽 메뉴에서 “API Keys” 클릭
“Create Key” 버튼 클릭
키 이름을 입력하고 생성
생성된 키를 즉시 복사 (한 번만 표시됩니다!)
PowerShell에서 환경 변수를 설정합니다:

$env:ANTHROPIC_API_KEY = "sk-ant-여기에-복사한-키-붙여넣기"

이 설정을 영구적으로 저장하려면:

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-여기에-복사한-키-붙여넣기", "User")

⚠️ API 키는 비밀번호와 같습니다. 절대로 다른 사람에게 공유하거나 GitHub에 올리지 마세요.

로그인 확인

로그인이 정상적으로 되면 Claude Code 프롬프트가 나타납니다:

╭────────────────────────────────────────╮
│ ✻ Welcome to Claude Code!              │
│                                        │
│   /help for available commands         │
╰────────────────────────────────────────╯

>

이 화면이 보이면 성공입니다. /exit을 입력하면 종료됩니다.

7단계: bkit 플러그인 설치

bkit(Vibecoding Kit)은 클로드 코드를 훨씬 더 체계적으로 사용할 수 있게 해주는 플러그인입니다. PDCA(Plan-Do-Check-Act) 방법론 기반의 개발 워크플로우, 자동 문서 생성, 코드 품질 관리 기능을 제공합니다.

설치 방법

Claude Code 안에서 실행합니다. PowerShell에서 먼저 Claude Code를 실행하세요:

claude

Claude Code 프롬프트(>)가 나타나면, 아래 명령어를 순서대로 입력합니다:

1단계: 마켓플레이스 등록

/plugin marketplace add popup-studio-ai/bkit-claude-code

이 명령어는 bkit 플러그인이 있는 저장소(마켓플레이스)를 Claude Code에 등록합니다.

2단계: 플러그인 설치

/plugin install bkit

설치가 완료되면 bkit의 기능들을 바로 사용할 수 있습니다.

설치 확인

Claude Code 안에서 아래 명령어를 입력해봅니다:

/bkit

bkit의 기능 목록이 나타나면 설치 성공입니다. 주요 명령어:

명령어	설명
`/pdca plan 기능이름`	새 기능 계획 문서 작성
`/pdca design 기능이름`	설계 문서 작성
`/pdca analyze 기능이름`	구현 후 갭 분석
`/pdca status`	현재 PDCA 진행 상태 확인
`/starter`	초보자용 정적 웹사이트 가이드

전체 설치 확인 — 한 번에 검증하기

모든 설치가 끝났으면, PowerShell을 새로 열고 아래 명령어를 한 줄씩 실행해서 전체를 검증합니다:

git --version
python --version
node --version
npm --version
claude --version

모든 명령어에서 버전 번호가 나오면 완벽한 개발 환경 세팅 완료입니다!

예상 결과:

git version 2.53.0.windows.2
Python 3.14.3
v24.14.1
11.x.x
claude v2.1.x

자주 묻는 질문 (FAQ)

Q1. “실행 정책” 오류가 나면?

PowerShell에서 스크립트를 실행할 때 “이 시스템에서 스크립트를 실행할 수 없으므로…” 오류가 나올 수 있습니다. 이럴 때는:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

“실행 정책을 변경하시겠습니까?” → Y 입력 후 Enter. 이후 설치 명령어를 다시 실행하세요.

Q2. 클로드 코드 설치에 꼭 구독이 필요한가요?

설치 자체는 무료입니다. 다만 사용하려면 Claude Pro($20/월), Max($100/월 또는 $200/월) 같은 구독이나 API 키(종량제)가 필요합니다.

Q3. WSL(Windows Subsystem for Linux)은 필요 없나요?

필요 없습니다. 과거에는 WSL이 필요했지만, 2025년부터 클로드 코드가 윈도우를 네이티브로 지원합니다. Git for Windows만 설치하면 됩니다.

Q4. Python과 Node.js를 안 설치하면 어떻게 되나요?

클로드 코드 자체는 동작합니다. 하지만:

Python 없으면: Python 프로젝트를 만들거나 실행할 수 없음
Node.js 없으면: 웹 프로젝트(React, Next.js 등) 작업 불가, npm 명령어 사용 불가

실제 개발을 하려면 대부분 필요하니 같이 설치하는 걸 추천합니다.

Q5. 업데이트는 어떻게 하나요?

네이티브 인스톨러로 설치한 경우: 자동으로 백그라운드 업데이트됩니다. 신경 쓸 필요 없습니다.

npm으로 설치한 경우: 아래 명령어로 수동 업데이트합니다:

npm update -g @anthropic-ai/claude-code

Q6. 클로드 코드를 삭제하려면?

네이티브 인스톨러:

rm -r ~/.local/bin/claude*
rm -r ~/.claude

npm:

npm uninstall -g @anthropic-ai/claude-code

클로드 코드 윈도우 설치 후 첫 번째로 해볼 것

설치가 완료되었다면, 아래 순서로 클로드 코드를 처음 사용해보세요:

1. 프로젝트 폴더 만들기

mkdir ~/my-first-project
cd ~/my-first-project

2. Claude Code 실행

claude

3. 간단한 요청 해보기

Claude Code 프롬프트에서 다음을 입력해봅니다:

간단한 HTML 자기소개 페이지를 만들어줘

클로드가 코드를 작성하고, 파일을 생성하고, 실행 방법까지 안내해줄 겁니다.

4. bkit으로 체계적인 개발 시작

/pdca plan my-portfolio

이 명령어를 입력하면 bkit이 포트폴리오 프로젝트의 계획 문서를 자동으로 생성해줍니다. PDCA 흐름(계획 → 설계 → 구현 → 검증)을 따라가면 초보자도 체계적으로 프로젝트를 완성할 수 있습니다.

마무리

정리하면, 클로드 코드 윈도우 설치는 이 7단계입니다:

PowerShell 열기 — 윈도우 기본 프로그램
Git 설치 — https://git-scm.com 에서 다운로드
Python 설치 — https://python.org 에서 다운로드 (PATH 체크 필수!)
Node.js 설치 — https://nodejs.org 에서 LTS 다운로드
Claude Code 설치 — irm https://claude.ai/install.ps1 | iex
로그인 — claude 실행 후 계정 인증
bkit 설치 — Claude Code 안에서 /plugin install bkit

각 단계마다 PowerShell을 닫았다가 다시 여는 것만 기억하면, 큰 문제 없이 설치가 완료됩니다. 처음이라 어렵게 느껴질 수 있지만, 한 번 세팅해놓으면 그 다음부터는 claude 한 줄이면 AI 코딩 파트너와 함께 개발을 시작할 수 있습니다.

혹시 설치 중 막히는 부분이 있다면 댓글로 남겨주세요. 직접 경험한 해결법으로 도와드리겠습니다!

관련 글 읽어보기:

외부 참고:

설치 순서 미리 보기

1단계: PowerShell 열기

여는 방법

확인: PowerShell 버전 체크

2단계: Git for Windows 설치

다운로드

설치

설치 확인

3단계: Python 설치

다운로드

설치

설치 확인

4단계: Node.js 설치

다운로드

설치

설치 확인

5단계: 클로드 코드(Claude Code) 설치

방법 A: 네이티브 인스톨러 (추천)

방법 B: npm으로 설치

설치 확인

🔧 트러블슈팅: “claude를 인식할 수 없습니다” 오류

6단계: Claude Code 로그인

로그인 방법

방법 1: 구독 계정으로 로그인 (추천)

방법 2: API 키 사용

로그인 확인

7단계: bkit 플러그인 설치

설치 방법

설치 확인

전체 설치 확인 — 한 번에 검증하기

자주 묻는 질문 (FAQ)

Q1. “실행 정책” 오류가 나면?

Q2. 클로드 코드 설치에 꼭 구독이 필요한가요?

Q3. WSL(Windows Subsystem for Linux)은 필요 없나요?

Q4. Python과 Node.js를 안 설치하면 어떻게 되나요?

Q5. 업데이트는 어떻게 하나요?

Q6. 클로드 코드를 삭제하려면?

클로드 코드 윈도우 설치 후 첫 번째로 해볼 것

1. 프로젝트 폴더 만들기

2. Claude Code 실행

3. 간단한 요청 해보기

4. bkit으로 체계적인 개발 시작

마무리

Related Posts