[DOCS] WSL2 image paste docs omit Windows clipboard fallback details

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Work with images"

Current Documentation

The docs currently say:

You can use any of these methods: 1. Drag and drop an image into the Claude Code window 2. Copy an image and paste it into the CLI with ctrl+v (Do not use cmd+v) 3. Provide an image path to Claude. E.g., "Analyze this image: /path/to/your/image.png"

And the keyboard shortcut docs say:

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

What's Wrong or Missing?

These pages document image paste generically, but they do not mention the WSL2-specific behavior shipped in v2.1.136: Claude Code can paste images copied on the Windows side into a WSL2 session, and it uses a PowerShell fallback when xclip / wl-paste cannot read the image data.

Without that note, WSL2 users cannot tell whether Windows-to-WSL image paste is officially supported, what clipboard path Claude Code uses, or why paste may still work even when Linux clipboard helpers cannot read the image.

Suggested Improvement

Add a short WSL2 note anywhere the docs describe image pasting from the clipboard. For example, after the existing paste step:

WSL2: You can paste images copied in Windows into a Claude Code session running inside WSL2. If Linux clipboard helpers such as xclip or wl-paste cannot read the image data, Claude Code falls back to the Windows clipboard via PowerShell.

Also add the same note or a cross-reference on the keyboard shortcut pages so Windows/WSL users see that the documented image-paste shortcut applies to WSL2 sessions too.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/common-workflows | 300-304 | "Work with images" says to paste with Ctrl+V but does not mention WSL2 or the Windows clipboard fallback |
| https://code.claude.com/docs/en/interactive-mode | 34 | Keyboard shortcut table lists image paste from clipboard but has no WSL2-specific guidance |
| https://code.claude.com/docs/en/keybindings | 117 | chat:imagePaste lists the shortcut only, with no WSL2 behavior note |

Total scope: 3 pages affected

Version context: The missing behavior note is relevant to v2.1.136.