Source: https://aiprimetech.io/pt/claude-code/vscode/ [Início](/pt/) › [Claude Code](/pt/claude-code/) › VS Code [Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/) Última atualização: 11 de outubro de 2026 # Claude Code no VS Code: a extensão, o uso pelo terminal e os erros Há duas maneiras de usar o Claude Code dentro do VS Code, e a maioria dos problemas que as pessoas pesquisam surge da confusão entre elas: a extensão oficial, que adiciona um painel e diffs no próprio editor, e a CLI diretamente no terminal integrado do VS Code, que é o mesmo agente sem nenhuma extensão envolvida. Esta página aborda ambas, além da verificação da conta e das mensagens de erro. ## TLDR - Extensão: instale anthropic.claude-code pelo Marketplace (ou abra vscode:extension/anthropic.claude-code); ela instala a CLI para você na primeira execução. - Terminal: abra o terminal do VS Code e execute claude — funciona em todas as versões do VS Code, incluindo o Cursor, sem extensão. - Qual conta: /status em uma sessão mostra o endpoint, a chave e o login em uso; a extensão e o terminal leem o mesmo ambiente. - command 'claude-vscode.editor.openlast' not found = a extensão está instalada, mas não foi ativada, ou a CLI que ela utiliza está ausente — recarregue a janela e verifique claude --version. ## Instalar a extensão Claude Code para VS Code Pesquise por Claude Code da Anthropic na visualização Extensões, ou cole vscode:extension/anthropic.claude-code no navegador para abri-la diretamente. A extensão é uma interface para a CLI: na primeira execução, ela verifica se o executável claude está disponível e o instala se estiver ausente (Node.js 18+ é necessário para a instalação via npm; o instalador nativo não exige nada). Depois disso, o ícone do Claude na barra de atividades abre um painel onde você conversa, e cada alteração feita pelo agente aparece como um diff no próprio editor que você aceita ou rejeita — o mesmo ciclo do terminal, com o editor como interface de revisão. ``` # check the CLI the extension will use claude --version # if it is missing, install it yourself and reload VS Code npm install -g @anthropic-ai/claude-code # or: curl -fsSL https://claude.ai/install.sh | bash ``` ## Ou dispense a extensão: Claude Code no terminal integrado Abra o terminal do VS Code e execute claude. Este é o agente completo — modo de planejamento, subagentes, hooks, MCP, /compact — e funciona em qualquer derivação do VS Code, incluindo Cursor e VSCodium, sem a extensão. As edições aparecem imediatamente nos arquivos abertos, e a visualização de diff do próprio VS Code as mostra. Para tarefas autônomas longas, a maioria das pessoas prefere essa opção; para pequenas edições interativas, o painel da extensão é mais conveniente. Ambos podem ser executados ao mesmo tempo. ## Verificar qual conta o Claude Code está usando no VS Code Tanto a extensão quanto o terminal leem a mesma configuração, então a resposta é a mesma em ambos: execute /status dentro de uma sessão. Ele exibe o endpoint (ANTHROPIC_BASE_URL), se uma chave de API ou uma assinatura /login está ativa, o modelo e a versão. Se uma chave de API estiver definida no ambiente, ela tem prioridade sobre o login, o que costuma explicar a situação "Entrei com o Max, mas a cobrança é descontada do meu saldo de API". Para alternar, remova ANTHROPIC_API_KEY do ambiente para usar a assinatura, ou defina essa variável (com ANTHROPIC_BASE_URL para um gateway) para uso cobrado por consumo. ``` # use this gateway from VS Code: put these in your shell profile, restart VS Code export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_gateway_key ``` O VS Code herda as variáveis de ambiente do shell que o iniciou. Se /status ainda mostrar o endpoint antigo depois de você alterar seu perfil, feche o VS Code completamente e inicie-o a partir de um novo terminal — recarregar a janela não basta. ## Erro: comando 'claude-vscode.editor.openlast' não encontrado Isso aparece quando um atalho de teclado ou a paleta de comandos chama a extensão antes de ela ser ativada, ou quando a extensão foi ativada, mas não conseguiu encontrar a CLI que utiliza. Nesta ordem: 1) Recarregue a janela (Developer: Reload Window) — a maioria dos casos se resolve aqui. 2) Execute claude --version no terminal; se não for encontrado, instale a CLI (acima) e recarregue novamente. 3) Verifique se a extensão está habilitada para este espaço de trabalho, e não apenas instalada. 4) Se você usa uma derivação do VS Code, confirme se a versão da extensão oferece suporte a ela — caso contrário, a opção pelo terminal funciona de qualquer maneira. 5) Como último recurso, desinstale a extensão, exclua ~/.claude/ os caches somente se aceitar perder o histórico local de sessões e reinstale. ## Outros problemas da extensão - O painel abre, mas fica vazio → a CLI está sendo iniciada; verifique o painel Saída (Claude Code) para ver o erro real, geralmente uma versão antiga do Node.js. - Os diffs nunca aparecem no editor → o espaço de trabalho não é confiável; o VS Code bloqueia extensões no Modo Restrito. - Funciona no terminal, mas não no painel → um proxy ou ANTHROPIC_BASE_URL definido apenas no perfil do shell, e não no ambiente a partir do qual o VS Code foi iniciado. - 401 / chave inválida → a chave não corresponde ao endpoint; uma URL de gateway exige uma chave de gateway, e a URL da Anthropic exige uma chave do console. ## Custo dentro do VS Code A extensão cobra exatamente como a CLI — por token, por meio do serviço usado por ela. Neste gateway, são créditos a 7.69231× o valor nominal ($13 compra $100 de uso, com 87% de desconto) ou um plano ilimitado de preço fixo a partir de $1; o guia de preços traz os detalhes, e o guia de modelos lista o que /model pode selecionar. | Plano | Duração | Preço | Ilimitado por 1 hora | 1 hora | $1 | Ilimitado por 24 horas | 24 horas | $10 | Ilimitado por 1 semana | 1 semana | $49 | Ilimitado por 15 dias | 15 dias | $89 [Todos os planos ilimitados →](/pt/plans/) ## Experimente gratuitamente primeiro Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE) ## Perguntas frequentes Existe uma extensão Claude Code para VS Code? Sim — a extensão oficial `anthropic.claude-code` da Anthropic no Marketplace. Ela oferece uma interface para a CLI com um painel e diffs no próprio editor; a CLI também funciona de forma independente no terminal do VS Code.Como verifico qual conta o Claude Code usa no VS Code? Execute /status em uma sessão. Ele mostra o endpoint, se uma chave de API ou um login de assinatura está ativo e o modelo. Uma chave de API no ambiente tem prioridade sobre /login.Como corrijo 'claude-vscode.editor.openlast' não encontrado? Recarregue a janela do VS Code; se o problema persistir, verifique se `claude --version` funciona no terminal (instale a CLI se não funcionar) e se a extensão está habilitada para o espaço de trabalho.O Claude Code funciona no Cursor ou no VSCodium? No terminal integrado, sempre. A extensão funciona quando está disponível no marketplace da derivação. ## Execute o Claude Code no gateway Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/) A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway. ## Mais guias do Claude Code [Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)