Claude Code 新增 paste-preview 插件：支持终端图片预览与发送前标注

GitHub 开发者发布了一款名为 paste-preview 的 Claude Code 插件（mod）。在终端内粘贴图片时，界面只显示 [Image #1] 这样的文字标签，连续粘贴后很难区分。这个插件让用户在提示框上方直接看到粘贴图片的缩略图，并能在发送给 Claude 之前编辑和标注图片。

核心功能与工作原理

根据官方 README 文档介绍，paste-preview 提供了以下几项核心功能：

终端图片预览

未安装插件时，终端内粘贴的图片仅以文字标签显示。安装后，提示框中的每个 [Image #N] 都会在上方显示图片缩略图，对话记录中已发送的提示也会显示带有 Image #N 标签的缩略图。

发送前编辑与标注

用户粘贴图片时，插件会自动打开一个编辑器。编辑器提供画笔、椭圆、方框、箭头、文字、裁剪、旋转、七种颜色选项以及撤销功能。编辑完成后按 Enter 键确认，按 Esc 键则取消编辑并保留粘贴的原图。

修改内容传递机制

插件无法直接修改消息中的图片，也无法新增图片，只能执行丢弃操作，所以 paste-preview 采用了替代方案：按下 Enter 发送时，插件会丢弃原始粘贴图片的图像数据块（image block），并附加一条指向编辑后文件的说明供 Claude 读取。这样 Claude 拿到的就是编辑后的标注版本。

平台支持与运行要求

项目文档显示，该插件采用 MIT 许可证，支持 macOS、Linux 和 Windows 系统。

运行环境依赖

用户需安装 Claude Code 2.1.291 或更新版本，README 同时注明 mods 目前属于早期体验（early-access）功能。终端方面，显示缩略图需要支持 kitty 图形协议（例如 Ghostty 或 kitty）；其他终端（包括 Windows Terminal）的缩略图位置只显示 Image #N 及编辑按钮。

桌面端差异

不同操作系统上，编辑器的展现形式有所区别：

• macOS：编辑器表现为原生的浮动面板，能像 Spotlight 一样悬浮于全屏终端之上，无需切换桌面空间（Space）。据文档说明，该面板在后台待命时占用约 100 MB 内存，闲置 20 分钟后会自动退出。
• Linux 与 Windows：编辑器以浏览器应用窗口的形式打开。

安装与生效

在终端里 Claude Code 会话的提示符下运行 /plugin install paste-preview --marketplace alan890104/claude-code-paste-preview，回答 y 以添加 marketplace，然后选择 scope（user scope 会在每个会话中加载）。插件安装后可立即运行，无需重启会话。

相关下载

• Claude
• Code

来源

• https://github.com/alan890104/claude-code-paste-preview