Windows 11에서 Claude Code 사용하기

Windows 11에서 Claude Code를 사용하려면 WSL(Windows Subsystem for Linux)을 통해 리눅스 환경을 만든 뒤 설치 및 인증 과정을 거쳐야 합니다.

준비 및 환경 설정

• 운영체제: Windows 11(버전 21H2 이상 추천)에서만 정상적으로 WSL2 이용 가능.

• 필수 조건: WSL2, Ubuntu(20.04 이상), Node.js(18 이상), npm(10 이상), Git 권장.

설치 단계

1. WSL2 설치

   • PowerShell(관리자 권한) 실행 후 명령어 입력:

     text

     wsl --install


   • 재부팅 후 wsl 명령으로 Ubuntu 환경 진입.

2. Ubuntu 업데이트

   • WSL 터미널에서:

     text

     sudo apt update && sudo apt upgrade


   • 최신 패키지 확보.

3. Node.js & npm 설치

   • Ubuntu 터미널 입력:

     text

     sudo apt install nodejs npm


   • Node.js 18 이상, npm 10 이상 필요.

4. Claude Code 설치

   • 글로벌 설치:

     text

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


   • 만약 OS 감지 실패시:

     text

     npm config set os linux
npm install -g @anthropic-ai/claude-code --no-os-check


   • 권한 오류 발생 시:

     text

     npm config set prefix ~/.npm-global


   • 위 경로로 설치.

실행 및 인증

• 프로젝트 디렉터리에서 명령어 사용:

  text

  claude


• 최초 실행 시 브라우저에서 Anthropic Console 인증 요구. Claude Pro·Max 구독 또는 Bedrock/Vertex AI 키 연결 계정 필요.

• 인증 완료 후 터미널에서 자연어로 명령 입력:

  text

  claude "이 코드 설명해줘"
claude "이슈 고쳐줘"
claude commit
claude "PR 만들어줘"


에러 및 추가 안내

• 설치 에러 시: OS 감지 및 npm 권한 관련 옵션 활용.

• 깃 연동 등 고급기능: git 설치 및 레포지토리 초기화 필요.

참고

• 최신 공식 문서는 Anthropic 공식 페이지 및 커뮤니티 블로그에서 확인 가능.

• VS Code 등 통합 개발환경과 연동법은 별도 가이드 참고.

요약

Claude Code를 Windows 11에서 쓰려면 WSL2/Ubuntu 환경 구축→Node.js/npm 설치→글로벌 Claude Code CLI 설치→Anthropic 인증 및 명령 사용 순서로 따라하면 됩니다.