Skip to main content

Resposta rápida

Uma API compatível com OpenAI e uma API compatível com Anthropic são duas camadas de compatibilidade diferentes. Ambas podem ser usadas para enviar requisições a modelos, mas os formatos, campos, a semântica das ferramentas e as expectativas dos clientes são diferentes. Codex CLI, Cursor, Cline, OpenCode e OpenClaw normalmente usam endpoints compatíveis com OpenAI. Claude Code e algumas rotas do Claude Desktop Gateway usam endpoints compatíveis com Anthropic. Não escolha apenas pelo nome do modelo. Primeiro identifique o protocolo esperado pela ferramenta. Depois use a Base URL, a API Key e o Model ID correspondentes.

Quando isso é importante

  • Você vê duas Base URL e não sabe qual usar
  • Claude Code funciona, mas Codex ou Cursor apresenta falha
  • Codex funciona, mas Claude Code informa erros de endpoint ou autenticação
  • Você quer usar uma API Key em várias ferramentas
  • Você está configurando um API gateway, um roteador de modelos ou um proxy local

Conceitos principais

Escolha recomendada

Comece pela ferramenta: Se uma ferramenta espera APIs no formato OpenAI, não use a Base URL da Anthropic para Claude Code. Se ela espera APIs no formato Anthropic, não use o endpoint /v1 compatível com OpenAI.

Erros comuns

  • Supor que o mesmo nome de modelo pode ser usado sem alterações em todos os protocolos.
  • Inserir a Base URL compatível com OpenAI no Claude Code.
  • Inserir a Base URL compatível com Anthropic no Codex, Cursor ou Cline.
  • Tratar uma assinatura do Claude.ai ou ChatGPT como uma API Key.
  • Alterar apenas a API Key e deixar a Base URL e o Model ID incompatíveis.

Sobre o BetterToken

O BetterToken oferece padrões de acesso compatíveis com Anthropic e OpenAI. Você pode gerenciar API Keys, saldo e histórico de uso em um único painel, mas cada cliente ainda precisa usar o protocolo ao qual oferece suporte. Regra simples: Claude Code usa compatibilidade com Anthropic; Codex, Cursor, Cline, OpenCode e OpenClaw normalmente usam compatibilidade com OpenAI.

Documentação relacionada

Referências