윈도우에서 Claude Code 설치하고 시작하는 완벽 가이드 (WSL 없이)

AI 코딩 어시스턴트의 판도를 바꾸고 있는 Claude Code. IDE에 종속되지 않는 CLI 기반 도구로, Cursor나 WindSurf 같은 기존 에디터 플러그인과는 전혀 다른 개발 경험을 제공한다. 이 글에서는 윈도우 환경에서 WSL 없이 Claude Code를 설치하고, VS Code와 연동하여 실전에서 활용하는 방법까지 단계별로 정리해본다.

Claude Code란?

Claude Code는 Anthropic이 만든 CLI 기반 AI 코딩 어시스턴트다. 터미널에서 직접 실행되며, 코드 작성·리팩토링·디버깅·리뷰 등 개발 전반을 AI와 대화하면서 진행할 수 있다.

기존에 많이 사용되는 Cursor, WindSurf, Copilot 같은 도구들이 특정 에디터에 종속되는 것과 달리, Claude Code는 어떤 에디터와도 조합할 수 있다는 점이 가장 큰 차이다. 백엔드 개발자가 IntelliJ를, 프론트엔드 개발자가 VS Code를 쓰든 상관없이 동일한 환경에서 AI의 도움을 받을 수 있다.

윈도우 네이티브 지원 소식

2025년 7월 11일, Anthropic은 Claude Code v1.0.51부터 윈도우를 공식 지원한다고 발표했다. 이전까지는 리눅스 환경(WSL)을 반드시 구성해야 했지만, 이제는 윈도우 명령 프롬프트에서 바로 설치하고 사용할 수 있게 되었다.

사전 준비물

Claude Code를 설치하기 전에 두 가지를 먼저 준비해야 한다.

1. Git 설치

윈도우용 Git을 공식 사이트에서 다운로드하여 설치한다. 설치 후 명령 프롬프트에서 git --version으로 정상 설치 여부를 확인할 수 있다.

2. Node.js 설치

Node.js는 nvm(Node Version Manager)을 통해 설치하는 것을 권장한다. 향후 Node.js 버전을 유연하게 변경할 수 있어 여러 프로젝트를 동시에 관리할 때 편리하다.

# nvm 설치 후 최신 LTS 버전 설치
nvm install --lts
nvm use --lts

# 설치 확인
node --version
npm --version

설치 방법

Git과 Node.js가 준비되었다면, 설치는 명령어 한 줄이면 끝난다.

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

설치가 완료되면 버전을 확인해보자.

claude --version

Claude Code 시작하기

실행 방법

터미널을 열고 프로젝트 디렉토리로 이동한 뒤, 다음 명령어로 Claude Code를 시작한다.

# 현재 디렉토리에서 시작
claude

# 특정 프로젝트 경로를 지정하여 시작
claude --project-path /path/to/your/project

처음 실행하면 테마(다크/라이트)를 선택하는 화면이 나타나고, 이후 인증 과정을 거치게 된다.

인증 방식 선택

Claude Code는 두 가지 인증 방식을 제공한다.

요금제 비교

VS Code와 연동하기

Claude Code의 진가는 에디터와 함께 사용할 때 발휘된다. VS Code와 연동하는 방법을 알아보자.

1단계: WSL Extension 설치 (선택사항)

WSL 환경을 병행하는 경우, VS Code의 Extension 탭에서 "WSL"을 검색하여 설치한다. 설치 후 "Connect to WSL"을 클릭하면 VS Code가 WSL 환경으로 재시작된다.

2단계: Claude Code 공식 Extension 설치

VS Code Extension 탭에서 "claude"를 검색하면 Anthropic 공식 플러그인이 나타난다. 이를 설치하면 다음 기능들을 사용할 수 있다.

