Quais extensoes do VS Code sao uteis para agentes de IA no WSL?

Remote - WSL (obrigatoria), GitHub Copilot (se usar), GitLens, Prettier, ESLint, Docker e Thunder Client. Instale tambem o Claude Code como extensao se disponivel. Evite extensoes que duplicam funcionalidades que o agente ja oferece.

Como faco para o Claude Code trabalhar no mesmo projeto que o VS Code?

Abra a pasta do projeto no VS Code via Remote - WSL (code . dentro do WSL). No terminal integrado do VS Code (Ctrl+), execute npx @anthropic-ai/claude-code. O Claude Code roda no mesmo diretorio e ve os mesmos arquivos. No Orquestra, voce pode ter o VS Code e o terminal do Claude Code lado a lado.

VS Code com WSL e mais rapido que rodar o VS Code direto no Windows?

Para projetos dentro do WSL, sim. O acesso ao sistema de arquivos ext4 dentro do WSL e mais rapido que o NTFS, e a extensao Remote - WSL otimiza a comunicacao entre os dois sistemas. Para projetos no Windows, rode o VS Code diretamente.

WSL · 2026-07-12

VS Code + WSL: Ambiente Integrado para Agentes de IA

Configure VS Code com WSL 2 para desenvolver com Claude Code, Codex e OpenCode. Remote Development, integracao de terminal e dicas de produtividade.

A combinacao de VS Code + WSL e uma das configuracos mais poderosas para desenvolvedores que usam agentes de IA no Windows. O VS Code oferece o melhor ambiente de edicao, enquanto o WSL fornece a compatibilidade Unix que Claude Code, Codex e OpenCode exigem para operar com maxima eficiencia.

O problema e que a configuracao padrao do VS Code com WSL pode deixar a desejar: terminais que abrem no lugar errado, extensoes que nao funcionam entre os dois sistemas, e integracao limitada entre o editor e os agentes.

Este guia mostra como configurar o VS Code e o WSL 2 para trabalhar em harmonia com agentes de IA, incluindo dicas de extensoes, configuracao de terminal e integracao com o Orquestra.

Instalando e configurando Remote - WSL

A extensao Remote - WSL da Microsoft e a peca central da integracao. Ela permite que o VS Code rode no Windows mas opere como se estivesse dentro do WSL:

Instale o VS Code no Windows:Baixe do site oficial. Durante a instalacao, marque "Adicionar ao PATH".
Instale a extensao Remote - WSL:No VS Code, va em Extensoes (Ctrl+Shift+X) e busque por "Remote - WSL". Instale e recarregue.
Teste a conexao: Abra o terminal WSL e execute code .no diretorio do projeto. O VS Code abre com uma indicacao "WSL: Ubuntu-24.04" no canto inferior esquerdo.

# Dentro do WSL, no diretorio do projeto{' '} cd ~/projetos/app-web{' '} code .

Quando conectado via Remote - WSL, o VS Code instala um servidor dentro do WSL. As extensoes que voce instalar no modo WSL rodam dentro do Linux, com acesso total ao sistema de arquivos ext4 e aos binarios do WSL.

Sugestao de imagem:Screenshot do VS Code aberto com Remote - WSL conectado ao Ubuntu-24.04, mostrando o indicador verde "WSL: Ubuntu-24.04" no canto inferior esquerdo e o terminal integrado rodando Claude Code.

Terminal integrado para agentes de IA

O terminal integrado do VS Code e onde Claude Code, Codex e OpenCode vao rodar. Configure-o para abrir diretamente no WSL:

Configuracao do terminal integrado

No settings.json do VS Code (Ctrl+Shift+P > Preferences: Open Settings JSON), adicione:

"terminal.integrated.defaultProfile.windows": "WSL", "terminal.integrated.profiles.windows": { "WSL": { "path": "wsl.exe", "args": ["-d", "Ubuntu-24.04"] } }

Agora, Ctrl+' abre o terminal diretamente no WSL, no diretorio do projeto aberto. Claude Code roda com acesso completo ao sistema de arquivos Linux.

Multiplos terminais para multi-agente

No VS Code, voce pode abrir multiplos terminais (Ctrl+Shift+5) e dar a cada um um nome e cor diferente. Use um terminal para Claude Code, outro para Codex, outro para OpenCode:

# Terminal 1 (verde): Claude Code{' '} cd ~/projetos/app-web && npx @anthropic-ai/claude-code{' '} {' '} # Terminal 2 (azul): Codex{' '} cd ~/projetos/api-python && codex --dir .{' '} {' '} # Terminal 3 (laranja): OpenCode{' '} cd ~/projetos/testes-e2e && npx opencode --watch

Para uma experiencia ainda melhor, abra esses terminais no Orquestra, onde voce pode ve-los lado a lado em um canvas infinito, em vez de abas sobrepostas no VS Code.

Extensoes essenciais para agentes de IA no VS Code

