[DOCS] Inaccurate instruction regarding image pasting (Cmd+V support) in Common Workflows

Resolved 💬 4 comments Opened Jan 19, 2026 by coygeek Closed Feb 27, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Section: Work with images -> Step 1: "Add an image to the conversation"

Current Documentation

2. Copy an image and paste it into the CLI with ctrl+v (Do not use cmd+v)

What's Wrong or Missing?

The documentation explicitly advises against using Cmd+V for pasting images. This contradicts recent updates found in the Changelog, which indicate that support for Cmd+V (⌘+V) has been implemented for specific environments on macOS.

According to the Changelog:

  • v2.1.0: "Added Cmd+V support for image paste in iTerm2 (maps to Ctrl+V)"
  • v1.0.61: "IDE: Added support for pasting images in VSCode MacOS using ⌘+V"

Telling users "Do not use cmd+v" is now incorrect for users on iTerm2 or VS Code on macOS.

Suggested Improvement

The instruction should be updated to reflect that Cmd+V is supported in certain terminals.

Suggested text:

2. Copy an image and paste it into the CLI with Ctrl+V (or Cmd+V in supported terminals like VS Code and iTerm2).

Impact

High - Prevents users from using a feature

Additional Context

Reference to Changelog entries confirming the feature support:

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