APIs do Claude Code e Codex: protocolo, configuração e primeiro teste

O rótulo “OpenAI-compatible” não torna uma configuração válida para os dois clientes. O Claude Code espera o contrato Anthropic Messages; um provider customizado do Codex usa OpenAI Responses. Antes de comparar preço, confira a documentação do cliente, a Base URL, o campo de autenticação e o Model ID atual.

Para testar o BetterToken, comece pelo guia do Claude Code ou pelo guia do Codex. Os caminhos são separados por protocolo e a API Key é criada na sua própria conta. Depois de uma chamada curta, o Dashboard mostra status, modelo, tokens de input/output/cache e cobrança.

Dois contratos de cliente

Cliente	O que precisa ser confirmado	Valor BetterToken a verificar
Claude Code	Acesso Anthropic-compatible Messages e variáveis documentadas	https://bettertoken.ai; o Claude Code acrescenta /v1/messages
Codex CLI/App	Provider customizado com Responses, não apenas Chat Completions	https://www.bettertoken.ai/v1 com wire_api = "responses"

O guia atual do Claude Code usa ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN. Não acrescente /v1, pois o cliente monta o caminho Messages. O Codex lê o provider em ~/.codex/config.toml e a chave em BETTERTOKEN_API_KEY.

A referência de configuração do Codex da OpenAI e a documentação do Claude Code são as fontes primárias dos clientes. Os valores específicos do provider precisam ser conferidos na documentação atual dele.

Configuração mínima

model_provider = "custom"
model = "YOUR_MODEL_ID"

[model_providers.custom]
base_url = "https://www.bettertoken.ai/v1"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false

YOUR_MODEL_ID é propositalmente um marcador. Disponibilidade e IDs mudam; copie um ID completo e atual do catálogo ou da tela de configuração. Uma chave de provider customizado não deve ir para ~/.codex/auth.json.

No Claude Code, valide estas variáveis:

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

Arquivo e campos opcionais são definidos pelo guia atual. Não exponha API Keys em prompts, issues, imagens ou repositórios.

Teste antes da carga real

1. Abra o guia atual da versão exata do cliente.
2. Crie uma chave de teste sua, não uma conta compartilhada.
3. Copie Base URL e Model ID atuais da documentação ou do Dashboard.
4. No Claude Code, confirme rota e variáveis; no Codex, provider, variável de ambiente e wire_api = "responses".
5. Use um repositório vazio, sem segredos de produção.
6. Envie uma tarefa pequena e limitada.
7. Registre status, modelo, tokens, tentativas visíveis e cobrança final; depois repita uma tarefa representativa idêntica.

Custo e erros da primeira chamada

Preço de token de input não é o custo de uma tarefa de agente. Contexto, resultados de ferramentas, cache, tentativas e tamanho da resposta mudam a conta. Para cada candidato, registre Model ID, tokens input/output/cache, quantidade de chamadas, erros, tentativas e valor final. Use a página de preços atual do BetterToken; números antigos são apenas históricos.

Sintoma	Verifique primeiro
401	Chave, nome do campo e espaços acidentais
404 / falha de conexão	Base URL do protocolo correto, não um caminho HTTP completo
model not found	Model ID completo e atual do mesmo provider e grupo de chaves
Erro de modo no Codex	wire_api = "responses", não somente Chat Completions
429	Limite do endpoint, Retry-After e segurança da nova tentativa
Streaming interrompido	Suporte de streaming, rede e status da chamada
Cobrança pouco clara	Modelo, registros de tokens e tentativas

Mude um parâmetro por vez. Isso torna possível identificar se a causa é URL, chave, modelo ou configuração.

Decida pelo teste registrado

Este roteiro não classifica velocidade, estabilidade ou menor preço. Ele valida dois contratos de cliente. Consulte a documentação no dia do teste e decida após a mesma tarefa de repositório, usando resultado, erros, tokens e cobrança final.

Abra o guia BetterToken de Claude Code ou Codex, crie uma chave separada e confira a primeira chamada no Dashboard antes de levar trabalho para produção.