Saltar al contenido principal
Conserva el SDK de Anthropic y la llamada a Messages. Apunta el cliente a https://api.phaseo.app, pasa tu clave de Phaseo como authToken y usa el ID de Phaseo de cada modelo.

Cambia el cliente

Crea una clave en Claves de API y ponla a disposición de la aplicación como PHASEO_API_KEY.
Estos tres detalles son los que más suelen romper este paso:
  • Usa el host raíz. baseURL: "https://api.phaseo.app/v1" genera /v1/v1/messages. Los clientes compatibles con OpenAI del mismo repositorio siguen usando /v1.
  • Envía la clave como token bearer. El gateway solo lee Authorization: Bearer; un encabezado x-api-key recibe 401 missing_or_invalid_authorization_header. authToken envía Bearer en todas las versiones del SDK. apiKey solo lo hace a partir de @anthropic-ai/sdk 1.0 y anthropic 2.0.
  • Elimina ANTHROPIC_API_KEY de los entornos que ahora llaman a Phaseo. apiKey: null impide que los SDK de TypeScript antiguos la lean, y los SDK de Python anteriores a 0.98 la leen aunque se haya definido auth_token.
Las herramientas que se configuran con variables de entorno, como Claude Code, usan ANTHROPIC_BASE_URL=https://api.phaseo.app, ANTHROPIC_AUTH_TOKEN con la clave de Phaseo y ANTHROPIC_API_KEY vacía.

Asigna los ID de modelos

Comprueba cada modelo de producción con data[].id de GET /v1/models?format=openai. Los ID de Phaseo usan puntos en la versión: claude-sonnet-5-5 pasa a ser anthropic/claude-sonnet-5.5. Si también cambias de modelo, lee su guía de migración de modelos.

Qué funciona de otra forma

Prueba y despliega

Prueba los prompts de sistema, el streaming, el uso de herramientas, el razonamiento y la salida estructurada con los ID de modelo exactos que usa la aplicación. Después compara un conjunto representativo de prompts en ambas configuraciones: estructura de la salida, latencia, uso de tokens, errores y coste. Antes de mover tráfico, comprueba que:
  • la clave de Phaseo está definida en todos los entornos de despliegue;
  • cada ID de modelo de producción está en GET /v1/models?format=openai;
  • los flujos de streaming y de uso de herramientas funcionan en staging;
  • cada encabezado anthropic-beta y cada campo exclusivo de betas se ha eliminado o sustituido;
  • la reversión sigue siendo solo un cambio de URL base y clave.
Última modificación el 7 de noviembre de 2026