# Claude Code no VS Code: instalação, diffs e configurações

URL: https://agentvera.dev/pt/blog/claude-code-vs-code/ · Publicado: 2026-10-23

Instale a extensão Claude Code para VS Code, use o contexto da seleção e a visão de diff, ajuste as configurações certas, resolva problemas e use em IDEs JetBrains.

**Resumo:**

- A extensão oficial do Claude Code (anthropic.claude-code) exige VS Code 1.94.0 ou mais recente e um plano Pro, Max, Team ou Enterprise ou uma conta Console.
- Instalar a extensão não coloca o claude no seu PATH; instale o CLI standalone para usá-lo em um terminal, e os dois compartilham o histórico de conversas.
- Nas IDEs JetBrains, o plugin Claude Code [Beta] roda o CLI claude no terminal da IDE, então o CLI precisa estar instalado antes.

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](https://code.claude.com/docs/en/vs-code "Claude Code no VS Code") e da [documentação do JetBrains](https://code.claude.com/docs/en/jetbrains "Claude Code em IDEs JetBrains") oficiais.

## Instale a extensão

1. Abra o VS Code e pressione `Cmd+Shift+X` (Mac) ou `Ctrl+Shift+X` (Windows/Linux).
2. Procure **Claude Code** e instale a extensão da Anthropic.
3. Se ela não aparecer de imediato, reinicie o VS Code ou rode **Developer: Reload Window** na Command Palette.
4. 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](https://code.claude.com/docs/en/setup "Configurar o Claude Code").

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](/pt/blog/claude-code-commands-cheat-sheet/ "Colinha de comandos do Claude Code").

## 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:name` referencia a saída de um terminal.
- `Cmd+Esc` / `Ctrl+Esc` alterna 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+Esc` abre o Claude Code a partir do editor.
- `Cmd+Option+K` / `Alt+Ctrl+K` insere 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 `auto` ou `terminal` em `/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 `/ide` para 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](/pt/blog/best-ai-coding-cli-tools/ "Melhores ferramentas CLI de código com IA"), e perde a noção de qual deles precisa de resposta.

É para esse caso que o [AgentVera](/pt/agents/claude-code/ "Claude Code no 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](/pt/features/workspace/ "Workspace") organiza os agentes em grids de até 5×4. O [Group view](/pt/features/group-view/ "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](/pt/features/editor-and-terminal/ "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](/pt/features/git-and-github/ "Git e GitHub") acrescenta worktrees e PRs.
- **Uma segunda leitura.** A [revisão de código automática](/pt/features/code-review/ "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](/pt/blog/git-worktree-parallel-agents/ "Git worktrees para agentes em paralelo") é o próximo passo.

Para testar o AgentVera, comece pela [página inicial](/pt/ "AgentVera").

## Perguntas frequentes

**Como instalo a extensão Claude Code no VS Code?** Abra a visão Extensions com Cmd+Shift+X ou Ctrl+Shift+X, procure Claude Code e instale a extensão publicada pela Anthropic (ID anthropic.claude-code). Ela exige VS Code 1.94.0 ou mais recente e um plano Pro, Max, Team ou Enterprise ou uma conta Console.

**A extensão do VS Code inclui o CLI do Claude Code?** Ela traz uma cópia privada do CLI para o painel de chat, mas não coloca o claude no seu PATH. Para rodar claude no terminal integrado, instale o CLI standalone uma vez. Os dois compartilham o mesmo histórico de conversas, então claude --resume encontra as sessões da extensão.

**A extensão Claude Code funciona no Cursor?** Sim. A documentação do VS Code traz um link Install for Cursor, e outros forks do VS Code podem instalá-la pelo registro Open VSX. Em um editor que não consegue instalar a extensão, rode claude no terminal integrado.

**Por que não vejo o ícone Spark do Claude Code?** O ícone só aparece na barra de ferramentas do editor quando há um arquivo aberto. Confira se o VS Code é 1.94.0 ou mais recente, se o workspace é confiável e se nenhuma outra extensão de IA conflita, e depois rode Developer: Reload Window. O item Claude Code na barra de status funciona sem arquivo aberto.

**Existe um plugin do Claude Code para IDEs JetBrains?** Sim. O plugin Claude Code [Beta] do JetBrains Marketplace funciona com IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm e Android Studio. Ele roda o CLI no terminal da IDE, então o CLI precisa estar instalado, e acrescenta diffs da IDE e compartilhamento da seleção.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/