Como configurar ANTHROPIC_BASE_URL e API Key no Claude Code

Quais são os dois valores necessários

O Claude Code usa o protocolo da Anthropic. Por isso, seu endereço é diferente do usado pelo Codex e por outros clientes OpenAI-compatible, que normalmente precisam de `https://www.bettertoken.ai/v1%60.?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka

Passo 1. Remova variáveis conflitantes

Antes de configurar, confira se ainda existem valores antigos no ambiente:

printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"

Não exiba o token em si. Se as variáveis estiverem definidas no shell atual e a configuração do arquivo precisar ter prioridade, remova-as:

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN

Depois, verifique ~/.zshrc, ~/.bashrc, .env, as configurações da IDE e o gerenciador de providers. Uma variável herdada por um processo que já está em execução pode continuar valendo mesmo depois da alteração do arquivo.

Passo 2. Adicione a configuração do usuário

Segundo a referência oficial de configurações do Claude Code, as configurações do usuário ficam em ~/.claude/settings.json, as do projeto em .claude/settings.json e as configurações locais do projeto em .claude/settings.local.json.

Para a BetterToken, adicione:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai/?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

Substitua apenas YOUR_API_KEY. Se o arquivo já tiver permissions, hooks, plugins ou outros campos, não sobrescreva tudo: adicione ou combine o objeto env, mantendo um JSON válido.

Restrinja o acesso ao arquivo e confirme que as permissões foram aplicadas:

chmod 600 ~/.claude/settings.json
ls -l ~/.claude/settings.json

Na saída, não deve haver permissão de leitura ou gravação para o grupo nem para outros usuários. Não anexe o arquivo inteiro a uma issue. Em configurações de equipe, não publique um token de trabalho compartilhado; cada pessoa deve usar sua própria chave.

Passo 3. Reinicie o Claude Code por completo

Encerre totalmente o processo atual e execute claude novamente. Abrir uma nova aba do terminal sem reiniciar o Claude Code que já estava rodando não basta: o processo conserva o ambiente recebido na inicialização.

Se você usa a extensão do VS Code, ela tem um ponto de configuração separado: claudeCode.environmentVariables, no settings.json do VS Code. Não presuma que o shell do terminal e a Extension sempre leem o mesmo conjunto de variáveis.

Passo 4. Teste a conexão com uma tarefa pequena

Inicie o Claude Code em uma pasta de teste e envie este prompt seguro:

Responda em uma única linha: CLAUDE_PROVIDER_OK. Não altere arquivos nem execute comandos.

Antes de enviar a solicitação, anote o horário atual. A configuração está funcionando se:

• a resposta chegar sem 401, 403, ConnectionRefused ou model not found;
• aparecer no Workspace da BetterToken um novo registro com horário posterior ao início do teste;
• esse registro mostrar o modelo esperado, o status e o consumo;
• o Claude Code não voltar ao provider antigo depois da reinicialização.

Uma resposta bem-sucedida, por si só, não comprova a rota: em caso de conflito, o Claude Code pode ter usado outro provider. A confirmação é o novo registro da solicitação de teste no Workspace. Abra o repositório de trabalho somente depois de confirmar que há um novo registro no Workspace com horário posterior ao início do teste.

Como localizar um conflito de configuração

Não presuma uma ordem universal de prioridade: a configuração efetiva depende da forma de inicialização, das políticas gerenciadas e do ambiente já herdado pelo processo. Primeiro, localize todas as fontes em que os nomes necessários estão definidos:

printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
grep -lE '"ANTHROPIC_(BASE_URL|AUTH_TOKEN)"' \
  ~/.claude/settings.json \
  .claude/settings.json \
  .claude/settings.local.json 2>/dev/null

O comando mostra apenas os nomes dos arquivos, não o valor do token. Verifique também as configurações gerenciadas da organização, a extensão do VS Code e qualquer gerenciador externo de providers que participe da inicialização. Depois, altere uma fonte por vez, reinicie completamente o cliente e repita a pequena solicitação, confirmando o novo registro no Workspace.

Erros comuns

ConnectionRefused ou conexão com o endpoint errado

Confira o endereço literalmente: https://bettertoken.ai, sem /v1, sem /messages e sem espaço no final. O próprio cliente acrescenta o caminho necessário.

401 ou authentication failure

Se houver suspeita de vazamento, crie uma nova chave, copie-a sem espaços e confirme que a variável usada é ANTHROPIC_AUTH_TOKEN, não uma variável de outro cliente. Não envie o token ao suporte em texto simples.

As alterações não foram aplicadas

Feche todos os processos do Claude Code, confira valores antigos com printenv e inicie o cliente novamente. No VS Code, execute Reload Window ou reinicie a Extension.

model not found

Não use um Model ID aleatório copiado de um artigo antigo. Para chaves e modelos que exigem mapping explícito, obtenha o Model ID atual em Setup ou no guia atual de configuração do Claude Code.

Checklist rápida

• A Base URL do Claude Code não contém /v1.
• A chave real não está no Git nem em uma captura de tela.
• Todas as fontes de configurações antigas foram localizadas e verificadas uma a uma.
• O cliente foi reiniciado por completo.
• A pequena solicitação read-only aparece no Workspace.

Se os cinco itens estiverem corretos, prossiga para a tarefa real. Caso contrário, abra o passo a passo de configuração do Claude Code, escolha seu cliente e confira os campos um por um, em vez de substituir toda a configuração de uma vez.