[DOCS] Pasted images now insert an `[Image #N]` chip at cursor — docs don't describe this positional-reference behavior

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

interactive-mode.md — "General controls" keyboard shortcuts table (the Ctrl+V / Cmd+V / Alt+V row)
common-workflows.md — "Work with images" section, tips block

Current Documentation

interactive-mode.md (General controls table):

| Ctrl+V or Cmd+V (iTerm2) or Alt+V (Windows) | Paste image from clipboard | Pastes an image or path to an image file |

common-workflows.md (Work with images — Tips):

* When Claude references images (for example, [Image #1]), Cmd+Click (Mac) or Ctrl+Click (Windows/Linux) the link to open the image in your default viewer

What's Wrong or Missing?

As of v2.1.83, pasting an image no longer just silently attaches the image — it inserts an [Image #N] chip at the cursor position in the prompt input. This chip lets users reference images positionally within their prompt text (e.g., "Fix the layout shown in [Image #1] and apply the palette from [Image #2]").

Neither page documents this behavior:

1. interactive-mode.md describes the paste shortcut only as "Pastes an image or path to an image file." It does not mention that an [Image #N] chip is inserted at the cursor, making images referenceable by position within the prompt.

1. common-workflows.md mentions [Image #1] only in the context of Claude's output ("When Claude references images…"), which is misleading now that the chip also appears in the input prompt as a positional placeholder the user can embed deliberately.

Users who paste multiple images have no documentation telling them they can use [Image #1], [Image #2], etc. in their prompt text to refer to specific images by position.

Suggested Improvement

interactive-mode.md — update the Ctrl+V row description:

Pastes an image or path to an image file and inserts an [Image #N] chip at the cursor. Use the chip label in your prompt to reference images positionally (e.g., "describe [Image #1] and compare it with [Image #2]").

common-workflows.md — split the existing tip into two distinct bullets to clarify input vs. output usage:

When you paste an image, an [Image #N] chip is inserted at the cursor in your prompt. You can use these labels to reference multiple images positionally — e.g., "Fix the layout in [Image #1] using the colors from [Image #2]." When Claude references images in its responses (for example, [Image #1]), Cmd+Click (Mac) or Ctrl+Click (Windows/Linux) the link to open the image in your default viewer.

Impact

Medium - Makes feature difficult to understand

Additional Context

Source: Changelog v2.1.83 — "Pasted images now insert an [Image #N] chip at the cursor so you can reference them positionally in your prompt"

Affected pages:

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

Related earlier changelog entry (for context): v2.1.56 added clickable [Image #N] links that open attached images in the default viewer — the common-workflows.md tip documents that older behavior but not the new input-chip behavior.