[DOCS] `/config` keyboard docs still describe pre-v2.1.183 toggle and Esc behavior

Open 💬 0 comments Opened Jun 19, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/keybindings

Section/Topic

The Settings actions table in Keybindings, plus the introductory /config settings-interface description in Settings.

Current Documentation

The keybindings page currently says:

settings:close | Enter | Save changes and close the config panel. Escape discards changes and closes

The settings page currently says:

Claude Code offers a variety of settings to configure its behavior to meet your needs. You can configure Claude Code by running the /config command, which opens a tabbed Settings interface where you can view status information and modify configuration options.

What's Wrong or Missing?

A. The keybindings table now contradicts the released /config behavior in v2.1.183

The v2.1.183 changelog says:

Changed /config toggle behavior: Enter and Space both change the selected setting, and Esc now saves and closes instead of reverting

That directly conflicts with the current settings:close row, which still says Enter saves and closes the panel and Escape discards changes and closes. The stable keyboard reference is describing the pre-v2.1.183 behavior.

B. The new toggle shortcut is missing from stable docs

No stable page outside the changelog documents that Space also changes the selected setting in /config. The Settings actions table does not list any settings-toggle action at all, so users cannot discover the new Enter/Space behavior from the keyboard shortcuts reference.

C. The main /config entry point does not point readers to the updated controls

The Settings page introduces /config as a tabbed interface, but it does not tell readers where the interface's keyboard controls are documented. Because the dedicated shortcut table is outdated, the changelog is currently the only place with the correct interaction model.

Suggested Improvement

Update the Settings actions section in Keybindings so it matches the current /config behavior in v2.1.183:

Before:

settings:close | Enter | Save changes and close the config panel. Escape discards changes and closes

After:

Document that:

  1. Enter and Space both change the selected setting.
  2. Esc saves changes and closes the /config panel instead of reverting.
  3. The Settings page should link to the Keybindings Settings actions section, or include a short note telling readers where to find the /config keyboard controls.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/keybindings | 302-310 | Settings actions still says Enter closes the panel and Escape discards changes, and it does not document the new toggle behavior |
| https://code.claude.com/docs/en/settings | 9 | Primary /config entry point introduces the tabbed Settings interface but does not point readers to the keyboard controls |

Total scope: 2 pages affected

Version: Claude Code v2.1.183

Changelog cross-reference: https://code.claude.com/docs/en/changelog documents the release note "Changed /config toggle behavior: Enter and Space both change the selected setting, and Esc now saves and closes instead of reverting".

View original on GitHub ↗