• 자동 설치: VS Code 터미널에서 Claude Code를 실행하면 확장 기능이 자동으로 연결
• 선택 영역 컨텍스트 전달: 에디터에서 코드를 드래그하면 자동으로 Claude 프롬프트에 포함
• Diff 뷰어 통합: 코드 변경 사항을 터미널이 아닌 VS Code의 diff 뷰어에서 직접 확인
• 열린 파일 인식: Claude가 현재 VS Code에서 열려 있는 파일들을 인식하여 컨텍스트 파악

3단계: Claude Code Chat 플러그인 (선택사항)

CLI 인터페이스가 익숙하지 않다면, Claude Code Chat 플러그인을 추가로 설치해볼 수 있다. Ctrl + Shift + C로 호출할 수 있는 GUI 기반 채팅 인터페이스를 제공한다.

구독 플랜으로 로그인하기

API 토큰이 소진되었거나, 처음부터 구독 플랜으로 시작하고 싶다면 /login 명령어로 인증 방식을 변경할 수 있다.

/login

1. Subscription을 선택
2. 브라우저가 열리면 Claude 계정으로 로그인
3. 승인 화면에서 "Allow" 클릭
4. 표시되는 인증 코드를 복사
5. 터미널의 프롬프트에 붙여넣기 후 Enter

요금 표시에 대한 오해 풀기

VS Code 플러그인 하단에 표시되는 달러($) 금액과 토큰 수치를 보고 놀라는 경우가 많다. 하지만 이 수치는 실제 청구 금액이 아니라 사용량을 API 요금 기준으로 환산한 참고치다.

• Pro/Max 구독 사용자: 플랜 한도 내에서는 추가 과금 없음. 표시되는 금액은 참고용
• API 크레딧 연동 사용자: 한도 초과 시 실제 과금 발생 가능. 자동 충전(Auto Reload) 설정을 반드시 확인
• 안전하게 사용하려면: 로그인 시 Pro/Max 플랜 계정만 사용하고, API 콘솔 키는 입력하지 않기

MCP 연동

2025년 7월 19일 기준으로 MCP(Model Context Protocol) 연동이 매우 간편해졌다. /config 명령어를 입력하면 인기 있는 MCP 서버 목록이 표시되고, 원하는 항목을 선택하기만 하면 자동으로 활성화된다.

실전 활용 예시

Claude Code Chat 플러그인을 활용한 실전 사용 모습을 살펴보자.

PR 리뷰 요청

간단한 명령으로 현재 작업 중인 PR에 대한 코드 리뷰를 받을 수 있다.

Thinking 과정 확인

Claude의 사고 과정(Thinking)을 한글로 확인하면 AI가 어떤 논리로 코드를 분석하는지 투명하게 볼 수 있다.

토큰 사용량 모니터링

대화를 진행하면서 소모되는 토큰 사용량을 실시간으로 확인할 수 있다.

사용 시 알아두면 좋은 점

장점

• IDE에 종속되지 않는 유연한 개발 환경
• 강력한 코드 분석 및 리팩토링 능력
• 프로젝트 컨텍스트를 이해하는 대화형 개발
• MCP를 통한 확장성

현실적인 단점

• 사용량 제한이 체감됨: Pro 플랜 기준으로 오전에 한 번, 오후에 한 번 한도에 도달하는 경우가 있음
• 안정적인 인터넷 연결 필요
• CLI에 익숙하지 않은 사용자에게는 초기 진입 장벽

마무리

윈도우 환경에서 Claude Code를 설치하고 VS Code와 연동하는 과정을 살펴봤다.

AI 코딩 어시스턴트는 이제 선택이 아닌 필수가 되어가고 있다. Claude Code는 단순한 자동완성 도구가 아니라, 개발자의 사고 흐름에 맞춰 함께 일하는 개발 파트너에 가깝다. 한 줄의 명령어로 시작할 수 있으니, 아직 경험해보지 않았다면 직접 사용해보기를 권한다.

참고 자료: Claude Code 공식 문서