メインコンテンツへスキップ
Anthropic SDK と Messages の呼び出しはそのまま使います。クライアントの接続先を https://api.phaseo.app にし、Phaseo キーを authToken として渡し、各モデルに Phaseo の ID を指定します。

クライアントを切り替える

APIキーでキーを作成し、アプリから PHASEO_API_KEY として使えるようにします。
この手順でつまずきやすいのは次の 3 点です。
  • ルートホストを使います。 baseURL: "https://api.phaseo.app/v1" にすると /v1/v1/messages になります。同じリポジトリ内の OpenAI 互換クライアントは引き続き /v1 を使います。
  • キーを Bearer トークンとして送ります。 Gateway が読むのは Authorization: Bearer のみで、x-api-key ヘッダーには 401 missing_or_invalid_authorization_header が返ります。authToken はどの SDK バージョンでも Bearer を送ります。apiKey が Bearer を送るのは @anthropic-ai/sdk 1.0 以降と anthropic 2.0 以降のみです。
  • ANTHROPIC_API_KEY を削除します。 Phaseo を呼び出すようになった環境から取り除いてください。apiKey: null を指定すると古い TypeScript SDK はこれを読まなくなりますが、0.98 より前の Python SDK は auth_token を設定していても読み込みます。
Claude Code のように環境変数で設定するツールでは、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 とキーの変更だけで済む
最終更新日 2026年11月7日