Feature Request: Support pasting images from clipboard on Linux (Wayland/X11)

Resolved 💬 3 comments Opened Nov 26, 2025 by gussvill Closed Nov 30, 2025

Summary

Currently, Claude Code CLI on macOS supports pasting images directly from the clipboard, but this feature is not available on Linux (both X11 and Wayland sessions).

Problem

When using Claude Code on Linux, users cannot paste images from the clipboard directly into the conversation. This creates friction in the workflow, especially when:

  • Sharing screenshots for debugging
  • Pasting images copied from browsers or other applications
  • Quick visual context sharing without saving files first

Current Workaround

Users must:

  1. Save the image to a file manually (using wl-paste on Wayland or xclip on X11)
  2. Reference the file path in Claude Code

Proposed Solution

Add clipboard image support for Linux by:

  1. Detecting the session type (Wayland vs X11)
  2. Using appropriate clipboard tools:
  • Wayland: wl-paste --type image/png
  • X11: xclip -selection clipboard -t image/png -o
  1. Allow users to paste images with a keyboard shortcut or command

Environment

  • OS: Linux (Arch Linux, tested on KDE Plasma 6.5.3 with Wayland)
  • Claude Code Version: v2.0.52
  • Session Type: Wayland (also affects X11 users)

Additional Context

macOS achieves this through pbpaste integration. Similar functionality could be implemented for Linux using the standard clipboard tools that are commonly available or easily installable (wl-clipboard for Wayland, xclip/xsel for X11).

This would significantly improve the developer experience on Linux and bring feature parity with macOS.

---
Submitted via Claude Code CLI

View original on GitHub ↗

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