## Description After updating to 2.1.0, paste keyboard shortcuts no longer work in iTerm2 on macOS. ## Behavior - **Cmd+V**: Inserts literal 'v' instead of pasting - **Ctrl+V**: Does not work - **Alt+V**: Does not work - **Right-click paste**: Works correctly ## Environment - Claude Code version: 2.1.0 - Terminal: iTerm2 - OS: macOS ## Workaround Downgrading to 2.0.76 resolves the issue. ## Likely Cause This appears to be a regression from the 2.1.0 change: "Added Cmd+V support for imag

I'm experiencing the same issue. - Environment: macOS + iTerm2 - Claude Code version: 2.1.12 - Symptom: Image paste via Cmd+V doesn't work. - Ctrl+V works fine as a workaround. - Cmd+V used to work for image pasting in previous versions.

Cmd+V paste broken in iTerm2 on 2.1.0

Status Closed — not planned

Reported on v2.0.76

Maintainer reply None cached

Workaround ✓ Mentioned in thread ↓

Activity 11 comments · opened Jan 8, 2026 · closed Mar 1, 2026

Description

After updating to 2.1.0, paste keyboard shortcuts no longer work in iTerm2 on macOS.

Behavior

Cmd+V: Inserts literal 'v' instead of pasting
Ctrl+V: Does not work
Alt+V: Does not work
Right-click paste: Works correctly

Environment

Claude Code version: 2.1.0
Terminal: iTerm2
OS: macOS

Workaround

Downgrading to 2.0.76 resolves the issue.

Likely Cause

This appears to be a regression from the 2.1.0 change: "Added Cmd+V support for image paste in iTerm2 (maps to Ctrl+V)"

View original on GitHub ↗

11 Comments

MertKarakayaPhD · 7 months ago

Does not work with Terminal or PowerShell on Windows either, cannot paste.

gentksb · 7 months ago

2.1.1 too on WSL2 Ubuntu on Windows Terminal

kuzmeech · 7 months ago

Same issue here on macOS with Russian keyboard layout (Ghostty terminal).

Both Ctrl+V (image paste) and Ctrl+C (abort/interrupt) don't work when the Russian layout is active (worked fine in 2.0.x).

Since the input layer sees Cyrillic 'м'/'с' instead of Latin 'v'/'c', the shortcuts are not recognized.

Version: 2.1.1
Downgrading to 2.0.76 confirms this is a 2.1.x regression.

marcbowes · 7 months ago

I think it's something to do with Cmd specifically because other iTerm2 features like splits (which are bound to Cmd by default) also don't work anymore for me, unless I use the mouse.

amsminn · 7 months ago

I'm experiencing the same issue.

Environment: macOS + iTerm2
Claude Code version: 2.1.12
Symptom: Image paste via Cmd+V doesn't work.
Ctrl+V works fine as a workaround.
Cmd+V used to work for image pasting in previous versions.

marcbowes · 7 months ago

That's a different issue to what I've reported here.

For my issue, I found I had the right-cmd key mapped to 'meta' in iTerm2. This allows some shortcuts like cmd-b to go backward a word. If I set that to 'normal', then cmd shortcuts work again. (But ruin my muscle memory.)

witqq · 7 months ago

Workaround for Russian keyboard layout in iTerm2:

You can add custom key mappings in iTerm2 to make Ctrl shortcuts work with Russian layout:

Settings → Profiles → Keys → Key Mappings → +

Add these mappings (Action: "Send Hex Code"):

| Keyboard Shortcut | Hex Code |
|-------------------|----------|
| Ctrl+с (Russian) | 0x03 |
| Ctrl+м (Russian) | 0x16 |
| Ctrl+г (Russian) | 0x15 |
| Ctrl+л (Russian) | 0x0B |

These map Russian letters on the same physical keys as Latin equivalents:

с → c (Ctrl+C = 0x03)
м → v (Ctrl+V = 0x16)
г → u (Ctrl+U = 0x15)
л → k (Ctrl+K = 0x0B)

Tested and working on iTerm2 + macOS.

kuzmeech · 7 months ago

Workaround for Ghostty:

Add to ~/.config/ghostty/config:

# Ctrl+C/V fix for Russian keyboard layout
# Physical keys work regardless of current layout
keybind = ctrl+key_c=text:\x03
keybind = ctrl+key_v=text:\x16

key_c, key_v are W3C physical key codes (key position, not character)
\x03 = ^C (SIGINT)
\x16 = ^V (paste)

Reload config: Cmd+Shift+, (or restart Ghostty)

This works because Ghostty intercepts keys at IOKit level before the OS keyboard layout is applied.

Thanks @witqq for the iTerm2 idea — same principle applies here!

github-actions[bot] · 6 months ago

Closing for now — inactive for too long. Please open a new issue if this is still relevant.

eduwass · 6 months ago

Weird, I just added this in iTerm's Settings > Keys and it seems to do the trick.

Can now paste with cmd+v in iterm no problem.

PS: In my case working with spanish keyboard using US layout.

github-actions[bot] · 5 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.