Usar sua chave no Claude Code

Instale a CLI, aponte o ANTHROPIC_BASE_URL para o OLETOKEN e escolha um modelo — além da extensão para VS Code e da solução de problemas.

O Claude Code é o agente de programação da Anthropic (CLI mais a extensão para VS Code) e fala o protocolo Anthropic Messages. Aponte-o para o OLETOKEN e ele usa sua chave e sua cota de modelos do OLETOKEN — sem precisar de conta na Anthropic.

Antes de começar

Você já criou uma chave de API e guardou a chave completa.
Você escolheu um ID de modelo Claude na vitrine de modelos (por exemplo claude-sonnet-5).
Node.js e npm estão instalados.

Configuração

A configuração fica no bloco env de ~/.claude/settings.json. A CLI e a extensão para VS Code compartilham esse arquivo, então configurar uma vez atende às duas — e é mais confiável do que exportar no shell, porque o VS Code nem sempre herda o ambiente do seu shell:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<your-base-url>",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

Variável	Significado
`ANTHROPIC_BASE_URL`	Somente o host, sem `/v1` — a CLI acrescenta `/v1/messages` por conta própria, e incluí-lo retorna 404
`ANTHROPIC_AUTH_TOKEN`	Sua chave do OLETOKEN, enviada como `Authorization: Bearer`
`ANTHROPIC_MODEL`	ID do modelo padrão
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Modelo usado em tarefas leves (geração de título etc.); apontá-lo para o mesmo modelo evita 404 quando o gateway não tem um modelo haiku

Instale e inicie:

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

A janela Início rápido na página de chaves de API oferece o download do mesmo script de configuração já preenchido com sua chave, seu modelo e sua Base URL.

Variáveis de ambiente também funcionam

Se você preferir não mexer no settings.json, exporte as mesmas variáveis no perfil do shell (normalmente ~/.zshrc no macOS e ~/.bashrc no Linux) e reabra o terminal:

export ANTHROPIC_BASE_URL="https://<your-base-url>"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

Quando os dois estão definidos, o bloco env de ~/.claude/settings.json tem precedência.

Solução de problemas

Sintoma	Causa e solução
401	Chave errada ou desativada; garanta que é uma chave do OLETOKEN e que está em `ANTHROPIC_AUTH_TOKEN`
404	O `ANTHROPIC_BASE_URL` inclui `/v1` (ou um caminho maior) — mantenha apenas o host
Model not found	O `ANTHROPIC_MODEL` não é um modelo listado neste site; copie o ID da vitrine de modelos
Saldo insuficiente	Adicione créditos primeiro
Trocar de modelo em tempo real	Execute `/model` dentro da sessão

Dê a cada caso de uso sua própria chave (uma para a CLI, uma para o editor) com limite de gastos, para que um vazamento custe no máximo esse valor.