[BUG] [Linux] xclip undeclared dependency: Ctrl+V image paste silently fails without it

Resolved 💬 3 comments Opened May 16, 2026 by 6leonardo Closed May 20, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

Environment

  • OS: Kali Linux (XFCE, X11)
  • Claude Code version: latest

Bug
On Linux/X11, Ctrl+V image paste silently fails with no error message
if xclip is not installed. Claude Code uses xclip internally but does
not declare it as a dependency and gives no feedback when it is missing.

Fix
Installing xclip resolves the issue immediately:
sudo apt install xclip

Note: OpenAI Codex CLI handles clipboard images correctly on the same
system without requiring xclip as a separate install, suggesting this
is an avoidable dependency.

What Should Happen?

Either paste works, or an explicit error like
"xclip not found, install with: sudo apt install xclip"

Error Messages/Logs

Steps to Reproduce

  1. Use a Linux system without xclip installed
  2. Copy any image to clipboard
  3. Open Claude Code and press Ctrl+V
  4. Nothing happens — no error, no message

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.1.143 (Claude Code)

Platform

Anthropic API

Operating System

Ubuntu/Debian Linux

Terminal/Shell

Other

Additional Information

_No response_

View original on GitHub ↗

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