Claude Code Desktop em WSL
Execute sessões de Code dentro de uma distribuição WSL 2 no Windows
No Windows, a aba Code pode executar uma sessão dentro de uma distribuição WSL 2 em vez de no próprio Windows. O processo Claude Code da sessão, suas ferramentas e git são todos executados dentro da distribuição, usando sua cadeia de ferramentas Linux e caminhos nativos do Linux, o mesmo ambiente que seu projeto visa.
Use uma sessão WSL quando seu repositório reside dentro do sistema de arquivos da distribuição. Trabalhar nesses arquivos a partir do Windows passa por um sistema de arquivos de rede, que é lento e quebra a observação de arquivos; executar a sessão dentro da distribuição evita ambos.
Requisitos
- Windows 10 ou 11 com WSL 2. WSL 1 não é suportado.
- Pelo menos uma distribuição instalada (por exemplo, Ubuntu).
gitinstalado dentro da distribuição.
Iniciar uma sessão WSL
Escolha uma distribuição
Inicie uma nova sessão na aba Code e abra o seletor de ambiente. Suas distribuições WSL 2 instaladas aparecem em uma seção WSL. Escolha uma.
Escolha uma pasta
A sessão inicia no diretório inicial da distribuição. Use o seletor de pasta para escolher uma pasta de projeto. A navegação acontece dentro da distribuição, com caminhos Linux como /home/you/project.
Confie na pasta
A primeira sessão em uma pasta mostra o diálogo de confiança do espaço de trabalho. A confiança é concedida por distribuição e pasta; confiar em uma pasta em uma distribuição não se aplica a outra distribuição ou ao mesmo caminho no Windows.
A primeira sessão em uma distribuição leva um pouco mais de tempo enquanto Claude se configura dentro dela. Você também pode abrir uma pasta \\wsl.localhost\... do seletor de pasta normal, e ela reabre dentro dessa distribuição.
As pastas que você usou recentemente aparecem no seletor por distribuição, portanto reconectar a um projeto é um clique.
O que funciona em uma sessão WSL
Sessões paralelas, chats laterais, revisão de diff visual, status de branch e pull request, e worktrees funcionam todos, apoiados pelo git e cadeia de ferramentas dentro da distribuição. "Abrir no editor" abre VS Code conectado à distribuição através de Remote - WSL.
Alguns recursos ainda não estão disponíveis em sessões WSL: o terminal integrado, conectores e plugins, bifurcação de sessão, o painel do navegador de arquivos e sugestões de arquivo quando você digita @ no compositor.
Dispositivos gerenciados
Em dispositivos gerenciados por uma organização, as sessões WSL podem estar indisponíveis. Se o início da sessão falhar com uma mensagem de que o dispositivo é gerenciado, isso é controlado pelo seu administrador. Administradores: consulte como as configurações chegam aos dispositivos no guia de implantação.