[开源] clipaste —— 一行命令修复 macOS 截图无法粘贴到 Claude CodeCodex 的问题

问题描述：

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是
• 我的开源项目完整开源，无未开源部分： 是
• 我的开源项目已链接认可 LINUX DO 社区： 是
• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

---

背景

用 Claude Code 或 Codex 的佬友们应该都遇到过：macOS 上截个图，切到终端按 Cmd+V，啥也粘贴不出来。但是从微信复制同一张图片再粘贴就没问题。

我追查了根因：macOS 截图只往剪贴板放了图片数据（TIFF/PNG），没有文件路径。而 Ghostty、Alacritty 这些终端的 Cmd+V 只能粘贴文本或文件路径，处理不了纯图片数据。

这个问题在 GitHub 上有 13+ 个 open issue，累计 200+ thumbs up，Claude Code、Codex、Ghostty 三个项目都有人报，至今没有官方修复。

它能干什么

clipaste 是一个 macOS 后台小守护程序，装完就不用管了：

• 自动检测剪贴板里的截图（有图片数据但没有文件路径的情况）
• 把截图存成临时 PNG 文件，在剪贴板里注册文件路径
• Cmd+V 粘贴到任何终端都能用了
• Ctrl+V 图片粘贴也能用（补了 PNGf 类型）
• 18MB 内存，0% CPU，处理延迟 ~109ms，完全无感

安装

brew install hqhq1025/clipaste/clipaste brew services start clipaste

装完开机自启，不需要任何配置。

兼容性

终端	Cmd+V	Ctrl+V
Ghostty
Alacritty
iTerm2
Terminal.app

AI 工具	状态
Claude Code
Codex CLI
Cursor CLI

GitHub

GitHub - hqhq1025/clipaste: Fix macOS screenshot paste in terminal AI tools (Claude Code, Codex, Cursor) · GitHub

欢迎体验、反馈、提 issue，也欢迎给个 star

网友解答：

---

--【壹】--：

好建议 我原先没有相关的需求 没发现这个问题 刚才试着实现了一下 ssh 远程连接下剪切板的图片粘贴的问题 是正常工作的 可以去使用试一下!

---

--【贰】--：

比较好奇，使用原生的cli命令运行codex和在vscode上运行对应插件有啥区别吗

---

--【叁】--：

了解到 windows 的用户也有类似的痛点, 准备这两天支持 Windows, 并且统一用 rust 重写, 有需要的佬友们可以等一等

---

--【肆】--：

我更习惯命令行吧 vscode 和 app 感觉还是差着一些功能的 以及命令行开多个 session 并行去用更方便一些 这个主要看个人习惯

---

--【伍】--：

之前在wsl环境也是用了一个脚本，不过现在用ssh远程ubuntu开发就抓瞎了，还没时间解决这个问题

---

--【陆】--：

支持一下,先去GitHub上star一下,说不定未来用上(OvO)

---

--【柒】--：

我认为我们应该需要一个监听cmd+v自动转成codex需要格式的codex插件，不知道它有没有这个渠道…

---

--【捌】--：

你说的这个东西我已经做了 — clipaste，就是一个后台 daemon，监听剪贴板变化，检测到截图（有图片没文件路径）就自动存成临时 PNG 并注册文件路径。之后 Cmd+V 和 Ctrl+V 都能用，Codex 和 Claude Code 都兼容。

brew install hqhq1025/clipaste/clipaste && brew services start clipaste

不需要改 Codex 或终端的任何配置，纯粹在剪贴板层面修复。18MB 内存 0% CPU，开机自启。

GitHub: GitHub - hqhq1025/clipaste: Fix macOS screenshot paste in terminal AI tools (Claude Code, Codex, Cursor) · GitHub

---

--【玖】--：

是的了解 但是我更习惯统一于 cmd+v 并且因为先前有一些软件的 hotkey 占用了 ctrl+v 因此想要做这个工具 帮助有同样需求的人

---

--【拾】--：

感谢! 要是有什么相关的需求和痛点可以留 issue 或者给这个帖子评论!

---

--【拾壹】--：

mac: control+v
windows: alt+v

---

--【拾贰】--：

看也看不懂，学也学不费，先看看大佬怎么牛逼的