claude-code - 💡(How to fix) Fix [DOCS] `/theme` docs omit Esc behavior for custom theme dialogs and editor

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/terminal-config#create-a-custom-theme

Section/Topic

/theme custom theme creation and editing keyboard behavior

Current Documentation

The docs currently say:

Use the /theme command, or the theme picker in /config, to choose a Claude Code theme that matches your terminal.

In addition to the built-in presets, /theme lists any custom themes you have defined and any themes contributed by installed plugins. Select New custom theme… at the end of the list to create one interactively: you name the theme, then pick individual color tokens to override. Press Ctrl+E while a custom theme is highlighted to edit it.

The interactive editor in /theme shows the same tokens with a live preview, plus a few single-purpose accents such as onboarding screen colors that are omitted here.

The keyboard shortcuts page also says:

Ctrl+T | Toggle syntax highlighting for code blocks | Only works inside the /theme picker menu.

What's Wrong or Missing?

The current docs explain how to open /theme, create a new custom theme, and edit an existing one, but they do not document how Esc behaves inside the custom-theme UI.

That leaves two documented interactive surfaces without dismissal/cancel guidance:

A. New custom theme dialogs

The docs say to select New custom theme… and describe the creation flow, but they never say that Esc dismisses or cancels those dialogs.

B. Theme color editor

The docs describe the interactive editor and list Ctrl+T as a /theme-specific shortcut, but they do not document that Esc exits the color editor.

Because this behavior was explicitly fixed in v2.1.146, the docs should describe it so users know the supported keyboard interaction instead of discovering it by trial and error.

Suggested Improvement

Add a short keyboard-behavior note anywhere the /theme custom-theme flow is documented.

For example, after the custom-theme creation paragraph in Terminal config:

Press Esc to dismiss the New custom theme… dialogs or leave the color editor without continuing.

Also add an Esc entry to the Interactive mode Theme and display shortcuts table, scoped to the /theme picker and custom-theme editor/dialogs.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 3 pages affected

Version note: The release notes for v2.1.146 explicitly call out a fix for /theme color editor and New custom theme dialogs not responding to Esc.