maxEffortLevel

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

セッションが使用できるエフォートレベルの上限を設け、下位レベルは引き続き利用できるようにする。それより高いレベルはすべて上限で実行される。これには /effort、/model ピッカー、--effort、CLAUDE_CODE_EFFORT_LEVEL、スキルやサブエージェントの effort フロントマター、モデル自体の既定値によるレベルも含まれる。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"
    }
  }
}

使い方・用途

  • 組織の管理者がメンバーの effort レベルを特定の上限以下に固定したい場合に使う。
  • effort レベルの上限を下げても ultracode を有効なまま運用したい場合に使う。
  • Amazon Bedrock などサーバー側の effort 制御が届かないプロバイダーでも effort の上限を強制したい場合に使う。
英語原文

Cap the 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, a skill's or subagent's effort frontmatter, 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件)

maxEffortLevel 設定を追加した(トップレベルまたは modelSettings 配下のモデルごとに指定可能)。Bedrock、Vertex、Foundry を含むすべてのプロバイダーで effort レベルの上限を設定でき、ユーザーはより低いレベルを選ぶこともできる。
英語原文を表示
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

変更後

利用できる最大のエフォートレベルを maxEffortLevel 設定で制限できるようになる。Bedrock・Vertex・Foundry を含むどのプロバイダーでも上限が適用され、必要に応じてより低いレベルを選ぶこともできる。

関連ドキュメント