Windows에 Claude Code 설치 방법 (2026년 가이드)

빠른 요약: Windows에 Claude Code를 설치하려면 WSL2(Linux용 Windows 하위 시스템)를 설정하고 Ubuntu를 설치한 다음 간단한 설치 스크립트를 실행해야 합니다. 이 과정을 통해 Windows 사용자는 터미널을 통해 Anthropic의 AI 코딩 도우미에 액세스할 수 있습니다. 네이티브 Windows 바이너리가 제공되지만 WSL2는 여전히 Windows 설치에 가장 좋은 방법입니다.

Claude Code는 터미널에서 직접 작동하는 AI 기반 코딩 도우미로, 개발자가 기능을 구축하고 버그를 수정하며 개발 작업을 자동화하도록 돕습니다. 하지만 Windows 사용자에게는 주의할 점이 있습니다.

Claude Code는 네이티브 Windows 실행 파일로 제공되며 WSL2 없이 npm 또는 직접 바이너리 다운로드를 통해 설치할 수 있습니다. 그러나 Linux용 Windows 하위 시스템(WSL2)이 필요하며 공식 설치 방법은 여전히 WSL2에 의존합니다.

Windows 11 또는 Windows 10에서 작동하도록 하는 방법은 다음과 같습니다.

시스템 요구 사항

설치를 시작하기 전에 Windows 머신이 다음 요구 사항을 충족하는지 확인하십시오.

• Windows 10 1809 이상 또는 Windows Server 2019 이상
• Windows 11(모든 버전)
• 최소 4GB의 RAM 사용 가능
• 시스템에 대한 관리자 권한
• WSL2 및 Ubuntu 다운로드를 위한 인터넷 연결

설치에는 WSL2, Ubuntu 및 Claude Code를 위한 디스크 공간이 필요합니다.

1단계: Linux용 Windows 하위 시스템 활성화

WSL2는 Windows 내에서 직접 Linux 환경을 제공합니다. Claude Code가 작동하도록 하는 기반입니다.

PowerShell을 관리자 권한으로 엽니다. 시작 버튼을 마우스 오른쪽 버튼으로 클릭하고 Windows 11에서는 "Windows PowerShell(관리자)" 또는 "터미널(관리자)"을 선택합니다.

이 명령을 실행합니다.

wsl --install

이 명령은 필요한 Windows 기능을 활성화하고 기본 Linux 배포판으로 Ubuntu를 설치합니다. 시스템에서 다시 시작하라는 메시지가 표시될 수 있습니다.

다시 시작한 후 WSL2는 설정을 자동으로 완료합니다. Ubuntu가 시작되고 사용자 이름과 암호를 묻습니다. 이 자격 증명은 Linux 환경에만 해당하며 Windows 자격 증명과 일치할 필요는 없습니다.

2단계: WSL2 설치 확인

시스템을 다시 시작하고 Ubuntu가 초기 설정을 완료하면 WSL2가 올바르게 실행되고 있는지 확인하십시오.

Ubuntu 터미널을 열고(시작 메뉴에서 "Ubuntu" 검색) 다음 명령을 실행합니다.

wsl --version

이 명령은 WSL 버전 정보를 표시합니다. 출력에서 "WSL version: 2.x.x"를 찾으십시오.

명령이 WSL1 대신 WSL1을 표시하는 경우 다음 명령으로 WSL2로 업그레이드하십시오.

wsl --set-default-version 2

3단계: Claude Code 설치

이제 실제 Claude Code 설치 차례입니다. 공식 설명서에는 한 줄 설치 스크립트가 제공됩니다.

Ubuntu 터미널에서 다음 명령을 실행합니다.

curl -fsSL claude.ai/install.sh | bash

이 스크립트는 Claude Code 바이너리를 다운로드하고 필요한 권한을 설정하며 시스템 PATH에 추가합니다. 설치 시간은 인터넷 속도와 시스템 사양에 따라 다릅니다.

공식 Claude Code 설명서에 따르면 설치 프로그램은 시스템 아키텍처를 자동으로 감지하고 적절한 바이너리 버전을 다운로드합니다.

일반적인 설치 문제

일부 Windows 사용자는 설치 후 "command not found: claude"라는 메시지가 표시된다고 보고합니다. 이는 일반적으로 PATH 변수가 새로고침되지 않았기 때문입니다.

