Pular para o conteúdo principal
Mantenha o SDK da Anthropic e a chamada Messages. Aponte o cliente para https://api.phaseo.app, passe sua chave do Phaseo como authToken e dê a cada modelo o ID dele no Phaseo.

Troque o cliente

Crie uma chave em Chaves de API e disponibilize-a para o app como PHASEO_API_KEY.
Três detalhes quebram esta etapa com mais frequência:
  • Use o host raiz. baseURL: "https://api.phaseo.app/v1" gera /v1/v1/messages. Clientes compatíveis com OpenAI no mesmo repositório continuam usando /v1.
  • Envie a chave como bearer token. O gateway lê apenas Authorization: Bearer; um cabeçalho x-api-key recebe 401 missing_or_invalid_authorization_header. authToken envia Bearer em todas as versões do SDK. apiKey só faz isso a partir do @anthropic-ai/sdk 1.0 e do anthropic 2.0.
  • Remova ANTHROPIC_API_KEY dos ambientes que agora chamam o Phaseo. apiKey: null impede que SDKs TypeScript mais antigos a leiam, e SDKs Python anteriores à 0.98 a leem mesmo quando auth_token está definido.
Ferramentas configuradas por variáveis de ambiente, como o Claude Code, usam ANTHROPIC_BASE_URL=https://api.phaseo.app, ANTHROPIC_AUTH_TOKEN definido com a chave do Phaseo e ANTHROPIC_API_KEY vazio.

Mapeie os IDs de modelo

Confira cada modelo de produção em data[].id de GET /v1/models?format=openai. Os IDs do Phaseo usam pontos na versão: claude-sonnet-5-5 vira anthropic/claude-sonnet-5.5. Se o modelo também estiver mudando, leia o guia de migração de modelos correspondente.

O que funciona de forma diferente

Teste e faça o rollout

Teste prompts de sistema, streaming, uso de ferramentas, thinking e saída estruturada com os IDs de modelo exatos que o app usa. Depois compare um conjunto representativo de prompts nas duas configurações quanto ao formato da saída, latência, uso de tokens, erros e custo. Antes de mover o tráfego, confirme que:
  • a chave do Phaseo está definida em todos os ambientes de implantação;
  • cada ID de modelo de produção está em GET /v1/models?format=openai;
  • os fluxos de streaming e de uso de ferramentas passam em staging;
  • cada cabeçalho anthropic-beta e campo exclusivo de beta foi removido ou substituído;
  • o rollback ainda é só uma troca de URL base e chave.
Última modificação em 7 de novembro de 2026