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

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

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

​

API フォーマット

​

Foundry と Claude Platform on AWS

​

任意のエンドポイントと起動時のトラフィック

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

​

ストリーミング

• ゲートウェイが応答を完了するまでバッファリングすると、Claude Code は停止してしまいます。
• Claude Code は、各応答のイベントシーケンス全体が、最後の message_delta および message_stop イベントまで順序どおりに届くことを前提としています。コンテンツブロックが開始された後、その最後の message_delta より前にボディが正常に終了した場合、Claude Code はその応答を接続の切断として扱います。その場合にユーザーに何が表示されるかは The response above may be incomplete で、Claude Code が代わりにリクエストを再発行する条件は自動再試行で説明しています。
• Amazon Bedrock のガードレールが応答をブロックした場合、Bedrock が送信するイベントは、すでに content_block_stop が到着したコンテンツブロックを参照することがあり、Claude Code はそれらを送信されたとおりに受信することを前提としています。その応答がどのように終了するかは AWS Guardrails で説明しています。
• Claude Code は、ストリーミングのアイドルタイムアウトを超えて 1 バイトも届かない状態が続くと、ストリーミング応答を中止します。長い思考の一時停止中は、アップストリームの SSE ping イベントがストリーム上の唯一のバイトになることがあるため、それらを除去またはバッファリングするゲートウェイは、応答の途中でこのタイムアウトを発生させる可能性があります。Amazon Bedrock のバイナリイベントストリームのように ping を送信しないアップストリームから変換するゲートウェイも、独自の ping イベントを送出しない限り、同じ空白が生じます。
• Amazon Bedrock InvokeModel フォーマットでは、Claude Code は /model/{model}/invoke-with-response-stream のレスポンスを、Bedrock が返すバイナリの application/vnd.amazon.eventstream ボディとして読み取ります。そのため、ゲートウェイがそれを Server-Sent Events に変換したり、その Content-Type ヘッダーを書き換えたりすると、解析できなくなります。その場合にユーザーに何が表示されるかはゲートウェイまたはプロキシの背後でのストリーミングエラーで説明しています。

​

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

• クライアントが Amazon Bedrock または Google Cloud’s Agent Platform のフォーマットを使用する場合、Claude Code は全機能セットのうち、それらのプロバイダーが受け付けるサブセットのみを送信します
• クライアントが Anthropic Messages フォーマットを使用する場合、ゲートウェイが Amazon Bedrock または Google Cloud’s 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.type の値 enabled または adaptive がサポートされていないと 400 が示す場合、Claude Code はもう一方のタイプで 1 回再試行し、thinking フィールドは維持します。そのモデルへの以降のリクエストは、Claude Code が終了するまで切り替え後のタイプを使い続けます。v2.1.121 より前では、Claude Code は再試行しなかったため、thinking.type.enabled is not supported が開発者に届いていました
• アップストリームが messages 内の role: "system" エントリを拒否した場合、Claude Code はそれらの会話中のシステムメッセージを除いて 1 回再試行し、そのテキストを代わりにユーザーメッセージに含めます。会話内の以降のリクエストは、開発者が /clear を実行するか会話が圧縮されるまでその形式を維持します
• アップストリームが会話中のシステムメッセージの cache_control マーカーのみを拒否した場合、Claude Code はシステムメッセージを維持し、マーカーを移動して 1 回再試行します。その再試行と、Claude Code が終了するまでの以降のリクエストでは、マーカーは messages 内でシステムメッセージではない最後のエントリに付けられます
• アップストリームが思考署名を拒否する場合（bound to a different conversation という 400 を含む）、Claude Code はリクエストを以前の思考ブロックなしでリトライし、それらを後のすべてのリクエストから除外します。新しい応答には依然として思考が含まれます
• ゲートウェイまたはそのアップストリームが advisor ツールエントリを tools で認識されないツールタイプとして拒否する場合、Claude Code はそのエントリとその anthropic-beta 値なしでリクエストを 1 回リトライします。以降のリクエストではそれらが省略されます。Claude Code はこの拒否を Input tag の後にツールタイプを命名するメッセージを含む 400 または 422 レスポンスによって認識します。例えば Input tag 'advisor_20260301' です。v2.1.280 より前では、Claude Code はこの拒否をリトライしませんでした
• アップストリームが output_config.effort またはその anthropic-beta 値を拒否する場合、ゲートウェイにはそれらを除いたリクエストがもう一度届きます。以降のリクエストではそれらが省略されます。ゲートウェイがアップストリームの 400 を変更せずに転送し、メッセージが次のいずれかに該当する場合、ゲートウェイ側の変更は不要です：
  • Extra inputs are not permitted とともに output_config.effort を挙げている
  • モデルが努力パラメーターをサポートしていないと述べている
  • Unexpected value(s) で始まり、anthropic-beta ヘッダーについて effort-2025-11-24 を挙げている。v2.1.310 以降が必要です。ANTHROPIC_BETAS にこの値を含めている開発者は引き続きそれを送信して 400 を受け取るため、そのエントリを削除してもらってください
