CLAUDE_CODE_GATEWAY_HINT_HEADERS

変更前

Gateway hint headers には、リクエストの種類（メイン会話・サブエージェント・圧縮・補助など）やエージェントの種別を示すヘッダーはあったが、それらがどのユーザープロンプトに起因するものかを識別する情報はなかった。そのため、1つのユーザープロンプトから派生した複数のリクエストをゲートウェイ側で紐付けることができなかった。

変更後

Gateway hint headers に x-claude-code-prompt-id が加わった。これにより、1つのユーザープロンプトを処理するために発生した複数のリクエスト（メイン会話のターン、サブエージェントのターン、圧縮、セッションタイトルなどの補助リクエスト）を、同一のプロンプトIDでグループ化できるようになった。このヘッダーは、既存のヒントヘッダーと同様に CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 を設定することで送信が有効になる。

ユーザーへの恩恵

LLM ゲートウェイは、単一のユーザープロンプトから発生した一連のリクエストをグループ化できるようになり、ルーティングやキャッシュ、コスト・利用状況の帰属（アトリビューション）をプロンプト単位で行えるようになる。

変更前

LLM ゲートウェイは Claude Code が送る標準ヘッダー（セッション ID や認証情報など）しか参照できず、リクエストの種別やコンパクション状態などの詳細な文脈を取得する手段がなかった。ゲートウェイ側でのルーティングや使用量の属性付けに必要な情報は、ゲートウェイごとに独自に推測するしかなかった。

変更後

LLM ゲートウェイ向けに、リクエストの種別・エージェント種別・直前のツール実行時間・コンパクション状態などのヒントを伝える新しいリクエストヘッダー群が追加された。これらは既定では送信されず、環境変数 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 を設定した場合にのみ送信される。

ユーザーへの恩恵

ユーザーは環境変数を 1 つ設定するだけで、ゲートウェイに詳細なコンテキストを渡せるようになり、ゲートウェイ側のルーティングや分析の精度が向上する。