Configuração avançada

Práticas recomendadas

Siga as práticas recomendadas do BetterToken para proteger sua API Key, escolher modelos, controlar custos, tratar erros e configurar ferramentas externas.

Proteja sua API Key

Use variáveis de ambiente — nunca fixe a chave no código. Gravar a API Key diretamente no código-fonte ou em arquivos de configuração pode expô-la acidentalmente no controle de versão. Abordagem recomendada:

# Add to ~/.zshrc or ~/.bashrc so it loads automatically each session
export BETTERTOKEN_API_KEY="your-api-key-here"

No Claude Code, gerencie segredos pelo campo env do settings.json, em vez de expô-los na configuração do shell:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here"
  }
}

Troque sua API Key periodicamente. Se houver suspeita de exposição, exclua a chave imediatamente no painel e gere outra.

Defina um tempo limite amplo

As respostas dos modelos podem demorar, principalmente em tarefas de raciocínio complexo. Defina um tempo limite alto o bastante para evitar desconexões prematuras:

{
  "env": {
    "API_TIMEOUT_MS": "3000000"
  }
}

3000000 ms = 50 minutos. Esse valor é adequado para raciocínio profundo ou tarefas prolongadas com agentes.

Remova variáveis de ambiente conflitantes

Se você já usou as APIs oficiais da Anthropic ou OpenAI — ou outro serviço de relay —, variáveis antigas podem substituir a configuração da BetterToken e enviar solicitações silenciosamente ao endpoint errado.

Antes de configurar a BetterToken, verifique e remova estas variáveis:

# Check if they exist
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

# Clear them
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Claude Code: verifique primeiro o provedor

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.

Não misture as duas configurações; as solicitações podem ser roteadas ao modelo errado.

Desative o tráfego não essencial. Definir CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 reduz as solicitações em segundo plano do Claude Code e preserva sua cota para tarefas reais de programação.

Não adicione /v1 ao Claude Code. ANTHROPIC_BASE_URL deve ser https://bettertoken.ai.

Use uma API Key em várias ferramentas

A mesma API Key funciona no Claude Code, Codex e em ferramentas externas. A cota é compartilhada, o que simplifica o gerenciamento centralizado.

No entanto, o endpoint deve corresponder ao protocolo:

Claude Code / ANTHROPIC_BASE_URL: https://bettertoken.ai
Codex / OPENAI_BASE_URL / ferramentas externas: https://bettertoken.ai/v1

Se precisar acompanhar o uso separadamente por projeto ou equipe, crie várias API Keys no painel e atribua uma a cada ferramenta ou projeto.

Copie o Model ID exato da model plaza.

Lista de solução de problemas

Confirme a API Key — verifique-a no painel e cole-a com cuidado, sem espaços adicionais
Confirme o endpoint do protocolo — o Claude Code usa https://bettertoken.ai; Codex e ferramentas externas usam https://bettertoken.ai/v1
Procure variáveis conflitantes — execute echo $ANTHROPIC_AUTH_TOKEN, echo $OPENAI_BASE_URL e comandos relacionados
Consulte os requisitos oficiais da ferramenta — em ferramentas externas, verifique primeiro Base URL, API Key, ID de modelo e versão; adicione cabeçalhos apenas quando a documentação oficial ou o gateway upstream exigir
Confira o saldo — as solicitações são rejeitadas quando o saldo termina
Entre em contato com o suporte — se as etapas anteriores não resolverem o problema