claude-code - 💡(How to fix) Fix [DOCS] Image paste from clipboard lacks loading/feedback indicator [1 participants]

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Keyboard shortcuts table — image paste rows (Ctrl+V / Cmd+V / Alt+V)

Current Documentation

The keyboard shortcuts table at https://code.claude.com/docs/en/interactive-mode describes image paste with:

Ctrl+V or Cmd+V (iTerm2) or Alt+V (Windows) | Paste image from clipboard | Inserts an [Image #N] chip at the cursor so you can reference it positionally in your prompt

This describes the end result but omits the loading experience. When a user pastes a large image from the clipboard with Ctrl+V, there is no feedback in the UI while the image data is being read — the cursor simply sits idle until the [Image #N] chip appears moments later. Users on slower machines or with large images cannot tell whether the operation is in progress or has silently failed.

What's Wrong or Missing?

A. No loading feedback during image paste

When pasting an image from the clipboard, especially a large one, the UI gives no indication that the paste is in progress. The prompt area shows nothing until the [Image #N] chip materializes, which can take several seconds on large images or over slow connections (e.g., SSH, remote containers).

B. Footer hint not documented

v2.1.132 added a "Pasting…" footer hint to communicate that an image paste is in progress, but this UI element is not documented anywhere — neither in the interactive-mode page nor in the status-line customisation docs. A user who relies on documented behaviour has no way to know this feedback exists.

Suggested Improvement

Add a note to the keyboard shortcuts table row for Ctrl+V / Cmd+V / Alt+V image paste in https://code.claude.com/docs/en/interactive-mode:

> **Note:** Large image pastes may take a moment to process. A "Pasting…" footer hint appears while the image is being read from the clipboard.

Alternatively, expand the "Context" column description to include the loading feedback. This helps users understand what to expect and reduces support queries about "frozen" or unresponsive paste behaviour.

Impact

Medium - Makes feature difficult to understand

Additional Context

Changelog entry (v2.1.132):

Added a "Pasting…" footer hint while a Ctrl+V image paste is being read from the clipboard

Affected Pages:

Total scope: 1 page