環境変数

CLAUDE_EFFORT

Bash ツールのサブプロセスやフックコマンドの中で自動的に設定され、サブプロセス開始時に有効だった effort レベル(low、medium、high、xhigh、max のいずれか)が入る。フックに渡される effort.level フィールドと一致する。現在のモデルが effort パラメータに対応している場合にのみ設定される。

使い方・用途

  • Hook や Bash ツールのコマンド内で、現在 Claude Code に適用されている effort レベルを参照したいときに使う
  • effort レベルに応じて Hook の動作や Skill の内容を切り替えたいときに使う
  • サブプロセスに開始時点の effort レベルを引き継ぎたいときに使う
英語原文(公式ドキュメントより)

Set automatically in Bash tool subprocesses and hook commands to the effort level in effect when the subprocess starts: low, medium, high, xhigh, or max. Matches the effort.level field passed to hooks. Only set when the current model supports the effort parameter

関連する変更履歴

v2.1.133(1件)

Changed
フックおよびBashツールに現在設定されている思考レベル(effort level)を渡す機能を追加しました
英語原文を表示
Hooks now receive the active effort level via the effort.level JSON input field and the $CLAUDE_EFFORT environment variable, and Bash tool commands can read $CLAUDE_EFFORT

変更後

思考レベルに応じてフックの挙動を変えたり、ログに記録したりするなど、コンテキストに応じた柔軟な自動化が可能になります。

関連ドキュメント

v2.1.120(1件)

Added
スキル内で現在の推論負荷(effort level)を環境変数 ${CLAUDE_EFFORT} として参照可能に
英語原文を表示
Skills can now reference the current effort level with ${CLAUDE_EFFORT} in their content

変更後

高負荷(high effort)時にはより詳細な分析を指示するなど、ユーザーの設定に合わせた最適な出力をスキル側で制御できるようになります。

関連ドキュメント