[BUG] [Linux] xclip undeclared dependency: Ctrl+V image paste silently fails without it
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
- Use a Linux system without xclip installed
- Copy any image to clipboard
- Open Claude Code and press Ctrl+V
- 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_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