[DOCS] Model configuration docs omit `/effort auto` reset command

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

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Effort-level controls and reset behavior.

Current Documentation

The effort section currently documents:

Three levels are available: low, medium, and high.

And setting methods:

In /model: use left/right arrow keys to adjust the effort slider Environment variable: set CLAUDE_CODE_EFFORT_LEVEL=low|medium|high * Settings: set effortLevel in your settings file

No /effort command entry or /effort auto reset behavior is documented.

What's Wrong or Missing?

Release v2.1.72 states users can run /effort auto to reset effort to default.

The model configuration page explains low/medium/high but omits the command-based reset path, leaving users without a documented way to return from an explicit override to automatic/default behavior.

Suggested Improvement

Add a short subsection under "Adjust effort level" that documents:

  1. /effort low|medium|high (if supported command syntax should be listed explicitly).
  2. /effort auto resets to default model behavior.
  3. How /effort auto interacts with /model slider and CLAUDE_CODE_EFFORT_LEVEL.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/model-config | 129-142 | Effort levels documented, but no /effort auto reset path |
| https://code.claude.com/docs/en/interactive-mode | 95-139 | Built-in command table has no /effort entry |

Total scope: 2 pages affected

Source: Release v2.1.72

  • Simplified effort levels to low/medium/high (removed max) ... Use /effort auto to reset to default

View original on GitHub ↗

3 Comments

Hwwwww-dev · 7 months ago

When I sent /effort, it showed me Unknown skill: effort.

coygeek · 7 months ago

Issue #32685 Verification

Title: [DOCS] Model configuration docs omit /effort auto reset command
Issue Date: 2026-03-10
Verification Date: 2026-03-16
Status: RESOLVED
Submission Mode: Manual — draft only, do not post or close without explicit approval

---

Issue Summary

This issue reports that the model configuration page omits the /effort auto command for resetting effort to the model default, and that the interactive-mode page's built-in command table lacks any /effort entry. The reporter references release v2.1.72 as the source of the /effort auto feature and identifies two pages as affected.

---

Verification Results

Claim 1: /effort auto reset path is not documented on the model-config page

Status: RESOLVED

At https://code.claude.com/docs/en/model-config, line 138, the "Adjust effort level" subsection currently reads:

/effort: run /effort low, /effort medium, /effort high, or /effort max to change the level, or /effort auto to reset to the model default

The documentation now fully documents /effort auto alongside the other effort levels and explicitly describes its behavior as resetting to the model default.

Verdict: The missing documentation has been added. The claim no longer holds.

---

Claim 2: The interactive-mode built-in command table has no /effort entry (lines 95–139 at filing time)

Status: RESOLVED

The current https://code.claude.com/docs/en/interactive-mode no longer contains an inline built-in commands table listing individual commands. Lines 87–91 now redirect users to the dedicated commands reference:

See the commands reference for the full list of built-in commands.

The commands reference at https://code.claude.com/docs/en/commands, line 31, contains a comprehensive entry for /effort:

/effort [low|medium|high|max|auto] — Set the model effort level. low, medium, and high persist across sessions. max applies to the current session only and requires Opus 4.6. auto resets to the model default. Without an argument, shows the current level. Takes effect immediately without waiting for the current response to finish.

The interactive-mode page's architecture changed: it now delegates command listings to the dedicated commands reference rather than embedding a table inline. The /effort command, including /effort auto, is fully documented there.

Verdict: The table referenced in the issue no longer exists in its original form. The replacement commands reference fully covers /effort auto. The gap is closed.

---

Current State

| Claim | Status |
|-------|--------|
| /effort auto undocumented on model-config page | RESOLVED |
| /effort absent from interactive-mode built-in command table | RESOLVED |

---

Suggested Fix

N/A — issue has been resolved.

---

References

---

Conclusion & Recommendation

Primary Concern: The model-config page and interactive-mode page were missing documentation for the /effort auto command introduced in v2.1.72, leaving users without a documented path to reset effort to the model default.

Resolution Status: RESOLVED

Recommendation: CLOSE

Both pages have been updated: model-config now documents /effort auto inline in the "Adjust effort level" subsection, and the interactive-mode page now delegates to a dedicated commands reference that includes a complete /effort entry covering all arguments including auto.

github-actions[bot] · 6 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.