Use Claude Code in VS Code

Instale e configure a extensão Claude Code para VS Code. Obtenha assistência de codificação com IA com diffs inline, @-mentions, revisão de planos e atalhos de teclado.

A extensão VS Code fornece uma interface gráfica nativa para Claude Code, integrada diretamente ao seu IDE. Esta é a forma recomendada de usar Claude Code no VS Code.

Com a extensão, você pode revisar e editar os planos do Claude antes de aceitá-los, aceitar automaticamente edições conforme são feitas, @-mencionar arquivos com intervalos de linhas específicas da sua seleção, acessar o histórico de conversas e abrir múltiplas conversas em abas separadas ou janelas.

Pré-requisitos

Antes de instalar, certifique-se de que você tem:

• VS Code 1.94.0 ou superior
• Uma conta Anthropic: qualquer assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou uma conta Claude Console funciona, e nenhuma chave de API é necessária. Você fará login com essa conta quando abrir a extensão pela primeira vez. Se você acessar Claude através de um provedor de terceiros como Amazon Bedrock ou Google Cloud's Agent Platform, consulte Use third-party providers para instruções de configuração.

Instale a extensão

Clique no link do seu IDE para instalar diretamente:

• Instalar para VS Code
• Instalar para Cursor

Ou no VS Code, pressione Cmd+Shift+X (Mac) ou Ctrl+Shift+X (Windows/Linux) para abrir a visualização de Extensões, procure por "Claude Code" e clique em Instalar.

A extensão também é instalada em outros forks do VS Code como Devin Desktop ou Kiro. Procure por "Claude Code" na visualização de Extensões do editor, ou instale a partir do registro Open VSX. Se o seu editor não conseguir instalar a extensão, instale a CLI e execute claude no seu terminal integrado. A CLI funciona em qualquer terminal.

Comece agora

Após a instalação, você pode começar a usar Claude Code através da interface do VS Code:

1

Abra o painel Claude Code

Em todo o VS Code, o ícone Spark indica Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Ícone Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

A forma mais rápida de abrir Claude é clicar no ícone Spark na Barra de Ferramentas do Editor (canto superior direito do editor). O ícone só aparece quando você tem um arquivo aberto.

Outras formas de abrir Claude Code:

• Activity Bar: clique no ícone Spark na barra lateral esquerda para abrir a lista de sessões. Clique em qualquer sessão para abri-la no seu local preferido, ou inicie uma nova. Este ícone está sempre visível na Activity Bar.
• Command Palette: Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux), digite "Claude Code" e selecione uma opção como "Open in New Tab"
• Status Bar: se você definiu preferredLocation como sidebar, ou abriu Claude com Claude Code: Open in Side Bar, clique em ✱ Claude Code no canto inferior direito da janela. Isso funciona mesmo quando nenhum arquivo está aberto.

Você pode arrastar o painel Claude para reposicioná-lo em qualquer lugar no VS Code. Veja Personalize seu fluxo de trabalho para detalhes.

2

Faça login

A primeira vez que você abre o painel, uma tela de login aparece. Clique em Sign in e complete a autorização no seu navegador.

Se você vir Not logged in · Please run /login mais tarde, a extensão reabre a tela de login automaticamente. Se ela não aparecer, recarregue a janela a partir da Command Palette com Developer: Reload Window.

Se você tem ANTHROPIC_API_KEY definida no seu shell mas ainda vê o prompt de login, o VS Code pode não ter herdado o ambiente do seu shell. Inicie o VS Code a partir de um terminal com code . para que ele herde suas variáveis de ambiente, ou faça login com sua conta Claude.

Após fazer login, uma lista de verificação Learn Claude Code aparece. Trabalhe em cada item clicando em Show me, ou descarte-a com o X. Para reabri-la mais tarde, desmarque Hide Onboarding nas configurações do VS Code em Extensions → Claude Code.

3

Envie um prompt

Peça a Claude para ajudar com seu código ou arquivos, seja explicando como algo funciona, depurando um problema ou fazendo alterações.

Aqui está um exemplo de pergunta sobre uma linha particular em um arquivo:

4

Revise as alterações

O que você vê depende do modo de permissão mostrado na parte inferior da caixa de prompt:

