WSL의 Claude Code Desktop
WSL 2 배포판 내에서 Code 세션 실행
Windows에서 Code 탭은 Windows 자체가 아닌 WSL 2 배포판 내에서 세션을 실행할 수 있습니다. 세션의 Claude Code 프로세스, 해당 도구 및 git은 모두 배포판 내에서 실행되며, 해당 배포판의 Linux 도구 체인과 기본 Linux 경로를 사용하여 프로젝트가 대상으로 하는 동일한 환경에서 실행됩니다.
저장소가 배포판의 파일 시스템 내에 있을 때 WSL 세션을 사용합니다. Windows에서 해당 파일을 작업하면 네트워크 파일 시스템을 통해 진행되므로 속도가 느리고 파일 감시가 중단됩니다. 배포판 내에서 세션을 실행하면 둘 다 피할 수 있습니다.
요구 사항
- WSL 2가 설치된 Windows 10 또는 11. WSL 1은 지원되지 않습니다.
- 설치된 배포판이 최소 하나 이상 필요합니다(예: Ubuntu).
- 배포판 내에
git이 설치되어 있어야 합니다.
WSL 세션 시작
폴더 선택
세션은 배포판의 홈 디렉터리에서 시작됩니다. 폴더 선택기를 사용하여 프로젝트 폴더를 선택합니다. 검색은 배포판 내에서 진행되며 /home/you/project와 같은 Linux 경로를 사용합니다.
폴더 신뢰
폴더의 첫 번째 세션에는 워크스페이스 신뢰 대화 상자가 표시됩니다. 신뢰는 배포판 및 폴더별로 부여됩니다. 한 배포판의 폴더를 신뢰하는 것이 다른 배포판이나 Windows의 동일한 경로에 적용되지는 않습니다.
배포판의 첫 번째 세션은 Claude가 내부에 설정되는 동안 약간 더 오래 걸립니다. 일반 폴더 선택기에서 \\wsl.localhost\... 폴더를 열 수도 있으며, 해당 배포판 내에서 다시 열립니다.
WSL 세션에서 작동하는 기능
병렬 세션, 측면 채팅, 시각적 diff 검토, 브랜치 및 풀 리퀘스트 상태, worktree는 모두 배포판 내의 git 및 도구 체인으로 지원됩니다. "편집기에서 열기"는 Remote - WSL을 통해 배포판에 연결된 VS Code를 엽니다.
WSL 세션에서 Desktop 기능을 사용할 수 없거나 제한되는 경우 다음 중 하나에 해당하는지 확인합니다.
- 터미널 및 커넥터: 세션에 통합 터미널, 커넥터 또는 둘 다 없을 수 있습니다. 터미널 또는 커넥터를 사용할 수 없는 경우를 참조하세요.
- 플러그인: WSL 세션에서는 사용할 수 없습니다
- 파일 편집: 파일 창에서 파일을 볼 수는 있지만 편집할 수는 없으므로 Claude에게 변경을 요청합니다
- 첨부 파일: + 메뉴에 파일 또는 사진 추가 대신 이미지 추가가 표시되면 이미지만 첨부할 수 있습니다. 프롬프트에 파일 및 컨텍스트 추가를 참조하세요.
터미널 또는 커넥터를 사용할 수 없는 경우
WSL 세션의 통합 터미널이나 커넥터는 사용자가 직접 켤 수 없습니다.
- Claude 계정: 두 기능은 별도로 출시되고 있습니다. **Help > Check for Updates…**를 선택하고, 업데이트한 후에도 기능이 여전히 없다면 따로 조치할 것은 없습니다.
- 서드파티 제공업체: WSL 세션에서는 터미널이나 커넥터가 제공되지 않으며, Desktop을 업데이트해도 달라지지 않습니다
관리되는 디바이스
조직에서 관리하는 디바이스에서는 WSL 세션을 사용할 수 없을 수 있습니다. 세션 시작이 디바이스가 관리된다는 메시지와 함께 실패하면 이는 관리자가 제어합니다. 관리자: 배포 가이드의 설정이 디바이스에 도달하는 방식 결정을 참조하세요.