[BUG] Ctrl+V image paste in iTerm2 intermittently fails on macOS (still reproducible in v2.1.62)
Resolved 💬 6 comments Opened Feb 27, 2026 by zelentsov-dev Closed Apr 8, 2026
Environment
| Component | Version |
|---|---|
| Claude Code | 2.1.62 |
| iTerm2 | 3.6.7 |
| macOS | Darwin 25.3.0 |
| Node.js | 25.6.1 |
Description
\Ctrl+V\ image paste into Claude Code TUI works intermittently — it succeeds roughly 50-60% of the time. There is no visual feedback or error when it fails; the image is silently dropped and the input field remains empty.
This issue was previously tracked in #1361 and closed as completed, but the problem persists in v2.1.62 with iTerm2 3.6.7.
Steps to Reproduce
- Take a screenshot using \
Cmd+Ctrl+Shift+4\(copies to clipboard) - Open Claude Code in iTerm2
- Click in the input field to ensure focus
- Press \
Ctrl+V\ - Observe: image is pasted ~50-60% of the time; the rest of the time nothing happens
Expected Behavior
\Ctrl+V\ should reliably paste the image from clipboard every time.
Actual Behavior
Image paste silently fails intermittently. No error message, no feedback. The input field stays empty as if \Ctrl+V\ was never pressed.
Additional Notes
- Clicking the input field before \
Ctrl+V\improves reliability but does not fully resolve the issue - Drag & drop of image files works reliably as a workaround
- \
Cmd+V\does not work for images at all in iTerm2 (separate known issue) - The intermittent nature suggests a race condition or focus management issue in the TUI clipboard event handling
Related Issues
- #1361 — Original report (closed as completed, issue persists)
- #16753 — Cmd+V paste broken in iTerm2 on v2.1.0
- #5392 — Clipboard image paste broken on Mac Terminal
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