• No modo Auto ou Edit automatically, Claude edita a maioria dos arquivos no seu workspace sem perguntar.
• No modo Manual, quando Claude quer editar um arquivo, ele mostra uma comparação lado a lado do original e das alterações propostas, depois pede permissão. Você pode aceitar, rejeitar ou dizer a Claude o que fazer em vez disso. Se você editar o conteúdo proposto diretamente na visualização de diff antes de aceitar, Claude é informado de que você o modificou para que não assuma que o arquivo corresponde à sua proposta original.

Para mais ideias sobre o que você pode fazer com Claude Code, veja Fluxos de trabalho comuns.

Use the prompt box

The prompt box supports several features:

• Permission modes: click the mode indicator at the bottom of the prompt box to switch permission modes. On Pro, Max, and Team plans, Auto is the built-in starting permission mode. See how the extension chooses the starting permission mode for what changes that, and every permission mode the indicator offers.
  • Auto: a classifier reviews most actions instead of asking you. See auto mode for what it reviews and blocks.
  • Manual: Claude asks permission before file edits and most shell commands.
  • Plan: Claude describes what it will do and waits for approval before making changes. VS Code automatically opens the plan as a full Markdown document where you can add inline comments to give feedback before Claude begins.
  • Edit automatically: Claude makes edits without asking.
• Model: select Switch model… from the command menu to change the model mid-session. You can also click the model name at the bottom of the prompt box to open the same picker. When the current model supports effort levels, the picker also shows an Effort row and the model name button shows the selected level. The model name button and the Effort row require Claude Code v2.1.257 or later.
• Command menu: click / or type / to open the command menu. Options include attaching files, switching models, and toggling extended thinking. The Customize section provides access to MCP servers, slash commands, output styles, hooks, memory, permissions, and plugins. Items with a terminal icon open in the integrated terminal.

  • To browse commands such as /usage or /remote-control, select Slash commands in the Customize section. A dialog lists them with a filter box. Pick one to run it. Typing / in the prompt box still suggests commands inline. Requires Claude Code v2.1.257 or later.

  • Select Output styles in the Customize section to pick an output style, including your custom styles. Requires Claude Code v2.1.257 or later.

    To create a custom style instead, select Build a custom style from the Output styles menu. Claude Code writes the style file for you at the project or user level. Requires Claude Code v2.1.261 or later.

  • The Settings section includes Enable Remote Control for all sessions, which sets remoteControlAtStartup to control whether new interactive sessions connect to Remote Control automatically. Requires Claude Code v2.1.203 or later.

    When you turn the toggle on or off in a VS Code window, the change applies to the sessions already open in that VS Code window, not only to sessions you start afterwards. If you turn it off, the open sessions disconnect. With Claude Code v2.1.261 or later, the change also reaches sessions open in your other VS Code windows.

  • The Settings section also includes Focus view, which hides tool calls, tool results, and thinking behind expandable rows, leaving your prompts and Claude's responses. Claude's latest to-do list stays visible, and so does the text a pending question from Claude is asking about; this requires Claude Code v2.1.225 or later. Toggle it there, with Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), or from the Command Palette with Claude Code: Toggle Focus view. The change applies to every open session and persists across sessions. Requires Claude Code v2.1.221 or later.

  • To report a bug, click Report a problem at the bottom of the menu, or type /bug or /feedback with an optional description that prefills the report. When you submit the report and you're signed in to Anthropic on a first-party connection, Claude Code sends it to Anthropic. On a third-party provider, or without Anthropic credentials, the dialog still opens, but submitting shows an error and sends nothing: unlike the CLI's /bug, the extension doesn't write a local archive. Requires Claude Code v2.1.229 or later.

• Side questions: type /btw followed by a question to ask about your session without adding to the conversation. The answer opens in a panel beside the chat, where you can ask follow-up questions. The thread survives window reloads. Claude Code keeps the newest 20 exchanges and expires stored threads on the cleanupPeriodDays schedule, as long as Claude Code can safely determine the retention period. To clear a thread, click the trash icon in the panel. Requires Claude Code v2.1.227 or later.
• Context indicator: the prompt box shows how much of Claude's context window you're using. Claude automatically compacts when needed, or you can run /compact manually.
• Extended thinking: lets Claude spend more time reasoning through complex problems. Toggle it on via the command menu (/). Claude's reasoning appears in the conversation as collapsed blocks: click a block to read it, or press Ctrl+O to expand or collapse every thinking block in the session. See Extended thinking for details.
• Multi-line input: press Shift+Enter to add a new line without sending. This also works in the "Other" free-text input of question dialogs.