• アップストリームが context_management フィールドまたはその anthropic-beta 値を拒否する場合、ゲートウェイにはそれらを除いたリクエストがもう一度届きます。以降のリクエストではそれらが省略されます。Claude Code はこの拒否をメッセージによって認識します。たとえば context_management: Extra inputs are not permitted を含むメッセージです。v2.1.304 より前では、Claude Code はこの拒否を再試行しませんでした
• 400 が別の anthropic-beta 値を名前で拒否した場合、その値が再試行の対象であれば、ゲートウェイにはその値を除いたリクエストがもう一度届きます
• アップストリームが strict など defer_loading 以外のベータツールフィールドを拒否する場合、400 は開発者に届きます。その前に、ゲートウェイにはツール検索フィールドを除いたリクエストが再び届くことがあります。このようなフィールドの送信を停止するには、開発者に CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を設定してもらってください

​

拒否されたベータ値なしでの再試行

• API の文：anthropic-beta ヘッダーについてその値を挙げる Unexpected value(s) の文
• beta_header: トークン：capability_rejected: beta_header: の後に値が続くもの。capability_rejected: トークンの一種です

• advisor やツール検索など、独自の再試行を持つ値：ゲートウェイには代わりにその機能独自の再試行が届きます
• Claude Code が認識しない値：開発者が ANTHROPIC_BETAS で設定した値は各リクエストに残るため、その開発者のリクエストは 400 で失敗し続けます。開発者にそのエントリを削除してもらってください
• 値を伴わない invalid beta flag：Claude Code はアップストリームがどの値を拒否したかを推測します。推測対象となる値がリクエストに含まれていた場合、ゲートウェイにはその値を除いたリクエストが再び届きます。それでも 400 が開発者に届く場合は、ゲートウェイが拒否された値を上記いずれかの形式で挙げるようにしてください

​

拒否されたベータ値が除外される期間

​

ツール検索なしでの再試行

​

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

• コンテキスト管理とその context_management ボディフィールド
• strict や defer_loading などのベータツールスキーマフィールド。標準の name、description、input_schema、cache_control ツールフィールドは残ります
• 構造化出力の output_config.format フィールド。Claude Code v2.1.287 以降が必要です
• output_config.task_budget フィールド
• MCP ツール検索。このため、組織が管理設定を通じて有効に保たない限り、すべての MCP ツールが事前に読み込まれます

• 拡張コンテキスト、インターリーブ思考、および努力の anthropic-beta 値（クラウドプロバイダーもこれらを受け入れます）
• 最上位の output_config.effort フィールド。これを拒否するアップストリームについては、自動リトライとエラー転送を参照してください
• 適応的推論の thinking フィールド（ベータヘッダーはありません）
• 会話中のシステムメッセージを運ぶ role: "system" エントリ
• サブスクリプション認証に必要な OAuth の anthropic-beta 値
• 開発者が ANTHROPIC_BETAS または CLAUDE_CODE_EXTRA_BODY を通じて自分で追加したヘッダー値とボディフィールド

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

​

モデル検出

​

検出が実行される場合

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

​

リクエストとレスポンス

• Authorization：ANTHROPIC_AUTH_TOKEN をベアラートークンとして、またはそれ以外の場合は apiKeyHelper 値をベアラートークンとして。
• 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-5 に解決される間、検出された claude-sonnet-5-5 は sonnet 行に折りたたまれ、検出された claude-sonnet-5 は依然として独自の行を取得します。

​

関連リソース

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