CLAUDE_CODE_EFFORT_LEVEL

環境変数

対応しているモデルに対して effort レベルを設定する。値は low、medium、high、xhigh、max のいずれか。利用可能なレベルはモデルによって異なる。--effort、/effort、modelSettings および effortLevel の各設定よりも優先される。maxEffortLevel の上限は引き続き適用される。auto を設定するか未設定のままにすると、Claude Code は effort レベルを送信せず、API がモデルごとの独自の既定値を適用する。

使い方・用途

  • Claude Code が effort level を送らず、API 側のモデル既定値に任せたいときに auto または unset を設定して使う
  • シェルからエクスポートすることで、--effort や /effort、modelSettings や effortLevel の設定よりも優先して effort level を強制したいときに使う
  • ultrathink による深い推論を有効にするため、xhigh 未満に下がっている effort level を引き上げたいときに使う
英語原文

Set the effort level for supported models. Values: low, medium, high, xhigh, or max. Available levels depend on the model. Takes precedence over --effort, /effort, and the modelSettings and effortLevel settings. A maxEffortLevel cap still applies. Set it to auto or unset to have Claude Code send no effort level, so that the API applies its own default for the model. See Adjust effort level

関連ドキュメント

関連する変更履歴

v2.1.304(1件)

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件)

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

変更後

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

関連ドキュメント