環境変数

CLAUDE_CODE_EFFORT_LEVEL

対応モデルの effort レベルを設定する。値は low、medium、high、xhigh、max、またはモデルのデフォルトを使う auto。利用可能なレベルはモデルに依存する。--effort、/effort、modelSettings および effortLevel 設定より優先される。maxEffortLevel の上限は引き続き適用される。

使い方・用途

  • モデルの思考の深さをセッションごとに切り替えるのではなく、環境変数として固定的に指定したい場合に、他の設定やコマンド引数より優先して効くレベル指定として使う
  • チームやCI環境で Claude Code を起動する際に、/effort や --effort に頼らず一定の effort レベルを強制したい場合に使う
  • Opus 5.5 などモデルごとの既定 effort レベルの違いを意識せず、環境変数で明示的にレベルを決め打ちしたい場合に使う
英語原文(公式ドキュメントより)

Set the effort level for supported models. Values: low, medium, high, xhigh, max, or auto to use the model default. Available levels depend on the model. Takes precedence over --effort, /effort, and the modelSettings and effortLevel settings. A maxEffortLevel cap still applies. See Adjust effort level

関連ドキュメント

関連する変更履歴

v2.1.304(1件)

Fixed
CLAUDE_CODE_EFFORT_LEVEL が auto または unset で、かつレベルが送信されない場合に、/effort status、/effort ultracode およびプロンプトの effort インジケーターが推測した effort レベルを表示する問題を修正した
英語原文を表示
Fixed /effort status, /effort ultracode and the prompt's effort indicator showing a guessed effort level when CLAUDE_CODE_EFFORT_LEVEL is auto or unset and no level is sent

関連ドキュメント

v2.1.132(1件)

Fixed
/effort の選択画面に CLAUDE_CODE_EFFORT_LEVEL 環境変数のオーバーライド設定が反映されない問題を修正しました
英語原文を表示
Fixed /effort picker not reflecting the CLAUDE_CODE_EFFORT_LEVEL env var override

変更後

現在の推論設定が一目でわかるようになり、設定ミスによる予期せぬトークン消費や回答精度の変化を防げます。

関連ドキュメント