Reference files and folders

Use @-mentions to give Claude context about specific files or folders. When you type @ followed by a file or folder name, Claude reads that content and can answer questions about it or make changes to it. Claude Code supports fuzzy matching, so you can type partial names to find what you need:

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

For large PDFs, you can ask Claude to read specific pages instead of the whole file: a single page, a range like pages 1-10, or an open-ended range like page 3 onward.

When you select text in the editor, Claude can see your highlighted code automatically. The prompt box footer shows how many lines are selected. Press Option+K (Mac) / Alt+K (Windows/Linux) to insert an @-mention with the file path and line numbers (e.g., @app.ts#5-10). Click the selection indicator to toggle whether Claude can see your highlighted text - the eye-slash icon means the selection is hidden from Claude.

To attach an image, paste it from your clipboard into the prompt box. You can also hold Shift while dragging files into the prompt box to add them as attachments. Click the X on any attachment to remove it from context.

Resume past conversations

Click the Session history button at the top of the Claude Code panel to access your conversation history. You can search by keyword or browse by time.

Click any conversation to resume it with the full message history. If the conversation is already open in another tab of the current window, clicking it switches to that tab. For more on resuming sessions, see Manage sessions.

• Session titles: new sessions receive AI-generated titles based on your first message.
• Rename and archive: hover over a session to reveal these actions. Rename to give it a descriptive title, or archive to move it to the Archived sessions group at the bottom of the list.

By default, a session with no activity for 14 days moves to Archived sessions automatically, unless it is open, unread, or in a group. Automatic archiving requires Claude Code v2.1.265 or later. To change the period or turn it off, open the Archive Inactive Sessions setting and select a number of days or Never.

To restore an archived session, expand Archived sessions and click Unarchive session. Before v2.1.257, the action was Delete session, which hid a session with no way to restore it. Sessions you deleted then appear under Archived sessions after you upgrade.

When the conversation you resume ended in plan mode, Claude Code restores plan mode. Requires Claude Code v2.1.246 or later. Claude Code doesn't restore it in two cases:

• The extension chooses the starting permission mode from claudeCode.initialPermissionMode or a pick that carries over from an earlier conversation
• You have claudeCode.claudeProcessWrapper configured

Resume cloud sessions from Claude.ai

If you use Claude Code on the web, you can resume those cloud sessions directly in VS Code. This requires signing in with Claude.ai Subscription, not Anthropic Console.

Check account and usage

Run /usage to open the Account & usage dialog. The dialog requires a claude.ai sign-in, so it isn't offered on a third-party provider. It shows your signed-in account, your plan, and usage bars for your plan's limits, such as the current session and the week. Each bar shows how long until its limit resets.

The dialog also breaks down what is contributing to your plan limits. It flags behaviors that account for 10% or more of recent usage, such as cache misses, long context, and subagent-heavy or highly parallel sessions, each with a tip to reduce it. Attribution tables show how much usage came from each skill, subagent, plugin, and MCP server. Requires Claude Code v2.1.174 or later.

Use the Day and Week toggle to switch between the last 24 hours and the last 7 days. The figures are approximate and computed from local sessions on this machine, so usage from other devices or claude.ai is not included. For more on tracking and reducing usage, see Track your costs.

Personalize seu fluxo de trabalho

Você pode reposicionar o painel Claude, executar múltiplas conversas, organizar a lista de sessões em grupos ou alternar para o modo terminal.

Escolha onde Claude fica

Você pode arrastar o painel Claude para reposicioná-lo em qualquer lugar no VS Code. Pegue na aba ou barra de título do painel e arraste para:

• Barra lateral secundária: o lado direito da janela. Mantém Claude visível enquanto você codifica.
• Barra lateral primária: a barra lateral esquerda com ícones para Explorer, Search, etc.
• Área do editor: abre Claude como uma aba ao lado de seus arquivos. Útil para tarefas secundárias.

Depois de executar Developer: Reload Window ou reiniciar o VS Code, se um chat volta com sua conversa depende de onde estava aberto:

• Aba do editor: a conversa volta com sua aba.
• Barra lateral: a conversa volta se você enviou uma mensagem ou Claude respondeu nela nos últimos 10 minutos. Se ela não voltar, retome a conversa do Histórico de sessões.

Execute múltiplas conversas

Use Open in New Tab ou Open in New Window da Paleta de Comandos para iniciar conversas adicionais. Cada conversa mantém seu próprio histórico e contexto, permitindo que você trabalhe em diferentes tarefas em paralelo.

Ao usar abas, um pequeno ponto colorido no ícone de spark indica o status: azul significa que uma solicitação de permissão está pendente, laranja significa que Claude terminou enquanto a aba estava oculta.

Organize sessões em grupos

Na lista de sessões da Activity Bar, você pode coletar sessões relacionadas em grupos nomeados e recolhíveis. Requer Claude Code v2.1.229 ou posterior.

• Agrupar ou desagrupar uma sessão: clique com o botão direito em uma sessão para criar um grupo a partir dela, movê-la para um grupo existente ou removê-la de seu grupo. Cada sessão pertence a um grupo por vez, então movê-la para outro grupo a remove do primeiro.
• Mover várias sessões de uma vez: Cmd-clique (Mac) / Ctrl-clique (Windows/Linux) em cada sessão, ou Shift-clique para selecionar um intervalo, depois clique com o botão direito na seleção.
• Agrupar uma sessão a partir de sua aba: execute Claude Code: Add Session Tab to Group da Paleta de Comandos, ou clique com o botão direito na aba do editor da sessão, depois escolha ou crie um grupo. Requer Claude Code v2.1.257 ou posterior.
• Renomear ou excluir um grupo: clique com o botão direito em um cabeçalho de grupo. Excluir um grupo remove apenas o grupo, e suas sessões retornam à lista desagrupada.

A extensão salva grupos por pasta de workspace, então eles sobrevivem a recarregamentos de janela e aparecem em cada janela onde você abre a mesma pasta. Quando você pesquisa a lista, a extensão mostra correspondências em uma lista plana única em todos os grupos.

Alterne para o modo terminal

Por padrão, a extensão abre um painel de chat gráfico. Se você preferir a interface no estilo CLI, abra a configuração Use Terminal e marque a caixa.

Você também pode abrir as configurações do VS Code (Cmd+, no Mac ou Ctrl+, no Windows/Linux), ir para Extensions → Claude Code e marcar Use Terminal.

Gerenciar plugins

A extensão VS Code inclui uma interface gráfica para instalar e gerenciar plugins. Digite /plugins na caixa de prompt para abrir a interface Gerenciar plugins.

Instalar plugins

O diálogo de plugin mostra duas abas: Plugins e Marketplaces.

Na aba Plugins:

• Plugins instalados aparecem no topo com interruptores de alternância para ativá-los ou desativá-los
• Plugins disponíveis de seus marketplaces configurados aparecem abaixo
• Pesquise para filtrar plugins por nome ou descrição
• Clique em Instalar em qualquer plugin disponível

Quando você instala um plugin, escolha o escopo de instalação:

• Instalar para você: disponível em todos os seus projetos (escopo de usuário)
• Instalar para este projeto: compartilhado com colaboradores do projeto (escopo de projeto)
• Instalar localmente: apenas para você, apenas neste repositório (escopo local)

Compartilhar um link de instalação de plugin

Para enviar alguém diretamente para instalar um plugin específico, forneça a URL install-plugin da extensão. Abri-la inicia ou foca VS Code, abre o painel Claude Code e abre o diálogo Gerenciar plugins na escolha de escopo daquele plugin. Nada é instalado até que a pessoa escolha um escopo. Se o marketplace do plugin ainda não estiver configurado no Claude Code deles, o diálogo primeiro pede que eles o adicionem.

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

A URL aceita dois parâmetros de consulta:

Dois casos terminam em uma mensagem no diálogo em vez da escolha de escopo:

• O marketplace não lista um plugin com esse nome: o diálogo relata que o plugin não foi encontrado. Verifique o valor plugin contra a listagem do marketplace.
• O plugin já está instalado: o diálogo diz isso, e nada muda.

READMEs do GitHub, problemas e alguns outros hosts Markdown removem links cujo esquema não é http ou https, então um link vscode:// lá é renderizado como texto simples. Coloque a URL em um bloco de código nesses hosts, conforme O link é renderizado como texto simples em vez de ser clicável descreve para links claude-cli://.

Gerenciar marketplaces

Alterne para a aba Marketplaces para adicionar ou remover fontes de plugin:

• Digite um repositório GitHub, URL ou caminho local para adicionar um novo marketplace
• Clique no ícone de atualização para atualizar a lista de plugins de um marketplace
• Clique no ícone de lixeira para remover um marketplace

As alterações de plugin que você faz no diálogo se aplicam imediatamente às sessões Claude Code abertas naquela janela VS Code. Se a sessão a partir da qual você abriu o diálogo não conseguir recarregar seus plugins, o diálogo oferece tentar novamente ou reiniciar Claude naquela sessão.

Para mais informações sobre o sistema de plugins, consulte Plugins e Plugin marketplaces.

Automatizar tarefas do navegador com Chrome

Conecte Claude ao seu navegador Chrome para testar aplicativos web, depurar com logs do console e automatizar fluxos de trabalho do navegador sem sair do VS Code. Isso requer a extensão Claude in Chrome versão 1.0.36 ou superior.

Digite @browser na caixa de prompt seguido pelo que você deseja que Claude faça:

@browser go to localhost:3000 and check the console for errors

Você também pode abrir o menu de anexos para selecionar ferramentas específicas do navegador, como abrir uma nova aba ou ler o conteúdo da página.

Claude abre novas abas para tarefas do navegador e compartilha o estado de login do seu navegador, para que possa acessar qualquer site em que você já esteja conectado.

Para instruções de configuração, a lista completa de recursos e solução de problemas, consulte Use Claude Code with Chrome.

Comandos e atalhos de teclado do VS Code

Abra a Paleta de Comandos (Cmd+Shift+P no Mac ou Ctrl+Shift+P no Windows/Linux) e digite "Claude Code" para ver todos os comandos disponíveis do VS Code para a extensão Claude Code.

Alguns atalhos de teclado dependem de qual painel está "focado" (recebendo entrada de teclado). Quando seu cursor está em um arquivo de código, o editor está focado. Quando seu cursor está na caixa de prompt do Claude, o Claude está focado. Use Cmd+Esc / Ctrl+Esc para alternar entre eles.

Iniciar uma aba do VS Code a partir de outras ferramentas

A extensão registra um manipulador de URI em vscode://anthropic.claude-code/open. Use-o para abrir uma nova aba Claude Code a partir de suas próprias ferramentas: um alias de shell, um bookmarklet de navegador ou qualquer script que possa abrir uma URL. Se o VS Code ainda não estiver em execução, abrir a URL o inicia primeiro. Se o VS Code já estiver em execução, a URL abre na janela que está atualmente focada.

Invoque o manipulador com o abridor de URL do seu sistema operacional.

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

O manipulador aceita dois parâmetros de consulta opcionais:

Por exemplo, para abrir uma aba pré-preenchida com "review my changes":

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

A extensão também manipula vscode://anthropic.claude-code/install-plugin, que abre o diálogo de plugin em um plugin. Para iniciar uma sessão de terminal em vez de uma aba do VS Code, use o manipulador claude-cli:// da CLI. Consulte Launch sessions from links.

Configurar configurações

A extensão tem dois tipos de configurações:

• Configurações da extensão no VS Code: controlam o comportamento da extensão dentro do VS Code. Abra com Cmd+, (Mac) ou Ctrl+, (Windows/Linux), depois vá para Extensões → Claude Code. Você também pode digitar / e selecionar General Config para abrir as configurações.
• Configurações do Claude Code em ~/.claude/settings.json: compartilhadas entre a extensão e CLI. Use-a para comandos permitidos, variáveis de ambiente, hooks e servidores MCP. Nos planos Pro, Max e Team, também é uma entrada para o modo de permissão em que as conversas começam. Switch permission modes lista a ordem. Veja Settings para detalhes.

Configurações da extensão

O VS Code lê initialPermissionMode das suas configurações de usuário e ignora valores de workspace. Antes da v2.1.225, o VS Code padronizava a configuração para default e aplicava valores de workspace.

Use a screen reader

The extension's chat panel works with screen readers. You don't need to turn anything on: the extension announces conversation activity for every user, with no visual change. This is separate from the CLI's opt-in screen reader mode, which adapts the terminal interface.

Screen reader support in the chat panel requires Claude Code v2.1.236 or later.

During a conversation, the extension announces:

• Claude's replies: the extension announces each reply once, when it's complete, and stays silent while text streams in. Your screen reader reads code blocks as a line-count summary, reads links by their label, and reads tables cell by cell; the full reply stays readable in the transcript.
• Permission requests and questions: the extension announces a request when its permission prompt appears, naming the tool Claude wants to use. It announces in the same way when Claude asks you a question and when Claude finishes a plan and waits for your review.
• Status changes: the extension announces when Claude starts working, when Claude is ready for your input, and when Claude Code starts compacting the conversation.
• Errors and model prompts: the extension announces errors in the conversation, and announces when the usage-credits consent prompt or the flagged-request prompt appears.

Each turn in the transcript starts with a visually hidden heading labeled with the prompt that started the turn, so you can jump between turns with your screen reader's heading navigation. You can also move focus to the transcript itself with Tab, since the extension exposes it as a labeled region, and read it at your own pace. While Claude works, your screen reader reads a text label in place of the progress spinner's animation.

When you reopen a session or switch to another one, the extension announces nothing: restored history, pending permission prompts, and in-progress status stay silent until something new happens.

Extensão VS Code vs. Claude Code CLI

Claude Code está disponível tanto como uma extensão VS Code (painel gráfico) quanto como um CLI (interface de linha de comando no terminal). Alguns recursos estão disponíveis apenas no CLI. Se você precisar de um recurso exclusivo do CLI, execute claude no terminal integrado do VS Code. Isso requer a instalação do CLI autônomo: a extensão não adiciona claude ao seu PATH. Veja Executar CLI no VS Code.

Rewind com checkpoints

A extensão VS Code suporta checkpoints, que rastreiam as edições de arquivo do Claude e permitem que você faça rewind para um estado anterior. Passe o mouse sobre qualquer mensagem para revelar o botão de rewind e escolha entre três opções:

• Fork conversation from here: inicie uma nova ramificação de conversa a partir desta mensagem mantendo todas as alterações de código intactas
• Rewind code to here: reverta as alterações de arquivo para este ponto na conversa mantendo o histórico completo da conversa
• Fork conversation and rewind code: inicie uma nova ramificação de conversa e reverta as alterações de arquivo para este ponto

Para detalhes completos sobre como os checkpoints funcionam e suas limitações, veja Checkpointing.

Executar CLI no VS Code

Para usar o CLI enquanto permanece no VS Code, abra o terminal integrado (Ctrl+` no Windows/Linux ou Cmd+` no Mac) e execute claude. O CLI se integra automaticamente com seu IDE para recursos como visualização de diff e compartilhamento de diagnósticos.

Instalar a extensão não coloca claude no PATH do seu shell. A extensão agrupa uma cópia privada do CLI para seu painel de chat, mas digitar claude em um terminal requer a instalação do CLI autônomo. Execute a instalação uma vez e os comandos nesta página, incluindo claude mcp add e claude --resume, funcionam em qualquer terminal. Se claude ainda não for encontrado após a instalação, verifique seu PATH.

Se estiver usando um terminal externo, execute /ide dentro do Claude Code para conectá-lo ao VS Code.

Alternar entre extensão e CLI

A extensão e o CLI compartilham o mesmo histórico de conversa. Para continuar uma conversa de extensão no CLI, execute claude --resume no terminal. Isso abre um seletor interativo onde você pode pesquisar e selecionar sua conversa.

Incluir saída do terminal em prompts

Referencie a saída do terminal em seus prompts usando @terminal:name onde name é o título do terminal. Isso permite que Claude veja a saída do comando, mensagens de erro ou logs sem copiar e colar.

Monitorar processos em segundo plano

A visibilidade de tarefas em segundo plano na extensão é limitada em comparação com o CLI. Para melhor visibilidade, peça ao Claude para exibir o comando para que você possa executá-lo no terminal integrado do VS Code.

Conectar a ferramentas externas com MCP

MCP (Model Context Protocol) servers dão ao Claude acesso a ferramentas externas, bancos de dados e APIs.

Para gerenciar servidores MCP sem sair do VS Code, digite /mcp no painel de chat. A partir do diálogo que se abre, você pode adicionar servidores, remover servidores salvos no escopo local, de usuário ou de projeto, ativar ou desativar servidores, reconectar a um servidor e gerenciar autenticação OAuth. Adicionar e remover servidores no diálogo requer Claude Code v2.1.261 ou posterior.

Você também pode executar claude mcp add no terminal integrado do VS Code (Ctrl+` ou Cmd+`). O diálogo e o comando do terminal salvam na mesma configuração MCP, e as alterações de qualquer um deles entram em vigor nas conversas que você inicia depois. O exemplo abaixo adiciona o servidor MCP remoto do GitHub, que autentica com um token de acesso pessoal passado como um cabeçalho:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Substitua YOUR_GITHUB_PAT pelo seu token de acesso pessoal. O comando claude mcp add salva a configuração sem validar credenciais, portanto um valor de espaço reservado é aceito aqui, mas o servidor falha ao conectar depois. Para verificar a conexão, inicie uma nova conversa, digite /mcp e verifique se o servidor mostra Connected. Um servidor com credenciais ruins mostra Failed.

Uma vez configurado, peça ao Claude para usar as ferramentas (por exemplo, "Review PR #456").

Para encontrar servidores para conectar, veja Find and build MCP servers.

Trabalhar com git

Claude Code integra-se com git para ajudar com fluxos de trabalho de controle de versão diretamente no VS Code. Peça ao Claude para fazer commit de alterações, criar pull requests ou trabalhar em diferentes branches. Para iniciar Claude em uma worktree isolada com seus próprios arquivos e branch, consulte Executar sessões paralelas com worktrees.

Criar commits e pull requests

Claude pode preparar alterações, escrever mensagens de commit e criar pull requests com base no seu trabalho:

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

Ao criar pull requests, Claude gera descrições com base nas alterações de código reais e pode adicionar contexto sobre decisões de teste ou implementação.

Usar provedores de terceiros

Por padrão, Claude Code se conecta diretamente à API da Anthropic. Se sua organização usa Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry para acessar Claude, configure a extensão para usar seu provedor:

Em um provedor de terceiros, a extensão não oferece recursos que exigem uma conta claude.ai, como rastreamento de uso, ditado por voz e a aba Web para sessões na nuvem. Um login claude.ai deixado de um /login anterior permanece não utilizado: a extensão não o envia com nenhuma solicitação.

Segurança e privacidade

Seu código permanece privado. Claude Code processa seu código para fornecer assistência, mas não o utiliza para treinar modelos. Para detalhes sobre tratamento de dados e como desativar o registro, consulte Data and privacy.

Com permissões de auto-edição ativadas, Claude Code pode modificar arquivos de configuração do VS Code (como settings.json ou tasks.json) que o VS Code pode executar automaticamente. Para reduzir riscos ao trabalhar com código não confiável:

• Ative o VS Code Restricted Mode para espaços de trabalho não confiáveis
• Use o modo Manual em vez de Edit automatically ou Auto para edições
• Revise as alterações cuidadosamente antes de aceitá-las

The built-in IDE MCP server

Quando a extensão está ativa, ela executa um servidor MCP local ao qual a CLI se conecta automaticamente. É assim que a CLI abre diffs no visualizador de diff nativo do VS Code, lê sua seleção atual para menções @ e — quando você está trabalhando em um notebook Jupyter — pede ao VS Code para executar células.

O servidor é nomeado ide e está oculto de /mcp porque não há nada para configurar. Se sua organização usa um hook PreToolUse para criar uma lista de permissões de ferramentas MCP, porém, você precisará saber que ele existe.

Selection and open-file context. Enquanto conectado, a CLI inclui sua seleção atual do editor e o caminho do arquivo ativo como contexto em cada prompt que você envia. A transcrição mostra uma linha ⧉ Selected N lines from <file> quando isso acontece. Para excluir um arquivo sensível como .env, adicione uma regra de negação Read para seu caminho. Uma regra de negação correspondente impede que o texto selecionado e o aviso de arquivo aberto para esse arquivo cheguem a Claude.

Transport and authentication. O servidor se vincula a 127.0.0.1 em uma porta aleatória no intervalo 10000–65535, e a porta não é configurável. O transporte é ws:// não criptografado; como o socket é apenas loopback, qualquer processo que pudesse capturar o tráfego também pode ler o token do arquivo de bloqueio, portanto TLS não adicionaria proteção. Cada ativação de extensão gera um token de autenticação aleatório novo, o escreve em um arquivo de bloqueio em ~/.claude/ide/<port>.lock, e a CLI deve apresentá-lo como o cabeçalho X-Claude-Code-Ide-Authorization para se conectar. O arquivo de bloqueio tem permissões 0600 em um diretório 0700, portanto apenas o usuário que executa o VS Code pode lê-lo. Se CLAUDE_CONFIG_DIR estiver definido, o arquivo de bloqueio será escrito em $CLAUDE_CONFIG_DIR/ide/ em vez disso.

Tools exposed to the model. O servidor hospeda uma dúzia de ferramentas, mas apenas duas são visíveis para o modelo. O resto é RPC interno que a CLI usa para sua própria interface — abrindo diffs, lendo seleções, salvando arquivos — e são filtrados antes da lista de ferramentas chegar a Claude.

Jupyter execution always asks first. mcp__ide__executeCode não pode executar nada silenciosamente. Em cada chamada, o código é inserido como uma nova célula no final do notebook ativo, o VS Code a rola para a visualização, e um Quick Pick nativo pede para você Execute ou Cancel. Cancelar — ou descartar o seletor com Esc — retorna um erro a Claude e nada é executado. A ferramenta também se recusa completamente quando não há um notebook ativo, quando a extensão Jupyter (ms-toolsai.jupyter) não está instalada, ou quando o kernel não é Python.

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

Ícone Spark não visível

O ícone Spark aparece na Editor Toolbar (canto superior direito do editor) quando você tem um arquivo aberto. Se você não o vir:

1. Abra um arquivo: O ícone requer que um arquivo esteja aberto. Apenas ter uma pasta aberta não é suficiente.
2. Verifique a versão do VS Code: Requer 1.94.0 ou superior (Help → About)
3. Reinicie o VS Code: Execute "Developer: Reload Window" na Paleta de Comandos
4. Desabilite extensões conflitantes: Desabilite temporariamente outras extensões de IA (Cline, Continue, etc.)
5. Verifique a confiança do workspace: A extensão não funciona em Modo Restrito

Alternativamente, se você definiu preferredLocation como sidebar, ou abriu Claude com Claude Code: Open in Side Bar, clique em "✱ Claude Code" na Status Bar (canto inferior direito). Isso funciona mesmo sem um arquivo aberto. Você também pode usar a Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P) e digitar "Claude Code".

