[DOCS] Commands reference shows outdated `/effort` no-argument 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/commands

Section/Topic

/effort slash command behavior when run without arguments

Current Documentation

The docs currently say:

/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 effort configuration page also says:

/effort: run /effort low, /effort medium, /effort high, or /effort max to change the level, or /effort auto to reset to the model default
In /model: use left/right arrow keys to adjust the effort slider when selecting a model

What's Wrong or Missing?

Changelog v2.1.111 says /effort now opens an interactive slider when called without arguments, with arrow-key navigation between levels and Enter to confirm.

The current docs are outdated in two ways:

A. The command reference describes the old no-argument behavior

It still says /effort without an argument only shows the current level.

B. The interactive picker behavior is only documented under /model

The docs describe slider-based effort selection for /model, but do not explain that /effort now also opens an interactive picker when invoked without an argument.

Suggested Improvement

Update the /effort entry in the commands reference and the effort configuration docs to reflect the new behavior.

Suggested wording:

Running /effort without an argument opens an interactive effort slider/picker. Use the arrow keys to move between effort levels and press Enter to confirm.

It would also help to clarify the difference between:

  • /effort with no argument → opens the interactive picker
  • /effort low|medium|high|max|auto → applies the specified value directly

Consider adding a short cross-reference to the relevant keyboard navigation page if the picker uses the standard select/model-picker bindings.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/commands | Primary /effort command entry still says no-argument usage only shows the current level |
| https://code.claude.com/docs/en/model-config | Documents /effort and effort sliders, but only explains slider navigation for /model |
| https://code.claude.com/docs/en/keybindings | Cross-reference for the relevant selection/model-picker arrow-key and Enter bindings |

Total scope: 3 pages affected

Source: Changelog v2.1.111

Exact changelog entry:

/effort now opens an interactive slider when called without arguments, with arrow-key navigation between levels and Enter to confirm

View original on GitHub ↗

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