[BUG] Can't paste image from clipboard on Linux (Ubuntu)

Found 2 possible duplicate issues:

1. https://github.com/anthropics/claude-code/issues/1361
2. https://github.com/anthropics/claude-code/issues/834

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

This was working for me until this latest update. Ubuntu

can confirm the issue System: Ubuntu 25.04 + KDE (Wayland).

can confirm same issue on Arch 6.16.10

I have same issue with Sway on NixOS. wl-paste shows the contents properly but claude code (v2.0.1) cannot find image from clipboard.

❯ wl-paste --list-types            
image/png
❯ wl-paste | hexyl -n50 
┌────────┬─────────────────────────┬─────────────────────────┬────────┬────────┐
│00000000│ 89 50 4e 47 0d 0a 1a 0a ┊ 00 00 00 0d 49 48 44 52 │×PNG__•_┊⋄⋄⋄_IHDR│
│00000010│ 00 00 01 1b 00 00 03 b6 ┊ 08 02 00 00 00 57 52 a4 │⋄⋄••⋄⋄•×┊••⋄⋄⋄WR×│
│00000020│ 6f 00 00 20 00 49 44 41 ┊ 54 78 9c ec 9d 77 78 14 │o⋄⋄ ⋄IDA┊Tx×××wx•│
│00000030│ 47 9a                   ┊                         │G×      ┊        │
└────────┴─────────────────────────┴─────────────────────────┴────────┴────────┘

Same issue on Arch Linux, Wayland (Hyprland) and the Kitty Terminal. I can paste images when running Claude Code inside VScode.

Same here on up-to-date Arch linux, KDE plasma using wayland and konsole terminal emulator. Fairly basic setup.

Same using Fedora 42 KDE, Konsole.

Gentoo -> Wayland -> Hyprland with Alacritty. Same issue. wl-paste shows things are correct, the same as Jaakkonen above.

CONGRATULATIONS : i successfully resolved the issue. basically using ubuntu in wayland makes the image paste by CTRL+V work in claude code while in X11 does not work.

i am using this and it worked for me https://gist.github.com/chmouel/d2dd4ebea0782ce61d93e1d22a9995cf on wayland/kitty

i've got a workaround where a different keybinding that screenshots and copies the path to clipboard and then claude reads from specified path

Same here facing this issue , im on ubuntu with x11 after the latest update

Any updates? I use copyq, cannot paste image with ctrl+v.

For Ubuntu users who have issues pasting images into Claude Code from the clipboard:
In version 2.0.52, this was already addressed:

Fixed image pasting not working on Linux systems running Wayland (now falls back to wl-paste when xclip is unavailable)

However, if image pasting still does not work for you, simply installing xclip usually fixes the issue:

sudo apt install xclip

For Ubuntu users who have issues pasting images into Claude Code from the clipboard: In version 2.0.52, this was already addressed: Fixed image pasting not working on Linux systems running Wayland (now falls back to wl-paste when xclip is unavailable) However, if image pasting still does not work for you, simply installing xclip usually fixes the issue: sudo apt install xclip

This fixed the issue for me on Manjaro, thanks!

For Ubuntu users who have issues pasting images into Claude Code from the clipboard: In version 2.0.52, this was already addressed: Fixed image pasting not working on Linux systems running Wayland (now falls back to wl-paste when xclip is unavailable) However, if image pasting still does not work for you, simply installing xclip usually fixes the issue: sudo apt install xclip

this worked on ubuntu on x11 aswell, FINALLY!

