Zum Hauptinhalt springen
Behalte das Anthropic-SDK und den Messages-Aufruf. Richte den Client auf https://api.phaseo.app aus, übergib deinen Phaseo-Schlüssel als authToken und gib jedem Modell seine Phaseo-ID.

Client umstellen

Erstelle einen Schlüssel unter API-Schlüssel und stelle ihn der App als PHASEO_API_KEY bereit.
Drei Details lassen diesen Schritt am häufigsten scheitern:
  • Verwende den Root-Host. baseURL: "https://api.phaseo.app/v1" ergibt /v1/v1/messages. OpenAI-kompatible Clients im selben Repository verwenden weiterhin /v1.
  • Sende den Schlüssel als Bearer-Token. Das Gateway liest nur Authorization: Bearer; ein x-api-key-Header erhält 401 missing_or_invalid_authorization_header. authToken sendet in jeder SDK-Version Bearer. apiKey tut das erst ab @anthropic-ai/sdk 1.0 und anthropic 2.0.
  • Entferne ANTHROPIC_API_KEY aus Umgebungen, die jetzt Phaseo aufrufen. apiKey: null verhindert, dass ältere TypeScript-SDKs ihn lesen, und Python-SDKs vor 0.98 lesen ihn selbst dann, wenn auth_token gesetzt ist.
Tools, die über Umgebungsvariablen konfiguriert werden, etwa Claude Code, verwenden ANTHROPIC_BASE_URL=https://api.phaseo.app, ANTHROPIC_AUTH_TOKEN mit dem Phaseo-Schlüssel und ein leeres ANTHROPIC_API_KEY.

Modell-IDs zuordnen

Prüfe jedes Produktionsmodell gegen data[].id aus GET /v1/models?format=openai. Phaseo-IDs verwenden Punkte in der Version: Aus claude-sonnet-5-5 wird anthropic/claude-sonnet-5.5. Wenn sich auch das Modell ändert, lies die passende Anleitung zur Modellmigration.

Was anders funktioniert

Testen und umstellen

Teste System-Prompts, Streaming, Tool-Nutzung, Thinking und strukturierte Ausgaben mit genau den Modell-IDs, die die App verwendet. Vergleiche dann einen repräsentativen Prompt-Satz in beiden Konfigurationen hinsichtlich Ausgabeform, Latenz, Tokennutzung, Fehlern und Kosten. Bevor du Traffic verschiebst:
  • der Phaseo-Schlüssel ist in jeder Deployment-Umgebung gesetzt;
  • jede Produktions-Modell-ID steht in GET /v1/models?format=openai;
  • Streaming- und Tool-Abläufe bestehen in Staging;
  • jeder anthropic-beta-Header und jedes reine Beta-Feld wurde entfernt oder ersetzt;
  • das Zurückrollen ist weiterhin nur eine Änderung von Basis-URL und Schlüssel.
Zuletzt geändert am 7. November 2026