Claude Code no VS Code: a extensão, o uso pelo terminal e os erros

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.

Todos os planos ilimitados →

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

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.