settings.json

modelSettings

型object記述場所どの設定ファイルでも可

使用する各モデルの努力レベル（effort level）を保存します。

記述例

{
  "modelSettings": {
    "claude-opus-5": {
      "effortLevel": "medium"
    }
  }
}

使い方・用途

  • v2.1.251 以降で利用可能
  • /effort コマンドや /model ピッカーのスライダーで設定したレベルが保存されます
  • モデルごとに個別のレベルを保存できます
  • 手動で編集してレベルを変更または削除できます
  • 管理設定で優先されます
英語原文(公式ドキュメントより)

Requires Claude Code v2.1.251 or later. Save an [effort level](/docs/en/model-config#adjust-effort-level) for each model you use. In an interactive session on your machine, when you run /effort low, medium, high, or xhigh or move the /model picker's effort slider, Claude Code saves that level here under the model you're using, so you rarely edit this key yourself. The [effortLevel](#effortlevel) entry lists the sessions in which /effort applies to that session only. Edit the key by hand to change or remove a level you saved.

関連ドキュメント

関連する変更履歴

v2.1.267(1件)

Added
新しい maxEffortLevel 設定を追加しました(トップレベル、または modelSettings 配下のモデル単位で指定可能)。Bedrock、Vertex、Foundry を含むすべてのプロバイダーで効果レベルの上限を設定でき、ユーザーはそれより低いレベルを選ぶことも可能です。
英語原文を表示
Added maxEffortLevel setting (top-level or per model under modelSettings): caps the effort level on every provider, including Bedrock, Vertex and Foundry; users can still pick a lower level

変更前

これまで効果レベルは、/effort コマンド、--effort フラグ、effortLevel や modelSettings などの設定キーで自由に設定でき、選択肢に上限を課す仕組みが存在しなかった。そのため、組織やユーザーが特定のモデルで過剰に高い効果レベルが使われるのを制限したい場合、設定でそれを防ぐ手段がなかった。

変更後

新しい maxEffortLevel 設定が追加された。これにより、設定ファイルのトップレベル、または modelSettings 配下のモデルごとのいずれかで、効果レベルの上限を指定できるようになった。Bedrock、Vertex、Foundry を含むすべてのプロバイダーに適用され、上限を超えて高い効果レベルを選択することはできなくなる。

ユーザーへの恩恵

ユーザーや組織は効果レベルの上限を設定で明示的に固定できるようになり、コストやトークン消費の増大を防ぎつつ、必要な場合にはより低いレベルを自由に選択できるようになった。

関連ドキュメント