effortLevel

settings.json型string記述場所どの設定ファイルでも可

適応型推論の努力レベルをセッション間で永続化する。low、medium、high、xhigh を設定する。max と ultracode はセッション限定であり設定ファイルでは受け付けない。

取りうる値

low最も推論が少なく、知能より待ち時間が重要な短く範囲の限られたタスク向け
mediumある程度の知能を犠牲にしてよいコスト重視の作業でトークン使用量を抑える
highトークン使用量と知能のバランスを取る
xhighより高いトークン消費でより深い推論を行う

記述例

{
  "effortLevel": "xhigh"
}

使い方・用途

  • 適応型推論の努力レベルをセッションをまたいで永続化する設定。low / medium / high / xhigh から選択
  • デフォルトの努力レベルは Fable 5・Opus 4.8・Opus 4.6・Sonnet 4.6 では high、Opus 4.7 では xhigh
  • max と ultracode はセッション限定で設定ファイルには設定できない(CLAUDE_CODE_EFFORT_LEVEL 環境変数または /effort を使用)
  • modelSettings にモデル別のレベルが保存されている場合はそちらが優先される
  • /effort auto でモデルのデフォルトにリセットできる
  • 低レベルは単純なタスクで高速・低コスト、高レベルは複雑な問題でより深く推論する
英語原文

Persist adaptive reasoning effort across sessions. Set to low, medium, high, or xhigh; max and ultracode are session-only and are not accepted in the settings file (use the CLAUDE_CODE_EFFORT_LEVEL environment variable or /effort for a session-only max). Effort is supported on Fable 5, Opus 4.8, Opus 4.7, Opus 4.6, and Sonnet 4.6, with xhigh sitting between high and max (added in v2.1.111). Defaults: Fable 5 and Opus 4.8 default to high; Opus 4.6 and Sonnet 4.6 default to high on all plans (Pro/Max raised from medium to high in v2.1.117); Opus 4.7 defaults to xhigh. Use /effort auto to reset to model default. Also configurable via CLAUDE_CODE_EFFORT_LEVEL environment variable. See https://code.claude.com/docs/en/model-config#adjust-effort-level

関連する変更履歴

v2.1.317(1件)

アプリが事前に開始してプロジェクトで開くセッション(デスクトップアプリの Code タブの新規セッションなど)が、プロジェクトの effortLevel 設定を無視する問題を修正した
英語原文を表示
Fixed a project's effortLevel setting being ignored by sessions that an app starts ahead of time and then opens in the project, such as new sessions in the desktop app's Code tab

v2.1.280(1件)

Opus 4.7、Opus 4.8、Fable 5 について、-p や Agent SDK、プロジェクト設定、マネージド設定、--settings の effortLevel、モデルごとの effort レベルなどが指定されていても、リリース時のデフォルト effort を優先して維持しないようにした
英語原文を表示
Changed Opus 4.7, Opus 4.8 and Fable 5 to stop holding their launch-default effort over /effort in -p or the Agent SDK, a project, managed or --settings effortLevel, or a per-model level

変更後

Opus 4.7 と Opus 4.8、Fable 5 で、非対話モード (-p) や Agent SDK での /effort、プロジェクト・管理ポリシー・--settings の effortLevel、モデルごとの設定が、起動時のデフォルト effort によって黙って上書きされなくなった。どの設定方法で effort を指定しても、その指定が確実に反映されるようになる。

関連ドキュメント

v2.1.203(1件)

デーモン経由でフォークされた場合に、settings.jsonのeffortLevel変更が無視される問題を修正しました。
英語原文を表示
Fixed background sessions ignoring effortLevel changes in settings.json when forked through the daemon

変更後

推論設定が意図通りに動作し、期待する品質でタスクを進められます。

関連ドキュメント