A extensão Claude Code para VS Code é a extensão oficial da Anthropic (ID anthropic.claude-code) que coloca o Claude Code em um painel gráfico dentro do VS Code. Você a instala pela visão Extensions, faz login, e a partir daí o Claude vê o arquivo aberto e a sua seleção, mostra as edições propostas como diffs lado a lado que você aceita ou rejeita, e compartilha o histórico com o CLI. Ela exige VS Code 1.94.0 ou mais recente e um plano Claude pago ou uma conta Console. Se você prefere o terminal, também pode rodar o CLI claude no terminal integrado do VS Code e manter os diffs da IDE.
Este guia cobre a instalação, a extensão versus o CLI, a visão de diff, o contexto da seleção, as configurações que vale mudar, problemas comuns e uma seção curta sobre JetBrains. Tudo aqui vem da documentação do VS Code e da documentação do JetBrains oficiais.
Instale a extensão
- Abra o VS Code e pressione
Cmd+Shift+X(Mac) ouCtrl+Shift+X(Windows/Linux). - Procure Claude Code e instale a extensão da Anthropic.
- Se ela não aparecer de imediato, reinicie o VS Code ou rode Developer: Reload Window na Command Palette.
- Abra o painel e faça login quando ele pedir.
Requisitos:
| Requisito | Detalhe |
|---|---|
| VS Code | 1.94.0 ou mais recente |
| Conta | Plano Pro, Max, Team ou Enterprise, ou uma conta Console |
| Workspace | Confiável (a extensão não roda no Restricted Mode) |
Cursor e outros forks do VS Code
A documentação traz um link direto Install for Cursor, então o Cursor é suportado. Outros forks do VS Code podem instalar a extensão pelo registro Open VSX. Se o seu editor não consegue instalá-la de jeito nenhum, abra o terminal integrado dele e rode claude.
Abra o Claude Code
Há quatro caminhos:
- Ícone Spark na barra de ferramentas do editor, no canto superior direito. Só aparece quando há um arquivo aberto.
- Activity Bar: a lista de sessões à esquerda.
- Command Palette (
Cmd+Shift+P/Ctrl+Shift+P): digite “Claude Code” e escolha Open in New Tab. - Barra de status: clique em ✻ Claude Code no canto inferior direito. Funciona sem arquivo aberto.
Você pode arrastar o painel para a barra lateral secundária (direita), a barra lateral principal (esquerda) ou a área do editor como uma aba. A documentação sugere a barra lateral para a sessão principal e abas para tarefas paralelas.
Extensão ou CLI no terminal integrado?
Os dois são o mesmo Claude Code. A diferença está na interface e em alguns recursos.
| Recurso | CLI | Extensão do VS Code |
|---|---|---|
| Comandos e skills | Todos | Um subconjunto (digite / para ver) |
| Configuração de servidores MCP | Sim | Sim, com /mcp no painel |
| Checkpoints | Sim | Sim |
Atalho de shell ! | Sim | Não |
| Autocompletar com Tab | Sim | Não |
O detalhe que pega muita gente: instalar a extensão não coloca o claude no seu PATH. A extensão traz uma cópia privada do CLI para o painel dela. Para digitar claude em um terminal, você precisa da instalação standalone do CLI.
Com os dois instalados, eles compartilham o histórico de conversas. Rode claude --resume no terminal para retomar uma conversa que você começou no painel.
Para rodar o CLI dentro do VS Code, pressione Ctrl+` (ou Cmd+` no Mac) e rode claude. Ele se conecta à IDE automaticamente para diffs e diagnósticos. De um terminal externo, rode /ide dentro do Claude Code para conectá-lo ao VS Code.
Se você gosta da interface de terminal mas a quer no lugar do painel, ative a configuração Use Terminal (claudeCode.useTerminal).
Regra prática: use o painel quando quiser clicar pelos diffs e ver planos como documentos. Use o CLI quando quiser todos os slash commands, o modo shell com ! e os atalhos de teclado da nossa colinha.
Contexto da seleção e @-menções
A extensão adiciona à sua mensagem o arquivo aberto no editor, e o Claude vê o texto que você selecionou. Você não precisa colar código no prompt.
Option+K(Mac) /Alt+K(Windows/Linux) insere uma referência ao arquivo e à seleção atuais, como@auth.ts#5-10. O editor precisa estar em foco.@na caixa de prompt menciona qualquer arquivo ou pasta.@terminal:namereferencia a saída de um terminal.Cmd+Esc/Ctrl+Escalterna o foco entre o editor e o Claude.
Nota de privacidade: o texto selecionado não é enviado de arquivos que casam com files.exclude ou search.exclude, nem de arquivos ignorados pelo git enquanto respectGitIgnore estiver ativo. Isso vale para o painel de chat. Se você quer enviar só a seleção, e não o arquivo aberto inteiro, desative attachOpenFile.
A visão de diff
Quando o Claude quer mudar um arquivo no modo Manual, o VS Code mostra um diff lado a lado da edição proposta. Você pode aceitar, rejeitar ou editar o texto proposto antes de aceitar. Versões recentes também deixam você aceitar ou rejeitar mudanças individuais dentro de uma edição, com Accept Change at Cursor e Reject Change at Cursor na Command Palette. Edições muito grandes (mais de 100 mudanças) não ganham botões por mudança.
A frequência com que você vê diffs depende do modo de permissão na caixa de prompt:
| Modo | O que acontece |
|---|---|
| Manual | O Claude pergunta antes de cada edição e mostra o diff |
| Edit automatically | As edições são aplicadas sem perguntar |
| Plan | O Claude escreve um plano como documento Markdown que você pode comentar, e espera |
| Auto | O Claude decide com uma checagem de segurança; é o padrão em versões recentes |
Os checkpoints ficam por cima disso. Passe o mouse sobre uma mensagem para ver o botão de voltar: Rewind code to here, Fork conversation from here, ou os dois de uma vez.
Configurações que vale mudar
Abra as configurações do VS Code (Cmd+, / Ctrl+,) e vá em Extensions > Claude Code. Configurações compartilhadas, como comandos permitidos, hooks e servidores MCP, ficam em ~/.claude/settings.json, que o CLI também lê.
| Configuração | Padrão | Por que mudar |
|---|---|---|
useTerminal | false | Abre a interface no estilo CLI em vez do painel de chat |
initialPermissionMode | não definido | Inicia novos chats em default, plan, acceptEdits ou bypassPermissions |
preferredLocation | panel | sidebar mantém o Claude fixo à direita |
attachOpenFile | true | Desative para enviar só a sua seleção |
autosave | true | Salva os arquivos antes de o Claude lê-los ou escrevê-los |
useCtrlEnterToSend | false | Use Ctrl/Cmd+Enter para enviar e Enter para nova linha |
respectGitIgnore | true | Mantém arquivos ignorados pelo git fora da busca e do contexto da seleção |
environmentVariables | [] | Variáveis de ambiente só para o processo do Claude |
allowDangerouslySkipPermissions | false | Adiciona Bypass permissions ao menu de modos. Só para sandboxes |
initialPermissionMode é lido só das configurações de usuário, não das configurações do workspace. Adicione "$schema": "https://json.schemastore.org/claude-code-settings.json" ao settings.json para ter autocompletar.
Rode várias conversas
Open in New Tab (Cmd+Shift+Esc / Ctrl+Shift+Esc) e Open in New Window iniciam conversas extras com histórico próprio. Um ponto colorido no ícone spark da aba mostra o status: azul para um pedido de permissão pendente, laranja quando o Claude terminou enquanto a aba estava oculta. A lista de sessões pode agrupar sessões e filtrar por Needs input, Working ou Completed.
Resolva problemas comuns
| Problema | Solução |
|---|---|
| A extensão não instala | Confira se o VS Code é 1.94.0+, se ele pode instalar extensões, ou instale pela página do Marketplace |
| Sem ícone Spark | Abra um arquivo (só uma pasta não basta), confie no workspace, desative extensões de IA conflitantes, recarregue a janela |
Cmd+Esc não faz nada no macOS | O macOS Tahoe o associa ao Game Overlay. Desligue isso em Keyboard Shortcuts → Game Controllers, ou reatribua Claude Code: Focus input |
| “Not logged in · Please run /login” | Recarregue a janela e faça login de novo |
ANTHROPIC_API_KEY não é reconhecida | Abra o VS Code de um terminal com code . para ele herdar o ambiente |
claude não encontrado no terminal | Instale o CLI standalone; a extensão não o adiciona ao PATH |
| O Claude nunca responde | Confira a conexão, inicie uma nova conversa e depois tente claude em um terminal para ver um erro mais claro |
| Precisa de logs | Rode Claude Code: Show Logs na Command Palette |
Claude Code em IDEs JetBrains
O plugin Claude Code [Beta] do JetBrains Marketplace suporta IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm e GoLand. Diferente da extensão do VS Code, ele roda o CLI claude no terminal da IDE, então instale o CLI antes. Se aparecer “Cannot launch Claude Code”, o claude não está no seu PATH.
O que você ganha:
Cmd+Esc/Ctrl+Escabre o Claude Code a partir do editor.Cmd+Option+K/Alt+Ctrl+Kinsere uma referência de arquivo como@src/auth.ts#L1-99.- As mudanças propostas abrem no visualizador de diff da IDE. Defina Diff tool como
autoouterminalem/config. - Sua seleção e os diagnósticos da IDE (erros de lint e de tipo) são compartilhados com o Claude.
- De um terminal externo, rode
/idepara conectar.
Duas soluções da documentação: se Esc não interrompe o Claude, vá em Settings → Tools → Terminal e desmarque “Move focus to the editor with Escape”. No WSL, defina o comando Claude do plugin como wsl -d Ubuntu -- bash -lic "claude", e, se aparecer “No available IDEs detected”, adicione uma regra de firewall ou mude o WSL para mirrored networking.
Quando um app separado para muitos agentes faz sentido
A extensão é pensada para uma janela de editor e algumas conversas. Isso cobre a maioria dos dias. Fica mais difícil quando você roda quatro ou cinco agentes ao mesmo tempo em branches diferentes, ou mistura o Claude Code com o Codex ou outros agentes CLI, e perde a noção de qual deles precisa de resposta.
É para esse caso que o AgentVera foi feito. É um app desktop para macOS, Windows e Linux que roda cada agente CLI no próprio painel, em um grid por projeto. Ele não é um editor e não substitui o VS Code. Muita gente deixa os dois abertos.
- Muitos agentes, uma visão. O workspace organiza os agentes em grids de até 5×4. O Group view conta os agentes que estão trabalhando, esperando uma resposta ou esperando aprovação, com “Approve” e “Reject” em cada card.
- Diffs sem trocar de janela. As ferramentas de editor e terminal incluem um editor de arquivos e uma aba “Changes” que mostra o diff entre o HEAD e a working tree, unificado ou lado a lado. Git e GitHub acrescenta worktrees e PRs.
- Uma segunda leitura. A revisão de código automática faz um modelo Claude que você escolhe revisar o código de um agente quando o turno dele termina, com links arquivo:linha.
Se você está montando trabalho em paralelo, git worktrees para agentes em paralelo é o próximo passo.
Para testar o AgentVera, comece pela página inicial.