https://api.phaseo.app にし、Phaseo キーを authToken として渡し、各モデルに Phaseo の ID を指定します。
クライアントを切り替える
APIキーでキーを作成し、アプリからPHASEO_API_KEY として使えるようにします。
- ルートホストを使います。
baseURL: "https://api.phaseo.app/v1"にすると/v1/v1/messagesになります。同じリポジトリ内の OpenAI 互換クライアントは引き続き/v1を使います。 - キーを Bearer トークンとして送ります。 Gateway が読むのは
Authorization: Bearerのみで、x-api-keyヘッダーには401missing_or_invalid_authorization_headerが返ります。authTokenはどの SDK バージョンでも Bearer を送ります。apiKeyが Bearer を送るのは@anthropic-ai/sdk1.0 以降とanthropic2.0 以降のみです。 ANTHROPIC_API_KEYを削除します。 Phaseo を呼び出すようになった環境から取り除いてください。apiKey: nullを指定すると古い TypeScript SDK はこれを読まなくなりますが、0.98 より前の Python SDK はauth_tokenを設定していても読み込みます。
ANTHROPIC_BASE_URL=https://api.phaseo.app、Phaseo キーを設定した ANTHROPIC_AUTH_TOKEN、空の ANTHROPIC_API_KEY を使います。
モデル ID を対応付ける
本番で使うすべてのモデルを、GET /v1/models?format=openai の data[].id と照合します。Phaseo の ID ではバージョンにドットを使います。claude-sonnet-5-5 は anthropic/claude-sonnet-5.5 になります。モデルも変更する場合は、そのモデルのモデル移行ガイドを読んでください。
動作が異なる点
テストして展開する
アプリが使うモデル ID そのもので、システムプロンプト、ストリーミング、ツール使用、思考、構造化出力をテストします。次に、代表的なプロンプトセットを両方の構成で実行し、出力の形式、レイテンシー、トークン使用量、エラー、コストを比較します。トラフィックを移す前に、次を確認してください。- すべてのデプロイ環境に Phaseo キーが設定されている
- 本番のすべてのモデル ID が
GET /v1/models?format=openaiにある - ステージングでストリーミングとツール使用のフローが通る
- 各
anthropic-betaヘッダーとベータ専用フィールドが削除または置き換えられている - 切り戻しが引き続きベース URL とキーの変更だけで済む