settings.json

maxEffortLevel

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

セッションが使用できる効果レベルの上限を設定します。低いレベルはそのまま選択可能で、/effort、/model ピッカー、--effort、CLAUDE_CODE_EFFORT_LEVEL、モデル自身のデフォルトなど、それより高いレベルはすべてこの上限で実行されます。Claude Code が各リクエスト前に自ら上限を適用するため、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry を含むすべてのプロバイダーで有効です。Claude Code v2.1.267 以降が必要です。

既定値: 未設定の場合、上限は適用されません

取りうる値

low
medium
high
xhigh
max

記述例

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

使い方・用途

  • 効果レベルの上限を設定する設定キーで、トップレベルまたは modelSettings 配下のモデル単位で指定でき、Bedrock、Vertex、Foundry を含むすべてのプロバイダーで適用されます(要 v2.1.267 以降)
  • 選択肢は low / medium / high / xhigh / max で、デフォルトは未設定(上限なし)。上限を超えるレベルはすべて上限値で実行され、ユーザーはそれより低いレベルを自由に選べます
  • 組織の管理設定(マネージド設定)としても使え、/effort や --effort でユーザーが上限を超えられないようにすることで、コストやトークン消費の増大を防げます。組織のサーバー側の効果レベル制限と両方適用される場合は低い方の上限が優先されます
英語原文(公式ドキュメントより)

Cap the [effort level](/docs/en/model-config#adjust-effort-level) a session can use, leaving lower levels available. Any higher level runs at the cap instead, including one from /effort, the /model picker, --effort, [CLAUDE_CODE_EFFORT_LEVEL](/docs/en/env-vars), or the model's own default. Claude Code applies the cap itself before each request, so it holds on every provider, including Amazon Bedrock, Google Cloud's Agent Platform, and Microsoft Foundry. Requires Claude Code v2.1.267 or later.

関連ドキュメント

関連する変更履歴

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 を含むすべてのプロバイダーに適用され、上限を超えて高い効果レベルを選択することはできなくなる。

ユーザーへの恩恵

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

関連ドキュメント