Claude Code

Como configurar a API Key e a Base URL no Claude Code

Conecte o Claude Code com sua BetterToken API Key, a Base URL BetterToken e o Model ID escolhido.

Resposta rápida

Ao configurar uma API de terceiros no Claude Code, primeiro confirme se o endpoint é compatível com Anthropic. Nesta documentação, o Claude Code usa https://bettertoken.ai. Não adicione /v1.

A API Key autentica a requisição. A Base URL informa ao Claude Code para onde enviar as requisições ao modelo. Ambas devem pertencer ao mesmo provedor e protocolo.

Se você procura acesso geral à Claude API, consulte a página Claude API da BetterToken. Essa página comercial atende à intenção de acesso à API; esta FAQ explica especificamente como usar API Key e Base URL no Claude Code.

Conecte o Claude Code com sua BetterToken API Key, a Base URL https://bettertoken.ai e o Model ID escolhido. Copie o Model ID exato da model plaza.

Quando isso é importante

Você quer que o Claude Code use um API gateway personalizado
Você tem uma API Key, mas não sabe qual Base URL usar
O Claude Code informa um erro de autenticação ou endpoint
Você está escolhendo entre https://bettertoken.ai e https://bettertoken.ai/v1

Conceitos principais

Campo	Significado
API Key	Credencial para requisições à API do modelo
Base URL	Endereço da API para onde as requisições são enviadas
API compatível com Anthropic	Endpoint que segue as convenções de requisição da Anthropic ou do Claude
API compatível com OpenAI	Endpoint que segue as convenções da OpenAI, usado com frequência por Codex, Cursor e Cline
Model ID	Nome do modelo ou valor de mapeamento solicitado pela ferramenta

Configuração recomendada

Conecte o Claude Code com sua BetterToken API Key, a Base URL https://bettertoken.ai e o Model ID escolhido.

Copie o Model ID exato da model plaza.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

Substitua YOUR_MODEL_ID pelo ID copiado. ANTHROPIC_MODEL define o modelo principal e as três variáveis ANTHROPIC_DEFAULT_*_MODEL definem os aliases Haiku, Sonnet e Opus. Use o mesmo modelo ou um diferente para cada função.

Atualize o Model ID na configuração e reinicie o Claude Code. Para trocar durante a sessão, use /model YOUR_MODEL_ID.

Erros comuns

Adicionar /v1 à Base URL do Claude Code.
Alterar a API Key, mas manter as requisições direcionadas ao endpoint padrão.
Inserir um endpoint compatível com OpenAI nos campos compatíveis com Anthropic do Claude Code.
Definir variáveis de ambiente antigas em um perfil de shell que substituem a nova configuração.

Sobre o BetterToken

O BetterToken oferece dois tipos de endpoint: https://bettertoken.ai, compatível com Anthropic para o Claude Code, e https://bettertoken.ai/v1, compatível com OpenAI para o Codex e outras ferramentas externas.

Você pode gerenciar API Keys, saldo e histórico de uso em um único painel, mas o Claude Code continua exigindo requisições no formato compatível com Anthropic.