远程调试 UI、对报错弹窗,或让 Claude Code 看一眼 Xcode / Simulator 画面时,很多人还在「先存图、再拖文件路径」。Claude Code 其实支持把截图直接粘贴进提示框:复制后在输入区按 Ctrl+V(若在 Windows / WSL 客户端侧输入,常用 Alt+V);终端不会画出整张图,而是出现 [Image ] 芯片,模型就能读图。
这篇把「截图 → 剪贴板 → 粘进 Claude Code」落到一台常开的新加坡 Mac mini 上:同机怎么粘、纯 SSH 怎么改走落盘路径、以及怎样写成可重复的习惯。账号由你自己开通和登录,本文只讨论稳定合规的使用环境和机器侧流程。
为什么截图粘贴值得练一遍
文字很难讲清按钮位置、红字提示或暗色对比。把画面交给 Claude Code,它才能对着界面改布局或定位断言。难点往往在远程时剪贴板和会话不在同一台机器:
- 你在自己电脑上看画面,Claude Code 却在 Mac mini 的 tmux 里,本机剪贴板进不去远端提示框。
- 纯 SSH 通常不带图形剪贴板;按了 Ctrl+V,远端什么都收不到。
- 同一台整机上用 UU 远程连接进桌面时,截图与 Claude Code 同机,路径最短。
目标不是死记快捷键,而是让截图产生的地方和 Claude Code 读图的地方尽量是同一台常开 Mac。
准备清单
- 常开的新加坡 Mac mini,已装 Claude Code CLI;长会话放 tmux。
- 看 UI 时优先用 UU 远程连接进桌面(或浏览器图形桌面),不要只开无窗口。
- 可选:用系统自带
screencapture做落盘备份,纯 SSH 时用。
tmux new -s claude || tmux attach -t claude
claude --version
which screencapture
步骤一:本机确认「复制 → Ctrl+V → [Image ]」
先在机器本机终端(UU 远程桌面里的 Terminal)验证,排除远程剪贴板干扰:
- 截图进剪贴板:
Cmd+Ctrl+Shift+4框选区域(进剪贴板,不落盘)。只要存桌面可用Cmd+Shift+4。 - 进入 Claude Code 交互提示框(光标在输入区,不是 shell 提示符后)。
- 按 Ctrl+V(不少终端里给 Claude Code 粘贴用 Ctrl+V 而非 Cmd+V;无效再试 Cmd+V)。
- 输入区应出现
[Image ]芯片。再补一句说明,例如:「请指出这个弹窗的主按钮文案和错误码,不要改代码。」
芯片没出现时:确认焦点在输入区、截图在这台 Mac 的剪贴板、且没有在「仅 SSH」窗口里空按粘贴。
步骤二:远程 GUI——截图与 Claude Code 同机
推荐日常路径:
- 用 UU 远程连接(或浏览器图形桌面)登录这台 Mac mini。
- 在远端打开 Simulator、Xcode、浏览器或 App。
- 在远端用
Cmd+Ctrl+Shift+4把问题区域拷进远端剪贴板。 - 在远端终端的 Claude Code 里 Ctrl+V,看到
[Image ]后再下指令。
剪贴板、显示器、Claude Code 都在同一台整机上,不必把本机剪贴板隧道进 SSH。夜间离开后会话仍在 tmux;第二天用同一台机器继续贴图追问。
步骤三:纯 SSH 改走落盘路径
只有 SSH、没有图形桌面时,本机截图进不了远端提示框。改成文件:
mkdir -p ~/claude-shots
screencapture -x ~/claude-shots/$(date +%Y%m%d-%H%M%S).png
ls -lt ~/claude-shots | head
在 Claude Code 里用路径引用:
请阅读图片文件 ~/claude-shots/20261031-203000.png,列出界面上的错误文案与可疑控件;先不要改仓库。
从自己电脑上传时,用 scp / rsync 发到同一目录再读路径。把约定写进 CLAUDE.md:
## 截图
- UI 问题优先附 ~/claude-shots/ 下最新 png 路径。
- 能在本机图形会话粘贴时,用 Ctrl+V 产生 [Image ] 芯片;纯 SSH 时不要空粘贴,改用文件路径。
步骤四:读图收尾,避免只看不记
在 CLAUDE.md 加收尾要求:
## 读图后的输出
- 先条目列出:看见了什么、与预期差在哪、准备改哪些文件。
- 需要留档时,结论写入 ~/agent-journal/decisions/YYYY-MM-DD-ui-<短标题>.md;不要把整张图 base64 进仓库。
- 不要把屏幕里的密钥、token、完整账号写进决定文件。
需要时用干净会话只读复核:
tmux new-window -n ui-review
claude -p "只读:根据我附带的 [Image ] 或 png 路径,核对仓库里相关 UI 字符串是否一致;不要修改文件。"
步骤五:验收清单
- 本机图形会话:
Cmd+Ctrl+Shift+4→ Claude Code → Ctrl+V → 出现[Image ],模型能描述要点。 - 纯 SSH 窗口空按 Ctrl+V 应无效;改用
screencapture+ 路径仍能读图。 - 同一张问题图能列出「文案 / 控件 / 下一步文件」,且 journal 无密钥原文。
- SSH 断开再连回 tmux,原会话还在,可继续追问。
为什么放在新加坡常开的 Mac mini 上
截图读图依赖同一现场:显示器、剪贴板、Simulator、Claude Code、tmux 最好在一台机器上。固定到常开整机之后:
- 同机粘贴最短:UU 远程连接进桌面后,截图与提示框共享剪贴板。
- SSH 也有退路:
~/claude-shots路径稳定,约定不因换笔记本漂移。 - 真 macOS 画面:Xcode、Simulator、系统弹窗都在实机上。
- 稳定合规的使用环境:长会话常开,账号仍由你本人登录;机器侧提供常开算力与稳定网络,方便 SSH 或 UU 远程连接继续贴图调试。
Zumac.Ai 提供位于新加坡的实体 Mac mini M6,整机独享,支持 SSH 与 UU 远程连接,FileVault 全盘加密,退租时抹机重装。新客户整机租用 ¥999/月起,季付 ¥2,697.30,半年付 6 送 1 为 ¥5,994,年付 12 送 2 为 ¥11,988;已购买客户续费保持原价。新客户首单自审核开通当天起租,续费及老客户新订单自付款当天起租。实际延迟取决于你本地的网络线路,建议先租一个月,把「同机粘贴」和「SSH 落盘」两套路径在真实项目上跑通。
小结
- Claude Code 支持截图粘贴:复制后在提示框 Ctrl+V,终端显示
[Image ]芯片。 - 优先让截图与 Claude Code 同机;纯 SSH 改用
screencapture+ 文件路径。 - 截图目录与读图收尾写进
CLAUDE.md;结论可进 journal,密钥不要进档。 - 固定在一台新加坡常开整机上,UI 调试才不会在本机剪贴板与远端会话之间来回摔。