Cmd+Esc não faz nada no macOS

No macOS Tahoe e posterior, o atalho de teclado do Game Overlay do sistema está vinculado a Cmd+Esc por padrão e intercepta a tecla antes que chegue ao VS Code. Para liberar o atalho:

1. Abra Configurações do Sistema
2. Vá para Keyboard, depois Keyboard Shortcuts, depois Game Controllers
3. Desmarque a caixa de seleção Game Overlay

Alternativamente, reassine a extensão para uma tecla diferente: abra o editor de Keyboard Shortcuts do VS Code (Cmd+K Cmd+S), procure por Claude Code: Focus input, e atribua uma nova vinculação.

Claude Code nunca responde

Se Claude Code não estiver respondendo aos seus prompts:

1. Verifique sua conexão com a internet: Certifique-se de que você tem uma conexão com a internet estável
2. Inicie uma nova conversa: Tente iniciar uma conversa nova para ver se o problema persiste
3. Tente a CLI: Execute claude no terminal para ver se você obtém mensagens de erro mais detalhadas

Se os problemas persistirem, abra uma issue no GitHub com detalhes sobre o erro.

Desinstalar a extensão

Para desinstalar a extensão Claude Code:

1. Abra a visualização de Extensões (Cmd+Shift+X no Mac ou Ctrl+Shift+X no Windows/Linux)
2. Procure por "Claude Code"
3. Clique em Desinstalar

Se você executar claude em um terminal integrado do VS Code, Claude Code reinstala a extensão automaticamente. Para mantê-la desinstalada, desative Auto-install IDE extension em /config, ou defina autoInstallIdeExtension como false. Você também pode definir a variável de ambiente CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL como 1.

Para também remover dados da extensão e redefinir todas as configurações, delete o diretório de armazenamento da extensão para sua plataforma.

No macOS:

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

No Linux:

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

No Windows, no PowerShell:

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

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

Próximos passos

Agora que você tem Claude Code configurado no VS Code:

• Explore fluxos de trabalho comuns para aproveitar ao máximo Claude Code
• Configure servidores MCP para estender os recursos do Claude com ferramentas externas. Adicione e gerencie-os com /mcp no painel de chat.
• Configure as definições do Claude Code para personalizar comandos permitidos, hooks e muito mais. Essas configurações são compartilhadas entre a extensão e CLI.