[DOCS] Interactive mode docs missing Claude's proactive suggestion of ! bash mode

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

"Bash mode with ! prefix" section

Current Documentation

The current bash mode documentation describes it as a user-initiated feature:

"Run bash commands directly without going through Claude by prefixing your input with !"

The section covers the ! prefix syntax, what bash mode does (adds to context, real-time output, Ctrl+B backgrounding), history-based autocomplete, and exit methods. It does not mention Claude proactively suggesting bash mode.

What's Wrong or Missing?

Changelog v2.1.81: "Improved ! bash mode discoverability — Claude now suggests it when you need to run an interactive command."

The docs describe bash mode only as something users discover and use on their own. With v2.1.81, Claude actively suggests using ! bash mode when it detects the user needs to run an interactive command. This proactive suggestion behavior is not documented, making the docs incomplete about how users discover the feature.

Suggested Improvement

Add a bullet or note to the "Bash mode with ! prefix" section:

Tip: Claude will suggest using ! bash mode when it detects you need to run an interactive command that requires direct terminal access.

This helps users understand that bash mode is not only manually invoked but also contextually suggested by Claude.

Impact

Low - Minor confusion or inconvenience

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | "Bash mode with ! prefix" section (line ~228) |

Total scope: 1 page affected

Source: Changelog v2.1.81 — "Improved ! bash mode discoverability — Claude now suggests it when you need to run an interactive command"