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 revisar uma edição proposta uma alteração por vez, use os botões Accept this change e Reject this change sob cada alteração no diff. Rejeitar uma alteração a reverte no conteúdo proposto; aceitar a marca como revisada. Aceitar ou rejeitar o arquivo inteiro ainda finaliza a revisão. Um diff com mais de 100 alterações abre sem os botões por alteração, então revise-o como um arquivo inteiro. A revisão por alteração requer Claude Code v2.1.275 ou posterior.

As mesmas ações estão disponíveis no cursor a partir do menu de contexto do editor e da Command Palette como Claude Code: Accept Change at Cursor e Claude Code: Reject Change at Cursor.

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.

    You can also type /plan in the prompt box. Requires Claude Code v2.1.280 or later.

    • /plan: switches to plan mode. If you're already in plan mode, shows the current plan instead.
    • /plan with a task, such as /plan fix the auth bug: switches to plan mode and starts planning that task.
    • /plan open: when you're already in plan mode, opens the plan file in the editor.

  • 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. When you pick a level other than max, Claude Code saves it for the current model as your default, under modelSettings in your user settings; max applies to the current session only. 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 includes entries such as MCP servers, commands, output styles, hooks, memory, instructions, 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.

    Typing /skills also opens this dialog. Each skill row shows its visibility, such as On or Name only. Click the visibility to change it, except on rows marked locked, such as plugin skills. The /skills shortcut and the visibility controls require Claude Code v2.1.280 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.

  • Select Hooks in the Customize section to view the hooks loaded in the session, grouped by event. You can add, edit, or remove hooks saved in your user, project, and local settings files. Hooks from other sources, such as managed settings or plugins, are read-only. Requires Claude Code v2.1.269 or later.

  • Select Permissions in the Customize section to view the session's permission rules, grouped into Allow, Ask, and Deny. You can add rules to your user, project, or local settings and remove rules saved there. Rules from other sources, such as managed settings or approvals made for this session only, are read-only. Requires Claude Code v2.1.269 or later.

  • Select Memory in the Customize section to turn auto memory on or off. While it's on, you can also browse the memories Claude has saved and reveal the folders that store them in your file manager. Requires Claude Code v2.1.274 or later.

    Click a saved memory to read it in the dialog, where you can edit the text, delete the memory, or open its file in the editor. Viewing, editing, and deleting a memory in the dialog require Claude Code v2.1.275 or later.

  • Select Instructions in the Customize section to edit the CLAUDE.md files Claude reads. Pick a file to open it in the editor. If the file doesn't exist yet, Claude Code creates it first. Requires Claude Code v2.1.274 or later.

  • Select Status in the Customize section, or type /status, to check the session's Claude Code version, account, model, and MCP server details. Requires Claude Code v2.1.280 or later.

  • Select Sandbox in the Customize section, or type /sandbox, to see whether Claude's Bash commands run sandboxed. You can switch the sandbox mode and add excluded commands there. Requires Claude Code v2.1.280 or later.

  • Select Claude in Chrome in the Customize section, or type /chrome, to check and manage the Claude in Chrome connection. Both require signing in with a claude.ai account. Requires Claude Code v2.1.280 or later.

  • Select Export conversation in the Context section, or type /export, to copy the conversation as plain text or save it to a file. Add a file name, such as /export notes.txt, to skip the dialog and choose where to save the file. Requires Claude Code v2.1.280 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. 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.

    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. While Claude runs subagents, live progress rows with their latest activity appear under the tool-call group that started them. This requires Claude Code v2.1.269 or later.

  • To sign out of your Anthropic account, select Sign out in the Settings section, or type /logout. On a third-party provider, the menu doesn't offer either. Requires Claude Code v2.1.277 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.

    If your organization's policy turns product feedback off, Report a problem doesn't appear in the menu, and /bug and /feedback show a Feedback is turned off by your organization's policy or this environment's settings. notice instead of opening the report.

• 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.

• Copy a response: hover over a response and click Copy response to copy it to your clipboard, or type /copy to copy the latest response. /copy 2 copies the second-to-last. Requires Claude Code v2.1.277 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.

• Prompt cache clock: a clock icon next to the context indicator estimates how much time the conversation's prompt cache has left before it expires. It counts down from the cache's five-minute or one-hour lifetime, and each response that uses the cache restarts the countdown. Apart from compaction, the actions that invalidate the cache don't reset the clock, so it can still show minutes left after you switch models.

  • Until the countdown runs out, the icon shows the minutes left, such as 12m.
  • When the countdown runs out, the minutes disappear and the icon turns red, or your theme's error color, until the next response. The cache has likely expired, so expect a slower, more expensive response to your next message while the cache rebuilds. If the five-minute lifetime keeps running out between your messages, see Choose the TTL yourself.
  • Right after the conversation is compacted, the icon also turns red without minutes until the next response, because the cache doesn't cover the compacted conversation yet.

• Agent map: when the conversation includes subagents, an agent count such as 2 agents appears at the bottom of the prompt box. Its dot shows whether any subagent is working or waiting for your permission.

  Click the agent count to open the agent map, which draws the conversation's subagents as a tree under the main agent, each with its status, elapsed time, and token count. Click a subagent to see its prompt and tool calls, open its read-only transcript, or stop it while it runs. Requires Claude Code v2.1.269 or later.

  The map also lists the session's other background tasks, such as background shell commands and monitors, below the agents. Click a row to open the task's card and stop it there.

  To open the map when no agent count is showing, such as when Claude has started a background shell but no subagents, type /tasks in the prompt box. Background tasks in the map and the typed /tasks require Claude Code v2.1.277 or later.

