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).
• git instalado dentro da distribuição.

Iniciar uma sessão WSL

1. Escolha uma distribuição

Inicie uma nova sessão na aba Code e abra o seletor de ambiente abaixo da caixa de prompt, ou acima dela no layout anterior. Suas distribuições WSL 2 instaladas aparecem em WSL. Escolha uma.

2. Escolha uma pasta

A sessão inicia no diretório pessoal 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.

3. Confie na pasta

A primeira sessão em uma pasta mostra o diálogo de confiança do workspace. Você concede confiança por distribuição e pasta. Uma pasta em que você confia em uma distribuição não é confiável em outra distribuição ou no 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.

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.

Se um recurso do Desktop estiver indisponível ou limitado em uma sessão WSL, verifique se é um destes:

• Terminal e conectores: sua sessão pode não ter o terminal integrado, os conectores ou ambos. Consulte Se o terminal ou os conectores não estiverem disponíveis.
• Plugins: não estão disponíveis em sessões WSL
• Edição de arquivos: você pode visualizar arquivos no painel de arquivos, mas não pode editá-los lá, então peça ao Claude para fazer as alterações
• Anexos: se o menu + mostrar Add image no lugar de Add files or photos, você pode anexar apenas imagens. Consulte Adicionar arquivos e contexto aos prompts.

Se o terminal ou os conectores não estiverem disponíveis

Você não pode ativar o terminal integrado ou os conectores para uma sessão WSL por conta própria:

• Conta Claude: os dois recursos estão sendo lançados separadamente. Selecione Help > Check for Updates… e, se um recurso ainda estiver faltando depois de atualizar, não há nada a fazer.
• Provedor terceirizado: sessões WSL não recebem o terminal nem os conectores, e atualizar o Desktop não muda isso

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.