環境変数

ANTHROPIC_CUSTOM_HEADERS

リクエストに追加するカスタムヘッダーである(Name: Value 形式、複数ヘッダーは改行で区切る)。名前や値に波ダッシュやゼロ幅スペースのような HTTP ヘッダーが保持できない文字が含まれる場合、リクエストは失敗し、エラーがそのペアを位置で特定する。Claude Code v2.1.227 以降が必要である。Invalid request header value には、対象の正確な文字集合とチェックが実行される箇所が示される。Authorization や Host など、認証情報、org や tenant、ルーティング、API の挙動に関するヘッダーを設定する値は、サーバー管理設定で配信された場合に承認が必要な設定とみなされる。プロジェクト設定やローカル設定から提供された場合、そのような値は env 値が適用されるタイミングのルールに従う。

使い方・用途

  • 認証情報とは別に、テナント識別子やルーティングキーなどのカスタムヘッダーをリクエストに付与してゲートウェイ側でリクエストの経路振り分けやタグ付けをしたい。
  • ゲートウェイが期待する Authorization ヘッダーのスキームやヘッダー名が ANTHROPIC_AUTH_TOKEN の Bearer 形式と異なる場合に、独自の形式で認証ヘッダーを送りたい。
  • apiKeyHelper のモデル確認リクエストなど、Claude Code が送るリクエストに組み込みヘッダーと同名のヘッダーを上書きして送りたい。
英語原文(公式ドキュメントより)

Custom headers to add to requests (Name: Value format, newline-separated for multiple headers). If a name or value contains a character an HTTP header can't carry, such as a curly quote or a zero-width space, the request fails with an error that identifies the pair by position. Requires Claude Code v2.1.227 or later. Invalid request header value lists the exact character set and where the check runs. A value that sets a credential, org or tenant, routing, or API-behavior header, such as Authorization or Host, counts as a setting that needs approval when server-managed settings deliver it. From project or local settings, such a value follows the rules for when env values apply

関連ドキュメント

関連する変更履歴

v2.1.287(1件)

Changed
Bedrock、Vertex、Mantle: ANTHROPIC_CUSTOM_HEADERS で Authorization を繰り返し指定した際に、CLAUDE_CODE_SKIP_*_AUTH によるモデル利用可否チェックが実際のリクエストと異なる Authorization ヘッダーを送信する問題を修正した
英語原文を表示
Bedrock, Vertex, Mantle: Fixed model availability checks under CLAUDE_CODE_SKIP_*_AUTH sending a different Authorization header than real requests when ANTHROPIC_CUSTOM_HEADERS repeats it

変更後

利用可能なモデルの確認が、実際のリクエストと同じ Authorization ヘッダーで行われるようになり、ANTHROPIC_CUSTOM_HEADERS で認証ヘッダーを指定している環境でもモデル判定が正しく行えるようになる。

関連ドキュメント

v2.1.251(1件)

Changed
マネージド設定やプロジェクト設定による ANTHROPIC_CUSTOM_HEADERS が、認証情報、org/テナント、ルーティング、API 動作に関するヘッダー(例： Authorization、Host)を設定する場合に、承認を必要とするように変更した。
英語原文を表示
Changed ANTHROPIC_CUSTOM_HEADERS from managed or project settings to require approval when it sets a credential, org/tenant, routing, or API-behavior header (e.g. Authorization, Host)

変更後

プロジェクト設定などで資格情報やルーティングに関わるカスタムヘッダーを設定する際に、承認ダイアログを経由するようになり、意図しないヘッダーが確認なしに適用されるのを防げる。

関連ドキュメント

v2.1.101(1件)

Fixed
Amazon BedrockのSigV4認証において、ANTHROPIC_AUTH_TOKEN 等でAuthorizationヘッダーが設定されていると403エラーになる問題を修正
英語原文を表示
Fixed Bedrock SigV4 authentication failing with 403 when ANTHROPIC_AUTH_TOKEN, apiKeyHelper, or ANTHROPIC_CUSTOM_HEADERS set an Authorization header

変更後

AWS Bedrockを利用した開発環境のセットアップにおける不透明な認証エラーが解消されます。

関連ドキュメント