claude-code - 💡(How to fix) Fix [DOCS] WSL: dragging images from Windows Explorer into Claude Code terminal is undocumented

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Work with images" / "Add an image to the conversation"

Current Documentation

The image workflow docs 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"

Best-practices page similarly says:

Paste images directly. Copy/paste or drag and drop images into the prompt.

The interactive-mode keybinding table says:

Ctrl+V or Cmd+V (iTerm2) or Alt+V (Windows) | Paste image from clipboard

What's Wrong or Missing?

The docs describe image drag-and-drop and clipboard paste generically, but they omit WSL-specific image-handling capabilities shipped in v2.1.157:

A. Drag from Windows Explorer into WSL terminal is undocumented

Claude Code in WSL now supports dragging image files from Windows Explorer into the terminal to add them to the prompt. The existing drag-and-drop description ("Drag and drop an image into the Claude Code window") does not tell WSL users that this works across the Windows/Linux boundary — dragging from Explorer into the WSL terminal window.

B. No platform-specific image-input table

The docs do not distinguish image-input methods by platform. WSL users cannot determine from the docs which image-input paths (paste, drag, file path) are supported in their environment versus native Windows or macOS.

Suggested Improvement

In the "Add an image to the conversation" step on the common-workflows page, add a WSL note after the drag-and-drop step:

WSL2: You can drag image files from Windows Explorer directly into the Claude Code terminal. The file is read from the Windows host and added to the prompt.

Additionally, on the keybindings and interactive-mode pages, clarify that Alt+V image paste works in WSL2 sessions to paste images from the Windows clipboard into Claude Code.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 4 pages affected

Changelog v2.1.157: "WSL: fixed image paste (alt+v keybinding), screenshot paste on Windows 11, and added support for dragging images from Windows Explorer." The drag-from-Explorer feature is new in this version and has no corresponding documentation.

There is an open issue requesting WSL2 clipboard-fallback details for image paste, but it does not cover the drag-from-Windows-Explorer feature added here (different root cause: clipboard path vs. drag-and-drop path).