I'm using Claude 2.0.75 on KDE Neon 6.2, X11. Even with xclip, pasting images still doesn't work for me in Konsole :(

I'm using Claude 2.0.75 on KDE Neon 6.2, X11. Even with xclip, pasting images still doesn't work for me in Konsole :(

Have you tried with wl-paste maybe?

> I'm using Claude 2.0.75 on KDE Neon 6.2, X11. Even with xclip, pasting images still doesn't work for me in Konsole :( Have you tried with wl-paste maybe?

wl-paste is for wayland, no? Not X11....?

@sinnick this worked for me on Ubuntu. Thanks!

@sinnick this worked for me on Ubuntu. Thanks!

That was my hint actually 🥇

@lizozom are you using X11 or Wayland? It's still broken for me on X11, even with that installed

@lizozom are you using X11 or Wayland? It's still broken for me on X11, even with that installed

what terminal are you using? for me it works using ghostty on Ubuntu 24.04

> @lizozom are you using X11 or Wayland? It's still broken for me on X11, even with that installed what terminal are you using? for me it works using ghostty on Ubuntu 24.04

Konsole (mentioned above - same as the OP)

For Ubuntu users who have issues pasting images into Claude Code from the clipboard: In version 2.0.52, this was already addressed: Fixed image pasting not working on Linux systems running Wayland (now falls back to wl-paste when xclip is unavailable) However, if image pasting still does not work for you, simply installing xclip usually fixes the issue: sudo apt install xclip

this worked on Ubuntu 24.04.3 LTS

Working fix for Ubuntu users

I am on Ubuntu 24.04.3 LTS, and I was also unable to paste screenshots into Claude Code. The terminal kept saying no image found, even though the image was in my clipboard.

Running the following command fixed the issue for me:

sudo apt install xclip

After installing xclip, I can paste screenshots again with Ctrl + V without saving or dragging files.

So if you are on Linux and paste is not working, try installing xclip first. It solves the problem instantly on my machine.

sudo apt install xclip This works for me (Ubuntu 24.04, X11)

If you're using x11 then xclip is needed and if you're on wayland then wl-clipboard would help. Here's a quick one-liner

if [[ "$XDG_SESSION_TYPE" == "wayland" || -n "$WAYLAND_DISPLAY" ]]; then
  sudo apt install -y wl-clipboard; else sudo apt install -y xclip; fi

doesn't work for me on x11 even with xclip installed.

for me Ctrl + Shift + v did the trick, instead of Ctrl + v only

for me Ctrl + Shift + v did the trick, instead of Ctrl + v only

At last - confirmed, this was the solve. ClaudeCode must be intercepting the key commands in a weird way tho, because Konsole doesn't have Ctrl+Shift+V mapped to anything (only Ctrl+V is mapped to paste):

<img width="459" height="256" alt="Image" src="https://github.com/user-attachments/assets/d36a0be1-6381-409f-a6bc-54184b4d24e0" />

Would be nice if they'd fix this given how many different issues there are here about not being able to paste images.

can confirm it still happens on ubuntu

If you're using x11 then xclip is needed and if you're on wayland then wl-clipboard would help. Here's a quick one-liner if [[ "$XDG_SESSION_TYPE" == "wayland" || -n "$WAYLAND_DISPLAY" ]]; then sudo apt install -y wl-clipboard; else sudo apt install -y xclip; fi

For wayland wl-clipboard was the answer. Now I can paste images again in konsole. Thanks.

sudo apt install -y wl-clipboard

If you're using x11 then xclip is needed and if you're on wayland then wl-clipboard would help. Here's a quick one-liner if [[ "$XDG_SESSION_TYPE" == "wayland" || -n "$WAYLAND_DISPLAY" ]]; then sudo apt install -y wl-clipboard; else sudo apt install -y xclip; fi

work on Ubuntu 24.04.4 LTS

same issue, debian testing, GNOME 50, ddterm

If you're using x11 then xclip is needed and if you're on wayland then wl-clipboard would help. Here's a quick one-liner ``bash if [[ "$XDG_SESSION_TYPE" == "wayland" || -n "$WAYLAND_DISPLAY" ]]; then sudo apt install -y wl-clipboard; else sudo apt install -y xclip; fi ``

Worked for me, thank you!

If you're SSH'd from macOS into Linux: clipaste v2.1.0 bridges your local clipboard to the remote server.

# On your Mac
brew install hqhq1025/clipaste/clipaste && brew services start clipaste
clipaste ssh-setup user@your-linux-server

After setup, Ctrl+V in remote Claude Code fetches the screenshot through an SSH tunnel. No X11 or display server needed.

If you're using x11 then xclip is needed and if you're on wayland then wl-clipboard would help. Here's a quick one-liner if [[ "$XDG_SESSION_TYPE" == "wayland" || -n "$WAYLAND_DISPLAY" ]]; then sudo apt install -y wl-clipboard; else sudo apt install -y xclip; fi

Worked for me on Pop!_OS 22.04

Thanks :)

Cheers jod-alef!

I installed wl-clipboard and it works on Ubuntu 24. Recently, upgrade to Ubuntu 26, it stops working.

EDIT: don't know how ubuntu (or claude code) fixed itself later. I only lock the screen and go for lunch, and it works again now.

The problem is not the fact that CC requires xclip; the problem is that the error message is wrong. It should be "xclip is required to paste images. Please install it."