Claude Code ゲートウェイ互換性ガイド

• API 形式および各形式で提供するエンドポイント
• 接続方法別のクライアント動作：モデル ID、anthropic-beta 値、リクエストフィールド、およびデフォルトが形式と Claude apps ゲートウェイサインイン間でどのように異なるか
• リクエストヘッダー：アップストリームに到達する必要があるもの、およびゲートウェイが使用できるもの
• レスポンスヘッダー：スタール検出、再試行、および使用制限表示が機能するように返すもの
• システムプロンプト属性ブロックおよびプロンプトキャッシングとの相互作用
• 機能パススルー：ヘッダーまたはボディフィールドが削除されると機能しなくなるもの
• モデル検出

• 変更なしで転送：アップストリームにバイト単位で渡す
• 使用：ゲートウェイはルーティング、属性、またはトレース用に読み取ることができ、転送する必要はありません

​

API フォーマット

​

Foundry および AWS 上の Claude Platform

​

オプションエンドポイントとスタートアップトラフィック

• 推論リクエストは /v1/messages?beta=true に POST します
• Google Cloud の Agent Platform メソッドのサフィックスはパブリッシャーモデルパスに付加されます。例えば /projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict

​

ストリーミング

​

アップストリームとのフォーマット不一致

• クライアントが Amazon Bedrock または Google Cloud の Agent Platform フォーマットを使用する場合、Claude Code はそれらのプロバイダーが受け入れる完全な機能セットのサブセットのみを送信します
• クライアントが Anthropic Messages フォーマットを使用する場合、ゲートウェイが Amazon Bedrock または Google Cloud の Agent Platform アップストリームに転送する場合でも、Claude Code は完全なセットを送信します

​

接続方法がクライアント動作にどのように影響するか

• Amazon Bedrock または Agent Platform 形式: 開発者が CLAUDE_CODE_USE_BEDROCK=1 を ANTHROPIC_BEDROCK_BASE_URL と共に設定するか、CLAUDE_CODE_USE_VERTEX=1 を ANTHROPIC_VERTEX_BASE_URL と共に設定して、ゲートウェイを指します。Claude Code はそのプロバイダーのモデル ID、リクエストフィールド、およびデフォルトを使用します。
• Anthropic Messages 形式: 開発者が ANTHROPIC_BASE_URL をゲートウェイに設定します。Claude Code はゲートウェイを Claude API として扱い、どのアップストリームに転送するかを判断できません。
• Claude apps ゲートウェイサインイン: 開発者が Claude apps ゲートウェイ にサインインします。そのゲートウェイは Anthropic Messages 形式で通信しますが、任意のアップストリームにルーティングできるため、Claude Code は Amazon Bedrock と Agent Platform も受け入れる anthropic-beta 値とモデル機能の仮定のみを送信します。

​

接続方法別のリクエストとデフォルト

​

認識されないモデル ID の設定

• コンテキストウィンドウ: Claude Code は 200K を想定し、ID が [1m] を含む場合は 1M を想定します。実際のウィンドウを宣言するには、ゲートウェイまたはカスタムモデル ID のウィンドウを修正する を参照してください
• 機能: ゲートウェイエイリアスに背後にあるモデルの機能を付与するには、配布する設定の modelOverrides エントリを使用して、そのモデルの Anthropic ID をエイリアスにマップします。ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES 変数が適用される場所については、機能パススルー を参照してください

​

リクエストヘッダー

​

ゲートウェイヒントヘッダー

• Anthropic API への直接接続：デフォルトで送信されます
• カスタムベース URL：デフォルトでオフです。不明なヘッダーを拒否するプロキシはリクエストを失敗させるためです。それらを受け取るには、開発者向けに CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 を設定してください。例えば、管理設定の env ブロックで設定できます
• Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、AWS 上の Claude Platform を含む他のバックエンド：CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 が設定されている場合にのみ送信されます

• エントリ：実行されたツール呼び出しごとに 1 つ。その結果が収集された順序で、ミリ秒単位です
• キャップ：Claude Code は最大 32 エントリと 4 KB を送信し、最初のエントリを保持します
• エンコーディング：ツール名はパーセントエンコードされ、%、;、=、カンマ、スペース、および印字可能な ASCII 外の任意の文字をカバーします
• 解析：; で分割し、次に = で分割し、各名前をデコードします
• 不在：コンパクト化呼び出し、サイドリクエスト、および新しいプロンプトの最初のリクエストはそれを含みません。不足しているヘッダーをツールを実行しなかったターンとして読まないでください
• 時間：各エントリは権限プロンプトとフックを除外し、並列ツール呼び出しは各自の時間を報告するため、エントリはリクエスト間のギャップに加算されません

​

オープンリストとして転送

​

レスポンスヘッダー

​

システムプロンプト属性ブロック

• 受け取った system 配列を正確に転送し、ブロックを最初に保つ：別のシステムブロックを前に付加したり、配列を並べ替えたり、単一の文字列に変換したりすると、削除が機能しなくなり、ブロックはモデルとプロンプトキャッシュキーに到達します。
• ブロックを独自の配列エントリに保つ：エンドポイントは属性ヘッダーで始まるマージされたブロックを属性全体として扱い、マージされたすべてのコンテンツ（システムプロンプトの残りを含む）を削除します。
• ゲートウェイがシステムコンテンツを再形成する必要がある場合は、CLAUDE_CODE_ATTRIBUTION_HEADER=0 を設定して Claude Code がブロックを省略するようにしてください。Anthropic とクラウドプロバイダーの Claude エンドポイントは属性用にブロックを読み取るため、ゲートウェイで削除または移動するのではなく、クライアント側で省略してください。

