[DOCS] Interactive mode docs omit `respondToBashCommands` opt-out for `!` commands

Open 💬 0 comments Opened Jun 22, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Shell mode with ! prefix"

Current Documentation

The Shell mode section currently says:

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

It then says shell mode:

"Adds the command and its output to the conversation context"

The settings reference lists defaultShell, but it does not list respondToBashCommands.

What's Wrong or Missing?

Claude Code v2.1.186 changed ! bash command behavior so Claude responds to the output automatically. Users can set "respondToBashCommands": false in settings.json to keep the previous context-only behavior.

The docs describe the older context-add behavior and omit both the new automatic response behavior and the opt-out setting.

Suggested Improvement

Update the Shell mode section to explain the new default:

  • ! commands run directly in the shell.
  • Their output is added to the conversation context.
  • Claude responds to the command output automatically by default.

Add the opt-out setting:

{
  "respondToBashCommands": false
}

Also add respondToBashCommands to the settings reference near defaultShell, with the default value and a link back to Shell mode.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | Shell mode behavior |
| https://code.claude.com/docs/en/settings | Missing respondToBashCommands setting reference |

Total scope: 2 pages affected

View original on GitHub ↗