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

​

Resposta rápida

​

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://www.bettertoken.ai e https://www.bettertoken.ai/v1
• Você precisa entender os provedores Claude e GPT

​

Conceitos principais

​

Configuração recomendada

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "<YOUR_API_KEY>"
  }
}

​

Erros comuns

• Adicionar /v1 à Base URL do Claude Code.
• Alterar a API Key, mas manter as requisições direcionadas ao endpoint padrão.
• Tratar o Model ID de um provedor GPT como um modelo do provedor Claude.
• 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

​

Documentação relacionada

• Guia de configuração do Claude Code
• O Claude Code usa uma conta Claude.ai ou uma API Key?
• API compatível com OpenAI ou API compatível com Anthropic
• Por que o Claude Code usa tantos tokens e como reduzir o custo

​

Referências

• Configuração de LLM gateway do Claude Code
• Autenticação do Claude Code
• Configuração de modelos do Claude Code
• Guia de configuração do Claude Code