WSL에 Claude Code 설치하기
WSL(Windows Subsystem for Linux)은 Windows에서 Linux 환경을 사용할 수 있게 해주는 강력한 도구예요. WSL 환경에 Claude Code를 설치하면 Windows의 편의성과 Linux의 강력함을 동시에 누릴 수 있어요.
이 가이드는 WSL 위에서 Claude Code를 설치하고 사용하는 전체 과정을 다룰 거예요. Windows 사용자라면 이 방법이 가장 효과적일 거예요.
WSL 기초 이해
Claude Code를 설치하기 전에 WSL이 무엇인지 이해하는 것이 중요해요.
WSL이란?
WSL은 Microsoft가 제공하는 호환성 계층으로, Windows에서 Linux 바이너리를 직접 실행할 수 있게 해줘요. 가상머신이나 듀얼부트 없이 Linux를 경험할 수 있어요.
WSL 버전
현재는 WSL2가 최신 버전이에요. WSL2는 실제 Linux 커널을 사용하므로 성능과 호환성이 훨씬 뛰어나요. 가능하면 WSL2를 설치하는 것이 좋아요.
WSL 설치 확인
Claude Code를 설치하기 전에 WSL이 제대로 설치되어 있는지 확인해야 해요.
WSL 설치 상태 확인
Windows PowerShell(관리자 권한)에서 명령어를 실행하면 설치된 WSL 배포판을 확인할 수 있어요.
WSL 버전 확인
WSL1과 WSL2 중 어떤 버전을 사용 중인지 확인하는 것도 중요해요. 버전에 따라 성능이 큰 차이가 난다거든요.
WSL에서 Claude Code 설치
WSL의 Linux 환경에 Claude Code를 설치하는 과정을 알아봐요.
1단계: WSL 터미널 실행
Windows 시작 메뉴에서 설치된 Linux 배포판을 찾아서 실행해요. Ubuntu라면 Ubuntu 앱을 실행하면 WSL 터미널이 열려요.
2단계: 패키지 관리자 업데이트
Linux 환경에 들어가면 먼저 패키지 목록을 업데이트해요. WSL에 새로 설치한 배포판은 패키지 정보가 오래되어 있을 수 있거든요.
3단계: 필수 패키지 설치
Claude Code가 필요로 하는 패키지들을 설치해요. 이 과정은 일반 Linux에서의 설치와 동일해요.
4단계: Claude Code 설치
모든 준비가 완료되면 Claude Code 설치 명령어를 실행해요. WSL의 패키지 관리자를 사용하면 자동 설치가 진행돼요.
Windows와 WSL 환경 연동
Claude Code를 설치한 후 Windows와 WSL 간에 파일을 공유하고 연동하는 방법들이 있어요.
파일 시스템 접근
Windows 파일 탐색기에서 WSL의 파일에 접근할 수 있어요. WSL 드라이브를 마운트하면 Windows에서 Linux 파일을 직접 열 수 있어요.
프로젝트 위치 선택
WSL에 /home 디렉토리에 프로젝트를 두면 성능이 더 좋아요. Windows의 C:\ 드라이브에 프로젝트를 두면 느려질 수 있어요.
WSL에서 Claude Code 사용
설치 후 WSL 환경에서 Claude Code를 효과적으로 사용하는 방법들이 있어요.
텍스트 편집기로 사용
WSL의 텍스트 편집기로 Claude Code를 사용할 수 있어요. 파일을 열고 편집할 수 있어요.
프로젝트 폴더 열기
Claude Code로 전체 프로젝트 폴더를 열면 더 많은 기능을 활용할 수 있어요. 파일 간 관계를 파악하고 효율적으로 작업할 수 있어요.
Windows Terminal에서의 통합
Windows Terminal을 사용하면 WSL과의 통합이 더욱 개선돼요.
Windows Terminal 설정
Windows Terminal에서 WSL을 기본 셸로 설정할 수 있어요. 이렇게 하면 항상 WSL 환경에서 작업할 수 있어요.
명령어 팔레트
Windows Terminal에서 Ctrl+Shift+P를 눌러 명령어 팔레트를 열 수 있어요. 여기서 Claude Code 관련 명령어를 빠르게 실행할 수 있어요.
일반적인 문제와 해결
WSL에서 Claude Code를 설치할 때 발생할 수 있는 문제들이 있어요.
WSL2 성능 문제
WSL2는 가상머신처럼 작동하므로 메모리를 많이 사용해요. .wslconfig 파일을 수정하여 메모리 할당을 조정할 수 있어요.
파일 접근 권한 오류
Windows와 WSL 간의 파일 권한 차이로 오류가 발생할 수 있어요. WSL 위의 파일은 Linux 권한 시스템을 따르므로 주의해야 해요.
네트워크 연결 문제
WSL은 네트워크를 Windows와 공유하지만, 때로는 연결 문제가 발생할 수 있어요. resolv.conf 파일을 확인하거나 네트워크 설정을 재설정해보세요.
성능 최적화
WSL 환경에서 Claude Code의 성능을 최대한 활용하는 팁들이 있어요.
- WSL2 사용: WSL1보다 WSL2가 훨씬 빠르고 호환성이 좋아요
- 프로젝트 위치: /home에 프로젝트를 두면 성능이 좋아요
- 메모리 관리: .wslconfig로 메모리 할당을 적절히 설정하세요
- 디스크 정리: 불필요한 파일을 정기적으로 정리하세요
Windows 도구와의 호환성
WSL 환경의 Claude Code와 Windows 도구들의 호환성을 이해하는 것이 중요해요.
Visual Studio Code 통합
VS Code는 WSL 환경을 직접 지원해요. Remote – WSL 확장을 사용하면 VS Code에서 직접 WSL 환경에 접속할 수 있어요.
Git 통합
Windows의 Git을 WSL에서도 사용할 수 있어요. 버전 관리를 더욱 간편하게 할 수 있어요.
마치며
WSL 환경에서 Claude Code를 사용하는 것은 Windows 사용자에게 이상적인 개발 환경을 제공해요. WSL의 Linux 호환성과 Claude Code의 강력한 기능이 결합되면 생산성이 크게 향상돼요.
초기 설정이 조금 복잡할 수 있지만, 한 번 설정하면 매우 효율적인 개발 환경을 갖추게 될 거예요. Windows와 Linux를 오가며 작업할 수 있다는 장점을 충분히 활용해보세요.