Claude Code no VS Code: instalar, apontar a chave e o que muda

O Claude Code não é uma extensão do VS Code — é um programa de terminal que se integra ao editor. Essa confusão é a causa da maior parte das instalações que não terminam.

São três passos: instalar pelo terminal, abrir dentro do VS Code, e apontar para a chave que você vai usar. O terceiro é o único que muda dependendo de onde você comprou o acesso.

1. Instalar

Precisa do Node.js 18 ou mais novo. No terminal:

npm install -g @anthropic-ai/claude-code

Confirme que entrou:

claude --version

Se o comando não for encontrado, o diretório global do npm não está no PATH. npm config get prefix mostra onde ele instalou; a pasta bin de dentro dele é a que precisa estar no PATH.

2. Abrir dentro do VS Code

Abra o terminal integrado do VS Code (Ctrl+`) na pasta do seu projeto e rode claude. É isso — não há painel para instalar nem ícone na barra lateral.

A integração real é outra: rodando de dentro do terminal do editor, o Claude Code enxerga a pasta aberta, lê os arquivos do projeto e aplica as alterações no lugar. O editor mostra as mudanças como qualquer edição externa.

Existe também uma extensão oficial na marketplace. Ela adiciona atalho e integração de diff — mas ela não substitui a instalação pelo npm, ela chama o mesmo programa. Instalar só a extensão não funciona.

3. Apontar a chave

Por padrão o Claude Code pede login na conta da Anthropic e cobra em dólar. Para apontar para outra chave, são duas variáveis de ambiente:

export ANTHROPIC_BASE_URL="https://api.codejato.tn1.top"
export ANTHROPIC_AUTH_TOKEN="sua-chave"

Duas armadilhas que aparecem no nosso registro de acessos:

• Não repita o /v1 no fim da URL. O Claude Code acrescenta o caminho sozinho. Terminar a base em /v1 gera requisições para /v1/v1/messages. No nosso caso o servidor tolera e responde, mas nem todo serviço tolera.
• ANTHROPIC_AUTH_TOKEN, não ANTHROPIC_API_KEY. A segunda existe e é usada em outro fluxo; trocar uma pela outra devolve erro de autenticação sem explicar por quê.

Para não repetir o export a cada terminal novo, coloque as duas linhas no fim do ~/.bashrc ou ~/.zshrc. No Windows, o caminho é o WSL — o Claude Code roda em Linux.

O que o tráfego real mostra sobre essa configuração

Este é o dado que faz esta página existir: em 9 dias, 177.889 chamadas de 203 chaves diferentes passaram pelo nosso gateway. Separando por formato de requisição — que é, na prática, por família de ferramenta:

Quatro em cada cinco chamadas usam o formato da Anthropic. Se você está configurando uma ferramenta e não sabe qual endereço-base usar, a probabilidade está do lado desse.

Um detalhe que só aparece quando se olha por chave, e não por chamada: 168 das 203 chaves (82,8%) usam um formato só. Vinte e oito usam dois, sete usam três. Ou seja, quatro em cada cinco pessoas configuram uma ferramenta e ficam nela — o que torna o passo 3 desta página o único que a maioria vai fazer uma vez na vida.

Conferir que pegou

Dentro do Claude Code, /status mostra para onde ele está apontando. Se a URL-base aparecer vazia ou com o endereço da Anthropic, as variáveis não chegaram ao processo — o caso mais comum é ter feito o export num terminal e aberto o Claude Code em outro.

Quanto custa

A instalação é gratuita; o que se paga é o modelo por trás. No CodeJato a mensalidade é fixa em reais e não há cobrança por token. Ver os planos.

Se você ainda não sabe quanto consome, o guia de consumo de tokens traz a medição por tipo de tarefa.