[DOCS] Interactive mode docs don't clarify that pasted text starting with `/` is treated as literal input
Documentation Type
Other
Documentation Location
https://code.claude.com/docs/en/interactive-mode
Section/Topic
"Paste image from clipboard" shortcut row (line 34), or a new section on pasting text vs. invoking commands
Current Documentation
The Interactive mode keyboard shortcut table shows:
Ctrl+VorCmd+V(iTerm2) orAlt+V(Windows) | Paste image from clipboard | Inserts an[Image #N]chip at the cursor...
The table only documents image pasting. There is no documentation of what happens when you paste text (plain text, not an image) into the prompt — particularly when that text begins with /.
What's Wrong or Missing?
In versions before v2.1.132, pasting text that started with / (for example, a file path, shell snippet, or plain text that happened to begin with /) could behave unexpectedly:
- The pasted input was silently swallowed and never sent to Claude
- Or the application treated it like a slash command invocation and replied with an "Unknown command" error
As of v2.1.132, that broken behavior is fixed. The docs still do not explain what users should expect when they paste plain text that begins with /.
What should be documented
The Interactive mode page should clarify:
- Pasting text vs. invoking commands: When you paste plain text (as opposed to an image), the content is inserted into the prompt instead of being swallowed or misparsed as a slash command.
- How to submit pasted text: Press
Enterto send the pasted content after it is inserted.
This behavior is now consistent with what most users would expect, but without explicit documentation users who encountered the pre-v2.1.132 bug may still believe that pasting /something is unsafe or behaves differently from typing it.
Suggested Improvement
Add a clarification note to the Ctrl+V / Cmd+V shortcut row in interactive-mode:
| `Ctrl+V` or `Cmd+V` (iTerm2) or `Alt+V` (Windows) | Paste from clipboard | Text: inserts content into the prompt, even when it begins with `/`. Image: inserts an `[Image #N]` chip at the cursor so you can reference it positionally in your prompt |
Alternatively, add a brief "Pasting text" subsection under a new or existing section that explains how pasted plain text is handled vs. typed input.
Impact
High - Prevents users from completing a task
Additional Context
Changelog entry (v2.1.132):
Fixed pasting text starting with / silently swallowing the input or triggering an unknown-command reply
Related entries in same version:
- "Added a 'Pasting…' footer hint while a Ctrl+V image paste is being read from the clipboard" — same version adds a visual indicator for image paste; text paste behavior fix is in the same release
- "Fixed pasting dumping stray escape sequences into the prompt when focus events or mouse-tracking reports interleave with the bracketed paste" — related paste fix in v2.1.132
No prior docs coverage: No page in docs/code.claude.com/ documents the behavior of pasting plain text vs. invoking slash commands. The slash-commands.md page only covers how commands are invoked via typing, not the paste scenario.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