CLAUDE_EFFORT

環境変数

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

使い方・用途

  • Hook や Bash ツールのサブプロセス内で、現在のモデルに設定されている effort レベルを参照したいときに使う
  • Hook に渡される effort.level フィールドと同じ値を環境変数経由で取得し、処理の分岐などに利用したいときに使う
  • Skill の内容に ${CLAUDE_EFFORT} を記述して、現在の effort レベルを反映した出力をさせたいときに使う
英語原文

Set automatically in Bash tool subprocesses and hook commands to the effort level setting 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件)

フックおよび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件)

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

変更後

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

関連ドキュメント