Use Claude Code in VS Code

​

Pré-requisitos

• VS Code 1.98.0 ou superior
• Uma conta Anthropic (você fará login quando abrir a extensão pela primeira vez). Se você estiver usando um provedor de terceiros como Amazon Bedrock ou Google Vertex AI, consulte Use third-party providers em vez disso.

​

Instale a extensão

• Instalar para VS Code
• Instalar para Cursor

​

Comece

1

Abra o painel Claude Code

Em todo o VS Code, o ícone Spark indica Claude Code: A forma mais rápida de abrir Claude é clicar no ícone Spark na Editor Toolbar (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 como uma aba de editor completa, 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: 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 do VS Code. Consulte Customize your workflow 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 não aparecer, recarregue a janela na Paleta de Comandos com Developer: Reload Window.Se você tem ANTHROPIC_API_KEY definida no seu shell mas ainda vê o prompt de login, VS Code pode não ter herdado seu ambiente de shell. Inicie VS Code de um terminal com code . para que ele herde suas variáveis de ambiente, ou faça login com sua conta Claude em vez disso.Depois que você faz 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 ao Claude para ajudar com seu código ou arquivos, seja explicando como algo funciona, depurando um problema ou fazendo alterações.

Claude vê automaticamente seu texto selecionado. Pressione Option+K (Mac) / Alt+K (Windows/Linux) para também inserir uma referência @-mention (como @file.ts#5-10) em seu prompt.

Aqui está um exemplo de pergunta sobre uma linha específica em um arquivo:

4

Revise as alterações

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

​

Use a caixa de prompt

• Permission modes: clique no indicador de modo na parte inferior da caixa de prompt para alternar modos. No modo normal, Claude pede permissão antes de cada ação. Em Plan Mode, Claude descreve o que fará e aguarda aprovação antes de fazer alterações. VS Code abre automaticamente o plano como um documento markdown completo onde você pode adicionar comentários inline para fornecer feedback antes de Claude começar. Em modo auto-accept, Claude faz edições sem perguntar. Defina o padrão nas configurações do VS Code em claudeCode.initialPermissionMode.
• Command menu: clique em / ou digite / para abrir o menu de comandos. As opções incluem anexar arquivos, alternar modelos, alternar pensamento estendido, visualizar uso de plano (/usage) e iniciar uma sessão de Remote Control (/remote-control). A seção Customize fornece acesso a MCP servers, hooks, memory, permissions e plugins. Itens com um ícone de terminal abrem no terminal integrado.
• Context indicator: a caixa de prompt mostra quanto da context window do Claude você está usando. Claude compacta automaticamente quando necessário, ou você pode executar /compact manualmente.
• Extended thinking: permite que Claude gaste mais tempo raciocinando sobre problemas complexos. Alterne-o via menu de comandos (/). O raciocínio do Claude aparece na conversa como blocos recolhidos: clique em um bloco para lê-lo, ou pressione Ctrl+O para expandir ou recolher cada bloco de pensamento na sessão. Consulte Extended thinking para detalhes.
• Multi-line input: pressione Shift+Enter para adicionar uma nova linha sem enviar. Isso também funciona na entrada de texto livre “Other” de diálogos de pergunta.

​

Reference files and folders

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

​

Resume past conversations

​

Resume remote sessions from Claude.ai

​

Customize your workflow

​

Choose where Claude lives

• Secondary sidebar: o lado direito da janela. Mantém Claude visível enquanto você codifica.
• Primary sidebar: a barra lateral esquerda com ícones para Explorer, Search, etc.
• Editor area: abre Claude como uma aba ao lado de seus arquivos. Útil para tarefas secundárias.

​

Run multiple conversations

​

Switch to terminal mode

​

Manage plugins

​

Install plugins

• Installed plugins aparecem no topo com switches de alternância para habilitá-los ou desabilitá-los
• Available plugins de seus marketplaces configurados aparecem abaixo
• Pesquise para filtrar plugins por nome ou descrição
• Clique em Install em qualquer plugin disponível

• Install for you: disponível em todos os seus projetos (escopo de usuário)
• Install for this project: compartilhado com colaboradores do projeto (escopo de projeto)
• Install locally: apenas para você, apenas neste repositório (escopo local)

​

Manage marketplaces

• 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

​

Automate browser tasks with Chrome

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

​

Comandos e atalhos de teclado do VS Code

​

Inicie uma aba VS Code a partir de outras ferramentas

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"

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

​

Configurar configurações

• Extension settings no VS Code: controlam o comportamento da extensão dentro do VS Code. Abra com Cmd+, (Mac) ou Ctrl+, (Windows/Linux), depois vá para Extensions → Claude Code. Você também pode digitar / e selecionar General Config para abrir as configurações.
• Claude Code settings em ~/.claude/settings.json: compartilhadas entre a extensão e CLI. Use para comandos permitidos, variáveis de ambiente, hooks e MCP servers. Consulte Settings para detalhes.

​

Extension settings

​

VS Code extension vs. Claude Code CLI

​

Rewind with checkpoints

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

​

Run CLI in VS Code

​

Switch between extension and CLI

​

Include terminal output in prompts

​

Monitor background processes

​

Connect to external tools with MCP

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

​

Trabalhar com git

​

Criar commits e pull requests

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

​

Usar git worktrees para tarefas paralelas

claude --worktree feature-auth

​

Use third-party providers

​

Segurança e privacidade

• Habilite VS Code Restricted Mode para espaços de trabalho não confiáveis
• Use modo de aprovação manual em vez de auto-accept para edições
• Revise as alterações cuidadosamente antes de aceitá-las

​

The built-in IDE MCP server

​

Corrigir problemas comuns

​

Extension won’t install

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

​

Spark icon not visible

1. Open a file: O ícone requer um arquivo aberto. Ter apenas uma pasta aberta não é suficiente.
2. Check VS Code version: Requer 1.98.0 ou superior (Help → About)
3. Restart VS Code: Execute “Developer: Reload Window” na Paleta de Comandos
4. Disable conflicting extensions: Desabilite temporariamente outras extensões de IA (Cline, Continue, etc.)
5. Check workspace trust: A extensão não funciona em Restricted Mode

​

Cmd+Esc does nothing on macOS

1. Abra System Settings
2. Vá para Keyboard, depois Keyboard Shortcuts, depois Game Controllers
3. Desmarque a caixa de seleção Game Overlay

​

Claude Code never responds

1. Check your internet connection: Certifique-se de que você tem uma conexão de internet estável
2. Start a new conversation: Tente iniciar uma nova conversa para ver se o problema persiste
3. Try the CLI: Execute claude do terminal para ver se você obtém mensagens de erro mais detalhadas

​

Uninstall the extension

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

rm -rf ~/.vscode/globalStorage/anthropic.claude-code

​

Next steps

• Explore common workflows para aproveitar ao máximo Claude Code
• Set up MCP servers para estender as capacidades do Claude com ferramentas externas. Adicione servidores usando a CLI, depois gerencie-os com /mcp no painel de chat.
• Configure Claude Code settings para personalizar comandos permitidos, hooks e muito mais. Essas configurações são compartilhadas entre a extensão e CLI.