• リクエストは api.anthropic.com に送信され、ANTHROPIC_BASE_URL が設定されていないか、そのホストを指定しており、サードパーティプロバイダーが選択されていません。
• アクティブな認証情報は Anthropic プロファイルまたはフェデレーション認証情報 ではありません。

• リクエストボディをキーとするプロンプトキャッシュを実装します。
• Amazon Bedrock、Microsoft Foundry、Google Cloud の Agent Platform などのサードパーティプロバイダーにリクエストを転送します。Anthropic Messages 形式またはプロバイダー独自の形式で、変更されるプレフィックスはそのプロバイダー上のプロンプトキャッシュ再利用を削減します。

​

機能パススルー

​

自動リトライとエラー転送

• アップストリームが thinking フィールド、会話中のシステムメッセージ、またはそのようなメッセージの cache_control マーカーを拒否する場合、Claude Code はリクエストをリトライし、拒否された機能を会話の残りの部分で無効にします
• アップストリームが思考署名を拒否する場合（bound to a different conversation という 400 を含む）、Claude Code はリクエストを以前の思考ブロックなしでリトライし、それらを後のすべてのリクエストから除外します。新しい応答には依然として思考が含まれます
• ゲートウェイまたはそのアップストリームが advisor ツールエントリを tools で認識されないツールタイプとして拒否する場合、Claude Code はそのエントリとその anthropic-beta 値なしでリクエストを 1 回リトライします。その後のそのベース URL へのリクエストは Claude Code が終了するまで advisor を除外し、その時間は /advisor は開発者に利用不可です。Claude Code はこの拒否を Input tag の後にツールタイプを命名するメッセージを含む 400 または 422 レスポンスによって認識します。例えば Input tag 'advisor_20260301' です。v2.1.280 より前では、Claude Code はこの拒否をリトライしませんでした
• Claude Code はコンテキスト管理またはツールスキーマフィールド拒否をリトライしません。それらの 400 エラーは開発者に到達します

​

プレリリース機能を無効化

• 直接接続、または ANTHROPIC_BASE_URL で設定されたゲートウェイを通じて、Claude Code はツール検索ベータヘッダー、defer_loading ツールフィールド、および tool_reference ブロックを送信し続け、残りをストリップします
• クラウドプロバイダー、または Claude apps ゲートウェイを通じてサインインしている場合、オーバーライドは効果がありません

​

モデル検出

​

検出が実行される場合

• ANTHROPIC_BASE_URL も設定されている場合でも、任意の CLAUDE_CODE_USE_* プロバイダー変数が設定されている
• ANTHROPIC_BASE_URL が設定されていないか、api.anthropic.com を指している

​

リクエストとレスポンス

• Authorization：ANTHROPIC_AUTH_TOKEN をベアラートークンとして、またはそれ以外の場合は apiKeyHelper 値をベアラートークンとして。その場合、Claude Code はリクエストを送信する前にヘルパーが戻るのを待ちます。
• x-api-key：Claude Code が解決した API キー（ANTHROPIC_API_KEY など）。ヘルパー値が唯一のクレデンシャルである場合、このヘッダーもそれを含むため、値は両方のヘッダーに到達します。

{
  "data": [
    {
      "id": "claude-sonnet-4-6",
      "display_name": "Claude Sonnet 4.6",
      "description": "Default model for everyday coding tasks"
    },
    { "id": "claude-opus-4-8" }
  ]
}

​

ピッカーエントリとキャッシング

• 同じ ID：検出された ID は既存の行の ID と正確に一致するか、2 つの ID は同じ Fable バージョンのスペルです。
• 組み込みエイリアスと同じモデル：検出された明示的な ID が組み込みエイリアスが現在解決するモデルに名前を付ける場合、ピッカーはエイリアス行のみを表示します。たとえば、sonnet が claude-sonnet-5 に解決される間、検出された claude-sonnet-5 は sonnet 行に折りたたまれ、検出された claude-sonnet-4-6 は依然として独自の行を取得します。v2.1.197 より前では、Claude Code はこれらの ID を組み込み行に折りたたまなかったため、claude-sonnet-5 も独自の「ゲートウェイから」行を取得しました。

​

関連リソース

• ゲートウェイの概要：ゲートウェイとは何か、および Claude アプリゲートウェイと別の製品の間で選択する方法
• その他の LLM ゲートウェイ：組織が実行するゲートウェイをロールアウトする方法、および claude.ai サブスクリプションとどのように相互作用するか
• 組織用 LLM ゲートウェイのロールアウト：このガイドを使用する管理者チェックリスト
• Claude Code を LLM ゲートウェイに接続：開発者ごとの設定とトラブルシューティング表
• ベータヘッダーリファレンス：現在の anthropic-beta 値のセット
• Messages API：Anthropic フォーマットゲートウェイが実装する API フォーマット