[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

  1. Take a screenshot using \Cmd+Ctrl+Shift+4\ (copies to clipboard)
  2. Open Claude Code in iTerm2
  3. Click in the input field to ensure focus
  4. Press \Ctrl+V\
  5. 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

View original on GitHub ↗

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