Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.267 ·

New maxEffortLevel setting caps reasoning effort

Administrators can now cap the maximum reasoning-effort level, overall or per model, and Claude Code enforces it against any effort request

TierUse it nowhow much it should matter to you
Useful4my rating, 1 to 5
Signal3worth watching, 1 to 5
AreaEffortwhat it touches
KindNew Featuresin v2.1.267,
Group of 3 Use it now Notable

Administrators can now cap the maximum reasoning-effort level, overall or per model, and Claude Code enforces it against any effort request

What

  • A new managed-settings key, maxEffortLevel, lets an administrator restrict the maximum reasoning-effort level allowed.
  • The effective cap is computed by combining a top-level maxEffortLevel with any per-model modelSettings.<model>.maxEffortLevel overrides across all loaded settings files, taking the lowest applicable value.
  • Any explicit effort request, from /effort, /model, the --effort flag, the CLAUDE_CODE_EFFORT_LEVEL environment variable, or a model's default, is clamped to this cap.
  • Effort-level resolution (whether effort, max_effort, or xhigh_effort apply for a given model) now checks this new setting first, before falling back to the older logic based on the model's id.

Why This lets organizations enforce a ceiling on how much reasoning effort, and therefore cost and latency, Claude Code can use, regardless of what an individual user or model requests.

Read from
Names in the bundlemaxEffortLevel
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up maxEffortLevel, on What's new. Also this week: pop any **Claude Code Desktop pane** out into its own window and dock it back later; the **`maxEffortLevel`** setting caps the effort level on every provider; and a page that **WebFetch** hasn't finished downloading within … whats-new/index see the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat secDefault itself configures is not stated in the finding.
Anthropic's documentation agreesAnthropic's documentation has since written up maxEffortLevel, on What's new.
Anthropic's release notes agreeAdded maxEffortLevel setting (top-level or per model under modelSettings): caps the effort level on every provider, including Bedrock…
The name it cites is new in this buildNew in this build: maxEffortLevel

See this entry in the whole of v2.1.267 →