Nem toda extensao do VS Code funciona bem no modo WSL. Aqui estao as recomendadas e as que devem ser evitadas:

Extensoes que funcionam no WSL

Remote - WSL: Obrigatoria. Sem ela, o VS Code nao consegue se conectar ao WSL.
GitLens: Funciona perfeitamente no WSL. Mostra blame, historia e comparacao de branches diretamente no editor.
Prettier e ESLint: Instale-os no contexto WSL. Eles usam os binarios Node.js do WSL, que sao os mesmos que Claude Code usa.
Docker: A extensao Docker do VS Code funciona com o Docker Desktop integrado ao WSL.
GitHub Copilot: Funciona no modo WSL e complementa o trabalho dos agentes de IA.

Extensoes para evitar no modo WSL

Evite extensoes que dependem de caminhos do Windows ou ferramentas que nao existem no WSL. Por exemplo, extensoes que chamam executaveis do Windows diretamente podem falhar. Instale essas extensoes no contexto LOCAL (Windows), nao no WSL.

Fluxo de trabalho integrado: VS Code + WSL + Orquestra

A configuracao ideal para produtividade maxima com agentes de IA combina as tres ferramentas. Aqui esta o fluxo recomendado:

1. Edicao no VS Code: Abra o projeto via Remote - WSL. Edite codigo, navegue por arquivos, use o Git integrado.
2. Agentes no Orquestra: No Orquestra, abra terminais WSL apontando para os diretorios dos agentes. Cada agente tem seu proprio terminal no canvas.
3. Sincronizacao em tempo real: Quando Claude Code modifica um arquivo, o VS Code detecta a mudanca automaticamente. Quando voce salva no VS Code, o agente enxerga a versao atualizada.
4. Revisao com Codex: Enquanto Claude Code implementa, Codex revisa no mesmo projeto. Voce ve ambos os terminais no Orquestra.
5. Commits e push: Use o Git integrado do VS Code para versionar o codigo gerado pelos agentes.

Dica:Use o recurso de "Split Editor" do VS Code (Ctrl+\) para ver o codigo original de um lado e as modificacoes que Claude Code esta fazendo do outro. No Orquestra, mantenha o terminal do Claude Code visivel para acompanhar o progresso.

Configuracao sincronizada entre VS Code e agentes

Para que VS Code e agentes de IA usem as mesmas configuracos de formatacao e estilo de codigo:

.editorconfig e .prettierrc

Mantenha arquivos de configuracao na raiz do projeto. Tanto o VS Code quanto Claude Code e Codex respeitam essas configuracos:

# .editorconfig{' '} root = true{' '} {' '} [*]{' '} indent_style = space{' '} indent_size = 2{' '} end_of_line = lf{' '} charset = utf-8{' '} trim_trailing_whitespace = true{' '} insert_final_newline = true

Quando voce define indentacao de 2 espacos no .editorconfig, tanto o VS Code quanto Claude Code usam a mesma configuracao. Isso evita que o agente gere codigo com formatacao diferente da que voce usa.

Variaveis de ambiente compartilhadas

Configure variaveis de ambiente no .env ou no perfil do WSL para que VS Code e agentes enxerguem as mesmas chaves de API e configuracoes:

# ~/.bashrc no WSL{' '} export ANTHROPIC_API_KEY="sk-ant-..."{' '} export OPENAI_API_KEY="sk-proj-..."

O VS Code herda essas variaveis quando aberto via Remote - WSL, e os agentes tambem.

Perguntas frequentes

Preciso instalar o VS Code dentro do WSL?

Nao. O VS Code roda no Windows e usa Remote - WSL para se conectar ao WSL. O servidor VS Code e instalado automaticamente no WSL na primeira conexao.

Quais extensoes sao uteis para agentes no WSL?

Remote - WSL (obrigatoria), GitLens, Prettier, ESLint, Docker e GitHub Copilot. Evite extensoes que dependem de ferramentas do Windows.

Como faco para Claude Code trabalhar no mesmo projeto que o VS Code?

Abra a pasta via Remote - WSL (code . no WSL). No terminal integrado, execute npx @anthropic-ai/claude-code. Eles compartilham o mesmo diretorio.

VS Code com WSL e mais rapido que VS Code direto no Windows?

Para projetos no WSL, sim. O acesso ao ext4 e mais rapido que NTFS. Para projetos no Windows, rode o VS Code diretamente.

O Orquestra substitui o VS Code?

Nao. Orquestra orquestra agentes de IA. VS Code edita codigo. Eles sao complementares: VS Code para edicao, Orquestra para coordenar Claude Code, Codex e OpenCode.

VS Code + WSL + Orquestra: o trio ideal

Baixe o Orquestra para Windows 11 e integre seus agentes de IA com VS Code e WSL 2. Canvas infinito para coordenar Claude Code, Codex e OpenCode. 7 dias gratis.

Começar teste grátis