[DOCS] Effort level docs omit `xhigh` for Opus 4.7 and fallback-to-`high` behavior
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 athigh.maxis available on Opus 4.6 only..." "/effort: run/effort low,/effort medium,/effort high, or/effort maxto change the level..." "--effortflag: passlow,medium,high, ormaxto set the level for a single session..." "Effort is supported on Opus 4.6 and Sonnet 4.6. The effort slider appears in/modelwhen 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:
- In
model-config, documentxhighbetweenhighandmaxand update model support text from Opus 4.6-era wording to Opus 4.7 wording. - In the
/effortcommand docs, addxhighto the documented values. - In the
--effortCLI flag docs, addxhighto the documented values. - In the model picker guidance, note that
xhighis available for Opus 4.7 and falls back tohighon 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
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