claude-code - 💡(How to fix) Fix [DOCS] Interactive mode docs don't clarify that pasted text starting with `/` is treated as literal input [1 participants]

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+V or Cmd+V (iTerm2) or Alt+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:

1. 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.

2. How to submit pasted text: Press Enter to 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.