[DOCS] Model configuration docs still describe Opus 4.6 effort support instead of Opus 4.7 xhigh

Status Fixed / completed
Maintainer reply None cached
Activity 3 comments · opened Apr 16, 2026 · closed Apr 29, 2026

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 at high. max is available on Opus 4.6 only and does not persist across sessions except through the CLAUDE_CODE_EFFORT_LEVEL environment variable. 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 also says:

/effort [low|medium|high|max|auto] ... max applies 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:

  1. In model-config, replace stale "currently Opus 4.6" / "Opus 4.6 only" wording with the current Opus 4.7 xhigh behavior.
  2. Add a short explanation of where users will see Claude Opus 4.7 xhigh (for example, in /model) and how /effort changes the speed vs. intelligence tradeoff on that model.
  3. Clarify whether xhigh is a model variant name, an effort preset, or a label shown alongside existing effort levels so users do not confuse it with high / max.
  4. 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

View original on GitHub ↗

3 Comments

github-actions[bot] · 6 months ago

Found 1 possible duplicate issue:

  1. https://github.com/anthropics/claude-code/issues/49283

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

coygeek · 5 months ago

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 xhigh effort 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 opus alias to Opus 4.7.

---

Claim 2: The effort documentation still used Opus 4.6-era wording instead of documenting Opus 4.7 and xhigh

Status: 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] ... Accepts low, medium, high, xhigh, or max; 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, or auto to 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 xhigh and max as 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 xhigh where relevant.

---

Claim 3: The docs did not explain where users see Opus 4.7 xhigh, how /effort changes the speed-versus-intelligence tradeoff, or what xhigh is

Status: 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 xhigh as Best 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 it In /model, and that The 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 depth and Opus 4.7 always uses adaptive reasoning and does not support a fixed thinking budget.

Verdict: The current docs now explain that xhigh is an effort level, place it between high and max, describe its tradeoff, and tell users they can access it through /model and /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 /effort changes the tradeoff, or what xhigh is | RESOLVED |

---

Suggested Fix

N/A - issue has been resolved.

---

References

---

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 xhigh across the affected effort-related pages, and explains how users access and interpret the new effort level. The reported documentation gap is fixed.

---

github-actions[bot] · 5 months ago

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.