​
Extensão VS Code (Beta)

A extensão VS Code, disponível em beta, permite que você veja as mudanças do Claude em tempo real através de uma interface gráfica nativa integrada diretamente ao seu IDE. A extensão VS Code torna mais fácil acessar e interagir com Claude Code para usuários que preferem uma interface visual ao terminal.

​
Recursos

A extensão VS Code fornece:
  • Experiência nativa do IDE: Painel lateral dedicado 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 mudanças do Claude conforme elas são feitas
  • Gerenciamento de arquivos: @-mencione arquivos ou anexe arquivos e imagens usando o seletor de arquivos do sistema
  • Uso de servidor MCP: Use servidores do Protocolo de Contexto de Modelo configurados através do CLI
  • Histórico de conversas: Acesso fácil a conversas passadas
  • Múltiplas sessões: Execute múltiplas sessões do Claude Code simultaneamente
  • Atalhos de teclado: Suporte para a maioria dos atalhos do CLI
  • Comandos slash: Acesse a maioria dos comandos slash do 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.

​
Atualizando

Para atualizar a extensão VS Code:
  1. Abra a paleta de comandos do VS Code com Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux)
  2. Procure por “Claude Code: Update”
  3. Selecione o comando para atualizar para a versão mais recente

​
Como Funciona

Uma vez instalado, você pode começar a usar Claude Code através da interface do 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 você faria no terminal
  3. Observe enquanto Claude analisa seu código e sugere mudanças
  4. Revise e aceite edições diretamente na interface
    • Dica: Arraste a barra lateral para mais largo para ver diffs inline, então clique neles para expandir para detalhes completos

​
Ainda Não Implementado

Os seguintes recursos ainda não estão disponíveis na extensão VS Code:
  • Configuração completa de servidor MCP: Você precisa configurar servidores MCP através do CLI primeiro, então a extensão os usará
  • Configuração de subagentes: Configure subagentes através do CLI para usá-los no VS Code
  • Checkpoints: 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
  • Completar com tab: Completar caminho de arquivo com tecla tab
Estamos trabalhando para adicionar esses recursos em atualizações futuras.

​
Considerações de Segurança

Quando Claude Code executa no VS Code com permissões de auto-edição habilitadas, 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 auto-edição e permitir contornar os prompts de permissão do Claude Code para execução bash. Ao executar no VS Code, considere:
  • Habilitar Modo Restrito do VS Code para espaços de trabalho não confiáveis
  • Usar modo de aprovação manual para edições
  • Ter 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 executando no terminal interaja com seu IDE. Ela fornece compartilhamento de contexto de seleção (seleção/aba atual é automaticamente compartilhada 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 se auto-instala quando você executa claude do terminal integrado do VS Code. Simplesmente execute claude do terminal e todos os recursos se ativam. Para terminais externos, use o comando /ide para conectar Claude Code à sua instância do VS Code. Para configurar, execute claude, digite /config, e defina a ferramenta diff para 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 o CLI para sua variante de IDE está instalado:
    • VS Code: comando code deve estar disponível
    • Cursor: comando cursor deve estar disponível
    • Windsurf: comando windsurf deve estar disponível
    • VSCodium: 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, veja nosso guia de solução de problemas.