[DOCS] Effort level docs omit `xhigh` for Opus 4.7 and fallback-to-`high` behavior

Resolved 💬 2 comments Opened Apr 16, 2026 by coygeek Closed Apr 29, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/model-config

Section/Topic

Adjust effort level and the linked /effort / --effort usage guidance

Current Documentation

The model configuration page currently says:

"Three levels persist across sessions: low, medium, and high. A fourth level, max, provides the deepest reasoning with no constraint on token spending, so responses are slower and cost more than at high. max is available on Opus 4.6 only..." "/effort: run /effort low, /effort medium, /effort high, or /effort max to change the level..." "--effort flag: pass low, medium, high, or max to set the level for a single session..." "Effort is supported on Opus 4.6 and Sonnet 4.6. The effort slider appears in /model when a supported model is selected..."

The command reference currently says:

"/effort [low\|medium\|high\|max\|auto] ... max applies to the current session only and requires Opus 4.6."

The CLI reference currently says:

"--effort ... Options: low, medium, high, max (Opus 4.6 only)."

What's Wrong or Missing?

These pages are outdated for changelog v2.1.111.

The changelog added an xhigh effort level for Opus 4.7, positioned between high and max, and says it is available through /effort, --effort, and the model picker. The current docs still describe the effort range as only low / medium / high / max, and they still scope the higher-end behavior to Opus 4.6.

The docs also do not explain the new compatibility behavior that other models fall back to high when xhigh is requested.

Suggested Improvement

Update the effort documentation so all user-facing entry points match v2.1.111:

  1. In model-config, document xhigh between high and max and update model support text from Opus 4.6-era wording to Opus 4.7 wording.
  2. In the /effort command docs, add xhigh to the documented values.
  3. In the --effort CLI flag docs, add xhigh to the documented values.
  4. In the model picker guidance, note that xhigh is available for Opus 4.7 and falls back to high on other models.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/model-config | Central effort-level description, supported-model wording, and model-picker guidance |
| https://code.claude.com/docs/en/commands | /effort syntax still omits xhigh |
| https://code.claude.com/docs/en/cli-reference | --effort options still omit xhigh |
| https://code.claude.com/docs/en/common-workflows | Extended-thinking guidance still describes effort support using Opus 4.6 / Sonnet 4.6 wording |

Total scope: 4 pages affected

Source: Changelog v2.1.111

Entry under review: Added xhigh effort level for Opus 4.7, sitting between high and max. Available via /effort, --effort, and the model picker; other models fall back to high

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