在 Claude Code CLI 里粘贴图片：Windows 下请用 Alt+V
在 Claude Code CLI 里粘贴图片：Windows 下请用 Alt+V
我是 Windows 用户，平时习惯用 Windows Terminal + GitBash 启动 claude code CLI。前阵子想丢一张截图给 Claude 看看，Win + Shift + S 截图，切回窗口 Ctrl + V 一按——毫无反应。换成微信截图、QQ 截图，统统粘不进去，输入框干干净净，就像我什么都没按。
折腾了好一阵子才搞明白：这个场景下，粘贴图片要用 Alt + V，Ctrl + V 只粘贴纯文本。
一句话结论先放在这：在 Windows 下，Ctrl + V 粘贴的是文本，Alt + V 才是粘贴图片的快捷键。
一、先看结论：Ctrl+V 和 Alt+V 到底差在哪
| 快捷键 | 作用 | 谁来处理 | 能粘图片吗 |
|---|---|---|---|
Ctrl + V | 粘贴纯文本 | Windows Terminal / GitBash 终端 | ❌ 不能 |
Alt + V | 粘贴图片 | Claude Code 自己 | ✅ 能 |
也就是说，不管你用的是 Windows 自带截图（Win + Shift + S）、微信、QQ 还是 Snipaste，只要图片进了系统剪贴板，统一用 Alt + V 粘进 Claude Code 就对了。
二、问题现象：我踩过的坑
最开始我以为是某个环节出了毛病，挨个怀疑了一遍：
- 是截图工具没把图放进剪贴板？—— 不是，截图后在画图里
Ctrl + V能正常贴出来。 - 是 GitBash 不支持？—— 也不是，文本
Ctrl + V粘得好好的。 - 是 Claude Code 压根不支持粘图片？—— 更不是，明明看到别人在用。
表现就是：截图后按 Ctrl + V，要么输入框纹丝不动，要么 Claude Code 提示”剪贴板里没有图片”。一度以为是玄学。
三、根本原因：为什么 Ctrl+V 粘不进图片
搞懂原理之后就不玄学了，关键在于按键被谁拦截。
Ctrl + V 这个组合，在你按下的一瞬间，就被 Windows Terminal（或 GitBash 的终端层）抢先处理了。终端把它理解为”粘贴剪贴板里的文本“，于是按文本的方式去读剪贴板。可截图是二进制的图片数据，终端按文本读，要么啥也读不出来，要么读出一堆乱码然后丢弃——图片根本传不到 Claude Code 手里。
而 Alt + V 是 Claude Code 这个 TUI 程序自己注册的快捷键。按下 Alt + V 时，由 Claude Code 直接去读系统剪贴板里的图片数据，绕过了终端的文本粘贴逻辑，图片这才顺利进来。
一句话总结：Ctrl + V 走的是”终端粘贴文本”这条路，Alt + V 走的是”Claude Code 直接读剪贴板图片”这条路，两条路根本不是一回事。
四、正确姿势：Alt+V 完整流程
- 用任意截图工具截图（
Win + Shift + S/ 微信 / QQ / Snipaste……），图片进入系统剪贴板。 - 切到 claude code CLI 窗口，光标停在输入框里。
- 按
Alt + V。 - 输入框会出现一个图片占位标记（比如
[Image]或缩略图），说明图片已经附上了。 - 补上你想问的问题，回车发送。
下图就是按下 Alt + V 之后的样子：输入框里出现了 [Image] 占位标记，说明图片已经成功附上了。
有个小提醒：按 Alt + V 之前，别再 Ctrl + C / Ctrl + V 别的东西，否则剪贴板会被覆盖，刚截的图就没了，得重新截。
五、万一 Alt+V 也不行：备用方案
偶尔 Alt + V 会因为终端版本、Claude Code 版本等原因失灵（Windows Terminal 就出现过图片粘贴的回归 bug）。这时候有两个保底办法：
- 复制图片文件：先把截图保存成文件，在文件管理器里选中这个文件按
Ctrl + C（注意，这时复制的是文件本身），再回到 Claude Code 按Ctrl + V，会粘贴成文件路径，Claude Code 照样能读。 - 拖拽：直接把图片文件拖进 Claude Code 窗口。
这俩办法本质上都是绕开”剪贴板图片”，改走”文件”这条路，稳得很。
六、跨平台对照：顺手记一下，别串台
如果你和我一样偶尔也会在 Mac 上用 Claude Code，注意快捷键是反过来的：
| 平台 | 粘贴图片快捷键 | 备注 |
|---|---|---|
| macOS | Ctrl + V | 注意是 Ctrl，不是 Cmd；Cmd+V 粘贴文本 |
| Windows | Alt + V | Ctrl+V 只粘贴文本 |
| Linux/WSL | 视终端而定 | WSL 下尤其折腾，可能要额外脚本 |
这个”互换”相当反直觉，我就是被它坑过——在 Mac 上养成的 Ctrl + V 肌肉记忆，回到 Windows 就失灵了。记一下，免得来回切平台时反复怀疑人生。
七、小结
Windows 下往 Claude Code CLI 里粘图片，记住 Alt + V 就够了。核心就一句话：
Ctrl + V是终端层的文本粘贴，图片会被吞掉；Alt + V是 Claude Code 自己的图片粘贴快捷键，截图后用它就对了。
截图（Win + Shift + S、微信、QQ）→ Alt + V，一套流程顺下来，再也不会对着空荡荡的输入框发呆了。