環境変数

CLAUDE_CODE_GATEWAY_HINT_HEADERS

1 に設定すると、カスタムプロキシや Amazon Bedrock、AWS 上の Claude Platform などのサードパーティプロバイダーに対して、x-claude-code-request-class や x-claude-code-compaction といったゲートウェイヒントヘッダーを送信します。0 に設定すると、Claude Code が既定で送信する Anthropic API への直接接続を含むすべての接続で、これらのヘッダーの送信を停止します。Claude Code v2.1.273 以降が必要です。

使い方・用途

  • Claude Code がリクエスト種別・コンパクション状態などを示すゲートウェイヒントヘッダー(x-claude-code-request-class、x-claude-code-compaction など)の送信を制御する環境変数で、LLM ゲートウェイ側のルーティング・キャッシュ・使用量の属性付けに役立つ詳細な文脈を渡せる
  • Anthropic API への直接接続では既定で送信されるが、カスタム base URL や Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、AWS 上の Claude Platform などでは既定でオフ(未知のヘッダーを拒否するプロキシでリクエストが失敗するため)。受け取りたい場合は開発者向けに =1 を設定する(例: 管理設定の env ブロック)
  • =0 にすると Anthropic API 直接接続を含む全接続でヘッダー送信を停止できる。ゲートウェイがヒントヘッダーを読む場合に設定する。要 v2.1.273 以降
英語原文(公式ドキュメントより)

Set to 1 to send the gateway hint headers, such as x-claude-code-request-class and x-claude-code-compaction, on a custom proxy or a third-party provider such as Amazon Bedrock or Claude Platform on AWS. Set to 0 to stop sending them on every connection, including a direct connection to the Anthropic API, where Claude Code sends them by default. Requires Claude Code v2.1.273 or later

関連ドキュメント

関連する変更履歴

v2.1.283(1件)

Added
LLM ゲートウェイが 1 つのユーザープロンプトに対応するリクエストをグループ化できるよう、gateway ヒントヘッダーに x-claude-code-prompt-id を追加した。CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 で有効化できる
英語原文を表示
Added x-claude-code-prompt-id to the gateway hint headers so LLM gateways can group the requests that serve one user prompt; opt in with CLAUDE_CODE_GATEWAY_HINT_HEADERS=1

変更後

同一のユーザープロンプトから生まれた複数のリクエスト(サブエージェントのターンを含む)をゲットウェイ側で一つのグループとして識別できるようになり、プロンプト単位でのルーティングやキャッシュ、使用量の集計がしやすくなる。ゲットウェイがヒントヘッダーを解釈する運用では、環境変数 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 を設定するだけで有効化できる。

関連ドキュメント

v2.1.273(1件)

Added
LLM ゲートウェイ向けに x-claude-code-request-class、x-claude-code-agent-type、x-claude-code-prev-tool-durations、x-claude-code-compaction、x-claude-code-context-compacted のリクエストヘッダーを追加する。CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 で有効化できる
英語原文を表示
Added x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction and x-claude-code-context-compacted request headers for LLM gateways; opt in with CLAUDE_CODE_GATEWAY_HINT_HEADERS=1

変更後

LLM ゲートウェイ運用者がリクエストの種類やサブエージェントの種別、圧縮状況などのルーティングヒントを受け取れるようになり、リクエストの振り分け・キャッシュ制御・集計を柔軟に行える。

関連ドキュメント