• 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 X on the selection indicator to remove it so Claude doesn't receive the selection. The indicator comes back when you select other text.

The extension withholds selected text from some files. When the file is inside your workspace and matches your files.exclude or search.exclude settings, Claude receives at most the file's path and not the text you selected. The same applies to a file git ignores, as long as VS Code's search.useIgnoreFiles setting and the extension's respectGitIgnore setting are both on, which is the default. This filter covers the chat panel only: when Claude Code runs in the integrated terminal, the CLI sends your selected text whatever the file, so add a Read deny rule to keep a file's contents from Claude there.

Claude also sees which file you have open in the editor, even when nothing is selected, and the prompt box shows its name. To add only your selected text, turn off the Attach Open File setting. The setting requires Claude Code v2.1.271 or later.

You can also attach images and files to your message:

• To attach an image, paste it from your clipboard into the prompt box.
• To attach files, hold Shift while dragging them into the prompt box.
• To remove an attachment from context, click the X on it.

Paste text

Text you paste stays visible in the prompt box, rather than collapsing to a placeholder as it does in the terminal. In sessions where Claude Code marks pasted text, Claude still sees a large paste as text you pasted rather than typed.

Claude Code also removes invisible Unicode characters from text you paste into the prompt box and from anything else you send:

• If a notice such as Removed 3 invisible characters from the pasted text appears when you paste, the text went in without those characters.
• If a notice about removed characters appears when you send, nothing was sent. The cleaned text is back in the prompt box. Send again to send the text as shown.

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. To restore every archived session at once, hover over the Archived sessions header in the sessions list in the Activity Bar and click its unarchive icon, which requires Claude Code v2.1.277 or later. 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 run cloud sessions, you can resume them 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. It shows your signed-in account, and the usage it reports differs by sign-in:

• claude.ai plan: 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.

  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.

• Other sign-ins: when plan limits don't apply to your sign-in, such as on a third-party provider or with an API key, the Usage section shows the session's own cost and token usage instead. The CLI's /usage shows the same totals in its Session block. The sessions list in the Activity Bar also shows the active session's totals under its Account & usage header. Requires Claude Code v2.1.277 or later.

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.

Quando Claude abre uma aba em um novo grupo de editor, a extensão bloqueia esse grupo, então os arquivos que você abre enquanto a aba Claude está em foco vão para outro grupo em vez de ficar ao lado dela.

Para impedir que a extensão bloqueie grupos, desative a configuração Lock Editor Groups. Os grupos que já estão bloqueados permanecem bloqueados até que você os desbloqueie. A configuração requer Claude Code v2.1.274 ou posterior.

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.

Se o recarregamento interrompeu Claude no meio de uma etapa, Claude continua essa etapa quando a conversa volta, e um aviso no chat marca a continuação. Requer Claude Code v2.1.274 ou posterior. Se a etapa foi interrompida há mais de uma hora ou a sessão está aberta em outro lugar, a conversa volta inativa em vez disso.

Para desativar a continuação, abra a configuração Continue After Reload e desmarque-a.

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, 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:

Alguns valores que a aba Marketplaces aceita não funcionam em um link, como um caminho local ou um endereço http://. Para esses, VS Code mostra uma mensagem de erro e o diálogo não abre.

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.

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.

Use the chat panel from the keyboard

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.

Within a turn, your screen reader announces whose message you're on as you move through it:

• Your messages: "You"
• Claude's messages: "Claude"
• Tool steps: "Claude" plus the tool name, such as "Claude, Bash"
• Thinking blocks: "Claude, thinking"

Because the extension exposes the transcript as a labeled region, you can also move focus to the transcript itself with Tab and read it at your own pace. To move focus to the newest message or a waiting permission prompt instead, run Claude Code: Focus last message from the Command Palette.

When an option on a permission prompt saves a permission rule or directory access, its label ends by naming where the approval is saved, such as "all projects" or "this session". With that option focused, press the Left or Right arrow key to change the destination, and the extension announces each destination as you move to it. You can also click the destination in the label. The arrow keys require Claude Code v2.1.268 or later.

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

Digite /tasks na caixa de prompt para abrir o mapa de agente, que lista as tarefas em segundo plano da sessão, como um servidor de desenvolvimento que Claude deixou em execução como um comando de shell em segundo plano. Clique em uma tarefa para abrir seu cartão e interrompê-la lá. Requer Claude Code v2.1.277 ou posterior.

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 barras de uso do plano, ditado por voz e a aba Web para sessões na nuvem. Para o que a caixa de diálogo Conta e uso mostra nestes logins, consulte Verificar conta e uso.

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.

Se você desativar a configuração Attach Open File, a CLI receberá o caminho do arquivo ativo apenas enquanto você tiver texto selecionado nele.

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 do sistema Game Overlay está vinculado a Cmd+Esc por padrão e intercepta a tecla antes que ela chegue ao VS Code. Para liberar o atalho:

1. Abra System Settings
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 está 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.