環境変数

CLAUDE_CODE_EXTRA_BODY

すべての API リクエストボディの最上位レベルにマージされる JSON オブジェクトである。Claude Code が直接公開していないプロバイダー固有のパラメーターを渡すのに便利である。シェルでエクスポートした値は、claude agents や --bg で起動したバックグラウンドセッションにも適用される。v2.1.206 より前では、バックグラウンドセッションはシェルでエクスポートされた値を無視し、バックグラウンドスーパーバイザープロセスが継承したコピーを使っていた

使い方・用途

  • Claude Code が直接公開していないプロバイダ固有のパラメータを API リクエストに渡したいときに使う。
  • ゲートウェイやプロバイダ側が要求するリクエストボディのフィールドを追加し、全 API リクエストに一括で反映したいときに使う。
  • シェルでエクスポートした値を claude agents や --bg で起動したバックグラウンドセッションにも引き継ぎたいときに使う。
英語原文(公式ドキュメントより)

JSON object to merge into the top level of every API request body. Useful for passing provider-specific parameters that Claude Code doesn't expose directly. A value exported in your shell also applies to the background sessions you dispatch with claude agents or --bg. Before v2.1.206, background sessions ignored a shell-exported value and used whatever copy the background supervisor process inherited

関連ドキュメント

関連する変更履歴

v2.1.273(1件)

Changed
/bug と /feedback のレポートを変更し、直近の API リクエストからモデル動作に関するパラメータ(モデル、システムプロンプト、ツール)のみを含め、リクエストのメタデータや CLAUDE_CODE_EXTRA_BODY のフィールドを除外するようにした
英語原文を表示
Changed /bug and /feedback reports to include only model-behavior params (model, system prompt, tools) from the last API request, omitting request metadata and CLAUDE_CODE_EXTRA_BODY fields

変更後

/bug や /feedback で送信するレポートに、モデルの挙動を再現するのに必要な情報(model、system prompt、tools)だけが含まれるようになります。リクエストのメタデータなどの余計な情報が除外されるため、モデルの動作に関する問題をより的確に伝えられる。

関連ドキュメント

v2.1.206(1件)

Fixed
CLAUDE_CODE_EXTRA_BODY 環境変数がバックグラウンドワーカーでも正しく継承されるよう修正しました
英語原文を表示
Fixed CLAUDE_CODE_EXTRA_BODY being silently ignored by claude agents / --bg background workers; the shell-exported override now follows the dispatching session

変更後

カスタムプロバイダーや特殊なゲートウェイ設定を使用している環境でも、バックグラウンドタスクが正常に動作します。

関連ドキュメント

v2.1.113(1件)

Fixed
思考負荷(Effort)設定をサポートしていないモデルやVertex AIを使用している際に発生していた400エラーを修正しました
英語原文を表示
Fixed CLAUDE_CODE_EXTRA_BODY output_config.effort causing 400 errors on subagent calls to models that don't support effort and on Vertex AI

変更後

Google Vertex AIなどの外部プラットフォーム利用時でも、予期せぬエラーで作業が止まることがなくなります。

関連ドキュメント