Visual Studio Code

​

Extensão VS Code (Beta)

A extensão VS Code, disponível em beta, permite que você veja as alterações do Claude em tempo real através de uma interface gráfica nativa integrada diretamente ao seu IDE. A extensão VS Code facilita o acesso e a interação com Claude Code para usuários que preferem uma interface visual em vez do terminal.

​

Recursos

A extensão VS Code fornece:

• Experiência nativa do IDE: Painel dedicado da barra lateral do Claude Code acessado através do ícone Spark
• Modo de plano com edição: Revise e edite os planos do Claude antes de aceitá-los
• Modo de aceitação automática de edições: Aplique automaticamente as alterações do Claude conforme são feitas
• Gerenciamento de arquivos: Mencione arquivos com @ ou anexe arquivos e imagens usando o seletor de arquivos do sistema
• Uso de servidor MCP: Use servidores Model Context Protocol configurados através da CLI
• Histórico de conversas: Acesso fácil a conversas anteriores
• Múltiplas sessões: Execute múltiplas sessões do Claude Code simultaneamente
• Atalhos de teclado: Suporte para a maioria dos atalhos da CLI
• Comandos de barra: Acesse a maioria dos comandos de barra da CLI diretamente na extensão

​

Requisitos

• VS Code 1.98.0 ou superior

​

Instalação

Baixe e instale a extensão do Visual Studio Code Extension Marketplace.

​

Como Funciona

Depois de instalada, você pode começar a usar Claude Code através da interface VS Code:

1. Clique no ícone Spark na barra lateral do seu editor para abrir o painel Claude Code
2. Solicite ao Claude Code da mesma forma que faria no terminal
3. Observe enquanto Claude analisa seu código e sugere alterações
4. Revise e aceite edições diretamente na interface
   • Dica: Arraste a barra lateral para mais largo para ver diffs inline, depois clique neles para expandir e ver os detalhes completos

​

Usando Provedores de Terceiros (Vertex e Bedrock)

A extensão VS Code suporta o uso do Claude Code com provedores de terceiros como Amazon Bedrock e Google Vertex AI. Quando configurada com esses provedores, a extensão não solicitará login. Para usar provedores de terceiros, configure variáveis de ambiente nas configurações da extensão VS Code:

1. Abra as configurações do VS Code
2. Procure por “Claude Code: Environment Variables”
3. Adicione as variáveis de ambiente necessárias

​

Variáveis de Ambiente

Para instruções de configuração detalhadas e opções de configuração adicionais, consulte:

• Claude Code no Amazon Bedrock
• Claude Code no Google Vertex AI

​

Ainda Não Implementado

Os seguintes recursos ainda não estão disponíveis na extensão VS Code:

• Configuração completa do servidor MCP: Você precisa configurar servidores MCP através da CLI primeiro, então a extensão os usará
• Configuração de subagentos: Configure subagentos através da CLI para usá-los no VS Code
• Pontos de verificação: Salve e restaure o estado da conversa em pontos específicos
• Atalhos avançados:
  • Atalho # para adicionar à memória
  • Atalho ! para executar comandos bash diretamente
• Conclusão de abas: Conclusão de caminho de arquivo com tecla tab

Estamos trabalhando para adicionar esses recursos em futuras atualizações.

​

Considerações de Segurança

Quando Claude Code é executado no VS Code com permissões de edição automática ativadas, ele pode ser capaz de modificar arquivos de configuração do IDE que podem ser executados automaticamente pelo seu IDE. Isso pode aumentar o risco de executar Claude Code no modo de edição automática e permitir contornar os prompts de permissão do Claude Code para execução de bash. Ao executar no VS Code, considere:

• Ativar Modo Restrito do VS Code para espaços de trabalho não confiáveis
• Usar modo de aprovação manual para edições
• Tomar cuidado extra para garantir que Claude seja usado apenas com prompts confiáveis

​

Integração CLI Legada

A primeira integração VS Code que lançamos permite que Claude Code em execução no terminal interaja com seu IDE. Ela fornece compartilhamento de contexto de seleção (a seleção/aba atual é compartilhada automaticamente com Claude Code), visualização de diff no IDE em vez do terminal, atalhos de referência de arquivo (Cmd+Option+K no Mac ou Alt+Ctrl+K no Windows/Linux para inserir referências de arquivo como @File#L1-99), e compartilhamento automático de diagnósticos (erros de lint e sintaxe). A integração legada é instalada automaticamente quando você executa claude do terminal integrado do VS Code. Simplesmente execute claude do terminal e todos os recursos são ativados. Para terminais externos, use o comando /ide para conectar Claude Code à sua instância VS Code. Para configurar, execute claude, digite /config, e defina a ferramenta de diff como auto para detecção automática do IDE. Tanto a extensão quanto a integração CLI funcionam com Visual Studio Code, Cursor, Windsurf e VSCodium.

​

Solução de Problemas

​

Extensão Não Instalando

• Certifique-se de que você tem uma versão compatível do VS Code (1.85.0 ou posterior)
• Verifique se o VS Code tem permissão para instalar extensões
• Tente instalar diretamente do site do marketplace

​

Integração Legada Não Funcionando

• Certifique-se de que você está executando Claude Code do terminal integrado do VS Code
• Certifique-se de que a CLI para sua variante de IDE está instalada:
  • VS Code: o comando code deve estar disponível
  • Cursor: o comando cursor deve estar disponível
  • Windsurf: o comando windsurf deve estar disponível
  • VSCodium: o comando codium deve estar disponível
• Se o comando não estiver instalado:
  1. Abra a paleta de comandos com Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux)
  2. Procure por “Shell Command: Install ‘code’ command in PATH” (ou equivalente para seu IDE)

Para ajuda adicional, consulte nosso guia de solução de problemas.