Ubuntu 터미널을 닫았다가 다시 열고 다시 시도하십시오. 문제가 지속되면 다음 경로 구성을 비공식 해결 방법으로 사용할 수 있습니다.

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

4단계: Claude Code 인증

Claude Code는 사용 전에 Anthropic 계정으로 인증해야 합니다.

이 명령을 실행합니다.

claude

터미널에 URL이 표시되고 인증을 요청합니다. 개인 사용자와 팀 계정에 따라 프로세스가 약간 다릅니다.

제공된 URL을 브라우저에서 열고 Anthropic 계정에 로그인한 후 Claude Code를 승인하십시오. 터미널에서 인증 성공을 확인합니다.

WSL2에서 Windows 프로젝트 작업

여기서부터 복잡해집니다. Windows 파일 시스템과 WSL2 파일 시스템은 분리되어 있습니다.

Windows 파일은 WSL2에서 /mnt/c/(C: 드라이브의 경우), /mnt/d/(D: 드라이브의 경우) 등에서 액세스할 수 있습니다. 하지만 성능 비용이 발생합니다. 커뮤니티 논의에 따르면 Windows 마운트된 디렉토리와 네이티브 WSL2 디렉토리 간에 성능 차이가 있습니다.

최상의 성능을 위해 프로젝트 파일을 WSL2 홈 디렉토리로 복사하십시오.

cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project

단점은 무엇일까요? IDE 통합이 더 복잡해집니다. Visual Studio Code는 Remote-WSL 확장을 통해 이를 잘 처리하지만 다른 IDE는 어려움을 겪을 수 있습니다.

설치 테스트

간단한 테스트로 Claude Code가 올바르게 작동하는지 확인하십시오.

프로젝트 디렉토리로 이동하거나(테스트 폴더 생성) 다음을 수행합니다.

mkdir ~/claude-test
cd ~/claude-test
claude "create a simple hello world Python script"

Claude Code가 응답하고 파일을 생성하며 코드를 표시해야 합니다. 이는 설치가 성공했음을 확인합니다.

과다 지불 중단, 먼저 사용 가능한 AI 크레딧 청구

Windows에 Claude Code를 설치하는 것은 일반적으로 빠릅니다. 개발자가 프롬프트를 테스트하고 스크립트를 실행하며 모델을 애플리케이션에 통합하기 시작하면 실제 비용이 나중에 발생합니다. 이러한 실험 단계에서는 많은 API 호출이 발생할 수 있으며, 많은 팀은 구축을 시작한 후에야 비용을 인식합니다.

사용 비용을 지출하기 전에 AI 크레딧 또는 파트너 프로그램에 자격이 있는지 확인하는 것이 좋습니다. Get AI Perks는 이러한 기회를 한곳에 모아 AI 공급업체, 클라우드 플랫폼 및 개발자 도구의 크레딧 및 할인 목록과 함께 청구 방법을 간단하게 안내합니다.

첫 Claude Code 프로젝트를 실행하기 전에 Get AI Perks를 확인하고 개발 비용을 충당할 수 있는 AI 크레딧을 청구하십시오.

자주 묻는 질문

설치 후 다음 단계

Claude Code를 설치한 후 기능을 탐색하십시오. 빠른 시작 설명서에서는 더 복잡한 작업으로 이동하기 전에 코드 설명과 같은 간단한 작업으로 시작하는 것이 좋습니다.

익숙해지려면 다음 명령을 시도하십시오.

• claude "explain this function" -- 코드 설명 가져오기
• claude commit -- Git 커밋 메시지 생성
• claude -c -- 최근 대화 계속

공식 설명서에는 IDE 통합, 플러그인 설치 및 고급 구성 옵션에 대한 자세한 가이드가 제공됩니다. 팀의 경우 서버 관리 설정 및 분석 추적은 Claude Code 배포에 대한 추가 제어를 제공합니다.

WSL2 설정은 네이티브 Windows 애플리케이션에 비해 추가 단계처럼 보일 수 있지만 현재 Windows에서 Claude Code를 실행할 수 있는 유일한 방법입니다. 좋은 소식은 무엇입니까? 구성이 완료되면 원활하게 실행되고 대부분의 개발 워크플로우와 통합됩니다.