settings.json

effortLevel

型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.280(1件)

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

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

変更後

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

関連ドキュメント