Agent.Space 博客

SSH 里的 Claude Code 粘贴不了截图?先把图片传到远端

本机截图为什么不能直接粘进远端 Claude Code?按保存、传输、核对远端路径的步骤处理,并区分图片输入与会话只读同步。

通过 SSH 在另一台电脑上运行 Claude Code 时,笔记本剪贴板里的图片不会自动成为远端文件。即使粘贴了 /Users/me/Desktop/error.png 这样的本机路径,也不代表图片已经传过去。

更稳妥的起点是:保存截图、传到远端、核对目标位置,再把远端路径交给 Claude。下面默认你已有获准的 SSH 访问权限,不需要先安装剪贴板桥接插件。

保存一张小的、无敏感信息的图片

把截图裁到相关界面或错误,移除账号资料、Token、客户信息和无关窗口。需要时可以私下保留原图,但只传任务必要的部分。

下面的示例要求把脱敏图片保存为本机当前目录里的 claude-shot-01.png。如果远端已有同名文件,请换一个新名字;复制到相同目标可能覆盖旧文件。

如果还在迁移整个项目,可以先看远端 Mac 项目迁移清单。代码仓库传过去了,不代表笔记本其他目录里的截图也传过去了。

在本机终端传输图片

在笔记本上执行,不是在已经连接远端的 SSH 会话里执行:

bash
scp ./claude-shot-01.png user@remote-host:claude-shot-01.png

将 user@remote-host 换成已获授权的账号和主机,或者已配置的 SSH 主机别名。这个示例把文件放在远端用户的个人目录里,不一定是项目文件夹。

命令使用 OpenSSH 的安全文件复制工具。首次出现主机密钥提示时,先确认是预期主机,不要为了传输成功关闭身份校验。如果环境使用非默认端口或受管访问方式,遵循已有的获批连接配置。

Windows 用户在已安装 OpenSSH scp、且当前目录包含图片的终端里也可以使用这个示例。没有该命令时,可以使用获批的 SFTP 文件传输工具,不必安装来路不明的剪贴板助手。

先核对远端文件,再让 Claude 读取

在远端电脑的 SSH 终端里执行:

bash
ls -lh ~/claude-shot-01.pngfile ~/claude-shot-01.png

确认文件非空,类型是图片。这只能证明文件存在、格式大致正确,不能证明 Claude 已看见它,也不能证明它就是你想传的那张图。

需要长期留在项目中时,把文件移入或复制到目标项目的素材目录,再把实际路径交给 Claude Code。官方图片使用说明支持通过文件路径提供图片。

先给一个范围很小的要求:打开图片,描述其中一个明显、无敏感信息的元素,暂时不要改代码。如果项目权限不允许读取目录外文件,应将图片放到获准的项目目录,而不是扩大文件系统访问范围。

按失败环节排查

表现下一步检查
粘贴后只有文字或本机文件名图片是否真的完成传输
scp 找不到源文件本机当前目录和文件名
传输成功,Claude 却找不到图片远端账号、目标位置和实际项目路径
文件存在,但无法按图片打开文件格式和内容,而不只是扩展名
Claude 描述的是另一张截图主机、文件,以及是否覆盖了旧副本

剪贴板桥接工具可能让频繁传图更方便,但也增加了需要检查的软件和数据通路。不要假设所有终端或远控工具都能传图片剪贴板;文字复制成功,不代表图片也受支持。

以上步骤按文档核对,尚未在你的 SSH 主机或模型账号上实测。

想直接在任务界面操作,可以用 Agent.Space

在 Agent.Space 可继续输入的会话中,把图片作为任务附件提供,并确认任务使用哪台电脑、哪个文件夹。图片需要成为长期项目材料时,让 Agent 保存到素材目录,再检查生成的文件。电脑与文件位置指南解释了为什么会话附件和持久项目文件不是同一回事。

只读同步会话即使显示旧图片,也不能接受新任务。添加材料前,先打开正确的可操作会话。

可以打开 Agent.Space,用一张脱敏图片和只读检查请求开始。如果需要亲自操作远端 Mac 的实际桌面,再看 Remote Screen;按所选客户端确认能力,不要把它的剪贴板行为当成 SSH 的通用能力。