Pular para o conteúdo principal
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. Suas distribuições WSL 2 instaladas aparecem em uma seção WSL. Escolha uma.
2

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.
3

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.