[DOCS] Model configuration docs still describe Opus 4.6 effort support instead of Opus 4.7 xhigh
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/model-config
Section/Topic
Model aliases / "Adjust effort level"
Current Documentation
The docs currently say:
|sonnet| Uses the latest Sonnet model (currently Sonnet 4.6) for daily coding tasks | |opus| Uses the latest Opus model (currently Opus 4.6) for complex reasoning tasks | 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 and does not persist across sessions except through theCLAUDE_CODE_EFFORT_LEVELenvironment variable. 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 also says:
/effort [low|medium|high|max|auto]...maxapplies to the current session only and requires Opus 4.6.
What's Wrong or Missing?
Changelog v2.1.111 says: Claude Opus 4.7 xhigh is now available! Use /effort to tune speed vs. intelligence.
The current Claude Code docs are outdated for this release:
A. The model documentation still identifies Opus 4.6 as the current/latest Opus model
I found no Opus 4.7 or xhigh references in the current code.claude.com mirror, while model-config still says the latest Opus model is Opus 4.6.
B. The effort documentation still scopes the feature to Opus 4.6-era wording
/effort, --effort, settings, and frontmatter docs still describe effort support using "Opus 4.6 only" wording. After v2.1.111, users need documentation that explains how /effort applies to Claude Opus 4.7 xhigh and what "tune speed vs. intelligence" means for that model.
Without that update, users cannot tell whether Opus 4.7 xhigh is a new model picker entry, how it relates to existing effort levels, or which effort options are supported on the new model.
Suggested Improvement
Update the model and effort documentation for v2.1.111:
- In
model-config, replace stale "currently Opus 4.6" / "Opus 4.6 only" wording with the current Opus 4.7 xhigh behavior. - Add a short explanation of where users will see Claude Opus 4.7 xhigh (for example, in
/model) and how/effortchanges the speed vs. intelligence tradeoff on that model. - Clarify whether
xhighis a model variant name, an effort preset, or a label shown alongside existing effort levels so users do not confuse it withhigh/max. - Update the command, settings, env-var, skill, and subagent references that still describe effort support as Opus 4.6-specific if that restriction is no longer accurate.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/model-config | 39-40, 157-176 | Alias table still says latest Opus is 4.6; effort support and max are described with Opus 4.6-specific wording |
| https://code.claude.com/docs/en/commands | 40 | /effort says max requires Opus 4.6 |
| https://code.claude.com/docs/en/cli-reference | 67 | --effort says max is Opus 4.6 only |
| https://code.claude.com/docs/en/common-workflows | 525-541 | Effort tuning is documented only for Opus 4.6 and Sonnet 4.6 |
| https://code.claude.com/docs/en/settings | 186 | effortLevel says it is supported on Opus 4.6 and Sonnet 4.6 |
| https://code.claude.com/docs/en/env-vars | 87 | CLAUDE_CODE_EFFORT_LEVEL says max is Opus 4.6 only |
| https://code.claude.com/docs/en/skills | 199 | Skill frontmatter still says max is Opus 4.6 only |
| https://code.claude.com/docs/en/slash-commands | 199 | Slash-command frontmatter still says max is Opus 4.6 only |
| https://code.claude.com/docs/en/sub-agents | 255 | Subagent frontmatter still says max is Opus 4.6 only |
Total scope: 9 pages affected
Source: Changelog v2.1.111
Exact changelog entry: Claude Opus 4.7 xhigh is now available! Use /effort to tune speed vs. intelligence
3 Comments
Found 1 possible duplicate issue:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Issue #49278 Verification
Title: [DOCS] Model configuration docs still describe Opus 4.6 effort support instead of Opus 4.7 xhigh
Issue Date: 2026-04-16
Verification Date: 2026-04-28
Status: RESOLVED
---
Issue Summary
This issue reports that the Claude Code documentation still described Opus 4.6 as the current Opus model and still documented effort controls with Opus 4.6-only wording instead of explaining Opus 4.7 and the new
xhigheffort level.---
Verification Results
Claim 1: The model configuration docs still identified Opus 4.6 as the current/latest Opus model
Status: RESOLVED
At https://code.claude.com/docs/en/model-config, line 30:
| **\opus\** | Uses the latest Opus model for complex reasoning tasks |At https://code.claude.com/docs/en/model-config, line 36:
On the Anthropic API, \opus\resolves to Opus 4.7 and \sonnet\resolves to Sonnet 4.6.Verdict: The current model configuration page no longer describes Opus 4.6 as the latest Opus model for the Anthropic API. It now explicitly maps the
opusalias to Opus 4.7.---
Claim 2: The effort documentation still used Opus 4.6-era wording instead of documenting Opus 4.7 and
xhighStatus: RESOLVED
At https://code.claude.com/docs/en/model-config, lines 163-168:
Effort is supported on Opus 4.7, Opus 4.6, and Sonnet 4.6. The available levels depend on the model:followed by| Opus 4.7 | \low\, \medium\, \high\, \xhigh\, \max\|and| Opus 4.6 and Sonnet 4.6 | \low\, \medium\, \high\, \max\|.At https://code.claude.com/docs/en/commands, line 40: `
/effort [level|auto]...Acceptslow,medium,high,xhigh, ormax; available levels depend on the model`.At https://code.claude.com/docs/en/cli-reference, line 61: `
--effort...Options:low,medium,high,xhigh,max; available levels depend on the model.`At https://code.claude.com/docs/en/settings, line 191: `
effortLevel...Accepts "low", "medium", "high", or "xhigh".`At https://code.claude.com/docs/en/env-vars, line 90: `
CLAUDE_CODE_EFFORT_LEVEL...Values:low,medium,high,xhigh,max, orautoto use the model default. Available levels depend on the model.`At https://code.claude.com/docs/en/skills, line 200, https://code.claude.com/docs/en/slash-commands, line 200, and https://code.claude.com/docs/en/sub-agents, line 252: each page now documents
xhighandmaxas valid effort values, with availability depending on the model.Verdict: The current command, CLI, settings, environment-variable, skill, slash-command, and subagent documentation no longer uses the reported Opus 4.6-only wording. The docs now describe model-dependent effort support and include
xhighwhere relevant.---
Claim 3: The docs did not explain where users see Opus 4.7
xhigh, how/effortchanges the speed-versus-intelligence tradeoff, or whatxhighisStatus: RESOLVED
At https://code.claude.com/docs/en/whats-new/2026-w16, line 20:
Anthropic's strongest coding model yet is now the default on Max and Team Premium, and available everywhere else from /model. It adds a new xhigh effort level that sits between high and max ... /effort now opens an interactive arrow-key slider ... so you can dial intelligence against speed.At https://code.claude.com/docs/en/model-config, lines 182-188: the page defines each effort level and describes
xhighasBest results for most coding and agentic tasks. Recommended default on Opus 4.7.At https://code.claude.com/docs/en/model-config, lines 198-207: the page says users can set effort via
/effort, adjust itIn /model, and thatThe effort slider appears in /model when a supported model is selected.At https://code.claude.com/docs/en/common-workflows, lines 543-549:
This is the recommended way to tune the tradeoff between speed and reasoning depthandOpus 4.7 always uses adaptive reasoning and does not support a fixed thinking budget.Verdict: The current docs now explain that
xhighis an effort level, place it betweenhighandmax, describe its tradeoff, and tell users they can access it through/modeland/effort.---
Current State
| Claim | Status |
|-------|--------|
| The model configuration docs still identified Opus 4.6 as the current/latest Opus model | RESOLVED |
| The effort documentation still used Opus 4.6-era wording instead of documenting Opus 4.7 and
xhigh| RESOLVED || The docs did not explain where users see Opus 4.7
xhigh, how/effortchanges the tradeoff, or whatxhighis | RESOLVED |---
Suggested Fix
N/A - issue has been resolved.
---
References
opusalias as the latest Opus model and explicitly maps it to Opus 4.7 on the Anthropic API.xhigh, per-model effort availability, and persistence behavior.xhigh, explains the speed/intelligence tradeoff, and documents/effortand/modelcontrols./effortwithxhighand model-dependent availability.--effortwithxhighand model-dependent availability.effortLevelwithxhigh.CLAUDE_CODE_EFFORT_LEVELwithxhigh,max, andauto.effortwithxhighandmax.effortwithxhighandmax.effortwithxhighandmax./model, introducesxhigh, places it betweenhighandmax, and shows/effort xhigh.---
Conclusion & Recommendation
Primary Concern: The issue reported that the docs still reflected Opus 4.6-era model and effort behavior instead of documenting Opus 4.7 and
xhigh.Resolution Status: RESOLVED
Recommendation: CLOSE
The current documentation now identifies Opus 4.7 as the active Opus mapping on the Anthropic API, documents
xhighacross the affected effort-related pages, and explains how users access and interpret the new effort level. The reported documentation gap is fixed.---
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.