[FIXED] Ctrl+V paste fails in Claude Code over SSH (Windows → Linux)
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?
Fix (tested and confirmed working)
Note: this fix requires disabling Claude Code's fullscreen TUI mode.
Text paste over SSH does not work correctly while "tui": "fullscreen"
is set — this is part of the root cause, not just an unrelated setting.
On the remote Linux host:
- Check current version and config location:
which claude
claude --version
find /home/YOUR_USER/.claude -maxdepth 2 -type f | sort
- Inspect the current config:
sed -n '1,140p' /home/YOUR_USER/.claude/keybindings.json
sed -n '1,120p' /home/YOUR_USER/.claude/settings.json
- Back up both files before making changes:
cp /home/YOUR_USER/.claude/keybindings.json /home/YOUR_USER/.claude/keybindings.json.before-ctrlv-fix-20260930
cp /home/YOUR_USER/.claude/settings.json /home/YOUR_USER/.claude/settings.json.before-tui-paste-fix-20260930
- Remove the ctrl+v → image paste binding:
perl -0pi -e 's/"ctrl\+v": "chat:imagePaste"/"ctrl+v": null/' /home/YOUR_USER/.claude/keybindings.json
- Edit settings.json to remove the fullscreen TUI setting — change:
{ "tui": "fullscreen" }
to:
{}
- Validate both JSON files are still well-formed:
python3 -m json.tool /home/YOUR_USER/.claude/keybindings.json
python3 -m json.tool /home/YOUR_USER/.claude/settings.json
- Run diagnostics:
claude doctor
- Fully quit and relaunch the claude CLI for the changes to take effect.
Result: Ctrl+V no longer triggers the image-paste message. For actual
text paste over SSH, use a terminal-level shortcut instead:
Ctrl+Shift+V, Shift+Insert, or right-click paste — these now work
correctly in the non-fullscreen TUI mode.
What Should Happen?
Plain text copied on the Windows client should paste normally into the
Claude Code prompt when connected over SSH, the same way it does in the
surrounding shell.
Error Messages/Logs
No image found in clipboard. You're SSH'd; try scp?
Steps to Reproduce
- From a Windows client, connect to a remote Linux host via SSH:
ssh user@remote-linux-host
- On the remote host, run: claude
- On the Windows client, copy some plain text to the clipboard
(e.g. select text in Notepad, Ctrl+C)
- In the Claude Code prompt, press Ctrl+V
Expected: the copied text is pasted into the prompt.
Actual: "No image found in clipboard. You're SSH'd; try scp?" is
displayed and nothing is pasted.
Root cause
Two local config settings on the remote host cause Claude Code to
intercept Ctrl+V for image-paste handling instead of passing it through
to normal terminal paste — see Fix section above for details.
Claude Model
None
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.1.285 (Claude Code)
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
Windows Terminal
Additional Information
Confirmed workaround/fix: On the remote host, edit ~/.claude/keybindings.json
to set "ctrl+v": null (removing the "ctrl+v": "chat:imagePaste" binding),
and remove "tui": "fullscreen" from ~/.claude/settings.json. Restart the
claude CLI. After this, Ctrl+Shift+V, Shift+Insert, and right-click paste
work correctly for plain text over SSH.
<img width="720" height="424" alt="Image" src="https://github.com/user-attachments/assets/de11c3f9-4eea-49da-b7a5-2bccad5d42d4" />