TL;DR: Ctrl+V usually fails in Claude Code because your terminal grabs the keystroke before Claude Code sees it, or because your screenshot is on a clipboard Claude Code can’t reach. On WSL, update Claude Code and try Alt+V. On Mac, it’s Ctrl+V, never Cmd+V. When nothing works, save the image and give Claude Code the file path. That path always works.
First, what kind of paste is failing?
“Ctrl+V not working” splits into two cases, and they have different causes:
- Text won’t paste. You’re trying to paste a chunk of text and nothing shows up.
- An image won’t paste. You snipped a screenshot and Ctrl+V does nothing, or you get an error.
The image case is by far the more common complaint, so most of this is about that. The last section covers text.
Fix 1: Your terminal is stealing Ctrl+V
This is the big one. Windows Terminal, and plenty of other emulators, bind Ctrl+V to their own paste command. When you press it, the terminal handles the keystroke itself and Claude Code never receives it. The screenshot never gets a chance.
You can confirm this fast: if Ctrl+V pastes text fine but ignores images, your terminal is intercepting the key and doing a text-only paste.
Two ways out:
- Rebind the terminal’s paste shortcut so the key reaches Claude Code.
- Skip the keystroke entirely and use a file path (fix 4). Honestly, this is what I do.
Fix 2: On WSL, update and press Alt+V
If you’re in WSL, your screenshot lives on the Windows clipboard, and for a long time the image arrived across the WSL boundary in a format Claude Code couldn’t decode. A 2026 release added a dedicated shortcut for exactly this.
claude update
Then snip and press Alt+V instead of Ctrl+V. Alt+V reads the Windows clipboard image directly. If your Claude Code predates that release, this is very likely your whole problem.
Fix 3: On Mac, use Ctrl+V, not Cmd+V
Claude Code binds paste to Ctrl+V on every platform, Mac included. Muscle memory says Cmd+V on a Mac, but outside iTerm2 that just does a plain text paste and finds nothing to paste. Press Ctrl+V and most Mac cases resolve instantly.
Invoke is $49 once. Free 7-day trial, all features, no credit card.
Fix 4: The paste that never fails
Stop pasting the image. Claude Code reads image files straight off disk, so hand it a path:
Look at /home/zach/screenshots/bug.png and tell me why the button is misaligned
No terminal keybinding to fight, no clipboard boundary to cross, no format to decode. Works in WSL, over SSH, inside tmux, everywhere Ctrl+V lets you down.
The catch is the manual work: save the snip, find it, type the path. I got tired of doing that dozens of times a day, so Invoke does it in one hotkey. Snip with Win+Shift+S, press your image key, and the file path lands at your cursor in Claude Code. You never touch Ctrl+V again.
When it’s text that won’t paste
If plain text won’t paste either, check these:
- Right-click paste. Some terminals only paste on right-click or Shift+Insert, not Ctrl+V.
- A huge paste is being blocked. Some terminals warn or block very large clipboard contents. Paste in smaller pieces.
- Focus. Make sure the terminal pane actually has focus before you paste.
Related reading
The two-keystroke workflow
Invoke is a dictation app for developers that also solves the paste problem for good. Snip, one hotkey, path in place. Then hold a key and speak your prompt: describe the bug out loud, release, and it lands in Claude Code. $49 once. Free 7-day trial.