[DOCS] Interactive mode docs omit `respondToBashCommands` opt-out for `!` commands
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