Windows 上的 Claude Code

如何把截图粘贴到 Claude Code 中

简短的答案是：在 Windows 上，不要依赖 Ctrl+V。可以使用 Claude Code 自带的粘贴快捷键，把图片文件拖入终端，或者在提示中通过路径引用文件。本页面将介绍这三种方式、普通剪贴板粘贴为何总是失效，以及如何调整截图尺寸，避免耗费上千个 token。

下载 Windows 版面向 AI 编码的截图

你想给 Claude Code 展示一张截图——一个错误对话框、一处错乱的布局、一帧设计稿——而把它用文字描述出来会耗费大量时间。 问题在于，终端并不是一个聊天输入框：同样的 Ctrl+V 在 Windows 其他地方都能正常粘贴图片的快捷键，在这里往往什么反应都没有，在 WSL 内部尤其如此。图片并没有丢失；只是终端根本没有收到它。解决方法是使用一种不依赖脆弱的“剪贴板位图”路径的方式，这样的可靠方式有三种。

本指南由 Maxisnap 发布。Maxisnap 出品的这款 Windows 截图工具，其导出功能正是为这种交接场景而设计的，因此它会在相关之处出现——但下面介绍的方式适用于任何工具生成的任何截图。

可靠的几种方式

把图片交给 Claude Code 有哪三种方式？

Claude Code 可以通过三种方式接收图片，而在 Windows 上，这三种方式的可靠程度并不相同。按可靠性大致排序如下：

路由	怎样	在 Windows／WSL 上的可靠性
在提示中使用文件路径	输入或粘贴已保存图片的路径，例如 `C:\Users\you\shot.png`，写在你的消息中。	最可靠——不涉及剪贴板
拖动文件进去	把图片文件从文件资源管理器（或直接从截图工具）拖到终端窗口上。	当终端支持拖放时较为可靠
粘贴快捷键	使用 Claude Code 专用的粘贴快捷键（近期版本使用的是 `Alt+V` 对于图像）。	在许多配置下都能正常工作；备用方案是使用文件路径
~~Ctrl+V~~	所有人第一反应都会尝试的操作。	在终端中往往悄无声息地毫无反应

Claude Code 的快捷键绑定在不同版本之间会有变化——具体的粘贴快捷键请查阅其当前文档。而文件路径这种方式，无论如何都能持续有效。

原因

为什么 Ctrl+V 在终端中没有任何反应？

因为把图片粘贴到终端，是一种与粘贴文本不同、支持度也更差的操作。当你复制一张截图时，Windows 会把位图放到剪贴板上。大多数终端只处理文本粘贴，会默默忽略位图，所以什么都不会出现。在 WSL 内部，这个差距还要更大：终端的 Linux 一侧根本看不到 Windows 剪贴板中的位图，因此即使是本可以接受粘贴图片的工具，也永远拿不到数据。图片本身没有问题——只是没有从剪贴板到提示框的路径。这就是为什么使用已保存文件、而不是剪贴板位图的方式，才是真正靠得住的方案。

即使是专用的粘贴快捷键，在这里也可能不太稳定：据报告，在某些 Windows 和 PowerShell 环境下，终端中的图片粘贴会间歇性失效。当剪贴板方式让你失望时，已保存的文件——无论是拖入还是通过路径引用——都不依赖剪贴板，这正是值得养成的习惯。

在你粘贴前

发送截图之前，我应该先调整它的尺寸吗？

是的，如果你整天都在做这件事的话。全分辨率截图不仅传输起来负担重——成本也更高。视觉模型会把图像切分成多个图块并按图块计费 token，因此一张 4K 截图可能花费远超一千个图像 token，而调整到合理宽度的副本只需几百个 token，清晰度却毫不逊色，因为模型本来就会对过大的图像进行内部降采样。在图像送达 Claude Code 之前先把尺寸调整合适，是整个流程中成本最低的优化手段。

这正是专用截取工具能派上用场的地方。Maxisnap 的 面向 AI 优化的导出 会生成一份宽度默认上限为 1600 px （可在设置中配置），并直接把保存好的文件交给你——可以直接拖入终端，或通过路径引用。如果截图中出现了 API 密钥、令牌或客户数据，模糊工具会在文件生成之前就以不可逆的方式将其遮盖，因此发送出去的内容中无法恢复出这些敏感信息。

你粘贴什么	典型图像 token 成本	在 Claude Code
原始 4K / 整块显示器截图	1,000+ token	成本更高，还可能触及大小限制
Maxisnap 面向 AI 优化的副本（宽 1600 px）	几百个 token	清晰易读、成本更低、上传更快

这里的 token 数字是视觉模型的典型区间，并非 Maxisnap 的基准测试；实际数量因模型和图片内容而异。

$ 最快、最可靠的交接方式

1. Ctrl+Alt+5  ->  drag a box around the error
2. blur any secrets, then export the AI-optimized copy
3. drag the saved file into the terminal
   ...or paste its path:  read this: C:\Users\you\shot.png
# skip Ctrl+V — the terminal usually ignores the bitmap

常见

在 Claude Code 中粘贴截图——常见问题

为什么 Ctrl+V 无法把我的截图粘贴到 Claude Code 中？

因为终端通常不能从剪贴板接受图像——它期望文本，当你复制屏幕截图时它忽视了 Windows 放在那里的位图。在 WSL 内，Windows 剪贴板位图根本不可见于 Linux 端。使用 Claude Code 自己的图像粘贴键，将文件拖到终端，或在你的提示中引用保存的文件路径。

Claude Code 中的粘贴快捷键失效了——现在该怎么办？

在 Windows 和 PowerShell 上，在终端中粘贴图像会间歇性失败，所以不要依赖它作为你唯一的路由。保存屏幕截图并在你的提示中引用其文件路径，或将文件拖到终端上——两者都不接触剪贴板，所以当粘贴快捷键不起作用时，两者都保持工作。值得检查 Claude Code 的当前文档以获得最新的粘贴键，但文件路径路由是永远不会破裂的。

在 Windows 上添加图片最可靠的方法是什么？

在消息中通过路径引用已保存的文件。这种方式不涉及剪贴板，因此在 Windows 终端、WSL 以及通过 SSH 连接时表现一致。把文件拖到终端窗口上，是次可靠的方式。

截图需要满足某个特定尺寸要求吗？

通常来说，尺寸越小越好。一张全分辨率截图可能耗费超过一千个图像 token，也更容易触及单图限制。而调整到约 1600 像素宽的副本，花费的 token 要少得多，清晰度却不会打折扣，因为模型本来就会对过大的图像进行降采样。

在发送截图之前，我该如何隐藏 API 密钥？

在文件生成之前先把敏感信息遮盖掉。在 Maxisnap 中，只需在编辑器里把模糊工具拖到需要遮盖的敏感内容上，再导出即可——模糊效果是不可逆的，因此密钥无法从你交给 Claude Code 的图像中被恢复出来。

我在 Codex CLI 或 Gemini CLI 中也能这样做吗？

可以。这三种方式都支持文件路径或拖拽文件，这在 Windows 上是最通用的方式。我们的面向 AI 编程的截图页面有各工具的具体细节，而面向 AI 编码的屏幕录制介绍了当一张静态截图不够用时，如何发送一段简短的视频片段。

三次按键，即可完成截取、遮盖敏感信息并交付。

一张尺寸合适、经 AI 优化的截图，配有已保存好、可随时拖拽或引用的文件——在 Windows 上免费使用。

免费下载查看全部功能