방법 1: WSL 안에서 Claude Code 실행 (권장)
WSL 환경에 Claude Code를 직접 설치해서 WSL 파일 시스템에서 작업하는 가장 안정적인 방법입니다.
1단계 — WSL 설치 (없다면)
# PowerShell (관리자 권한)
wsl --install
재시작 후 Ubuntu 설정(사용자명/비밀번호) 완료
2단계 — WSL 안에서 Node.js 설치
# Ubuntu 터미널에서
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
3단계 — Claude Code 설치
# npm 전역 경로 설정 (sudo 없이 설치하기 위해)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# Claude Code 설치
npm install -g @anthropic-ai/claude-code
4단계 — WSL 폴더에서 실행
cd ~/projects/my-project
claude
💡 WSL 홈 디렉터리(
~/) 안에서 작업하는 것이 훨씬 빠릅니다./mnt/c/...같은 Windows 경로는 파일시스템 교차 I/O로 인해 느려질 수 있습니다.
방법 2: Windows 네이티브 설치 후 WSL 폴더 접근
Claude Code는 2025년 네이티브 Windows 버전을 출시해서, 이제 WSL 없이도 직접 Windows에서 실행할 수 있습니다.
# PowerShell에서 설치
winget install Anthropic.ClaudeCode
WSL 폴더는 이렇게 접근:
# Windows에서 WSL 경로 접근
cd \\wsl$\Ubuntu\home\<username>\projects\my-project
claude
또는 WSL 터미널에서 직접 claude 실행 (Windows에 설치된 버전 활용).
방법 3: VS Code WSL Remote + Claude Code
VS Code와 함께 사용하면 가장 편리합니다.
- VS Code에 WSL 확장(Remote – WSL) 설치
- WSL 터미널에서 프로젝트 폴더로 이동 후
code .실행 - VS Code가 WSL 환경으로 열리면, 터미널에서
claude실행
VS Code를 열면 좌측 하단에 WSL: Ubuntu 표시가 나타나고, Explorer에서 WSL 파일을 직접 편집하면서 Claude Code를 함께 사용할 수 있습니다.
어떤 방법을 선택할까?
| 상황 | 추천 방법 |
|---|---|
| 주로 WSL/Linux 프로젝트 | 방법 1 (WSL 내부 설치) |
| Windows 네이티브 프로젝트 | 방법 2 (Windows 네이티브) |
| IDE 연동 원하는 경우 | 방법 3 (VS Code WSL Remote) |
공식 문서에서도 프로젝트 위치와 필요한 기능에 따라 Native Windows 또는 WSL 중 하나를 선택하도록 안내하고 있습니다.