解决 Claude Code 通过 SSH 无法粘贴图片：使用 Tabby 图片剪贴板插件

粘贴快捷键的工作方式#

插件监听的是 Tabby 的 paste 粘贴动作，并没有单独固定一个插件快捷键。

Tabby 在 Windows 上默认使用：

1
Ctrl + Shift + V

作为粘贴快捷键。因此在默认配置下，按下 Ctrl + Shift + V 就会触发插件；如果已经修改过 Tabby 的粘贴快捷键，应使用修改后的快捷键。

插件触发后会先检查剪贴板：

• 剪贴板中有图片：上传图片，并按当前模式粘贴为原生附件或远端路径。
• 剪贴板中没有图片：交还给 Tabby 执行普通文本粘贴。

关键前提

插件只能取得由 Tabby 自己建立的 SSH 会话。当前活动标签必须是 Tabby 内置 SSH 标签页，并且远端需要支持 SFTP。

必须使用 Tabby 内置 SSH 会话#

下面这种连接方式不适用于该插件：

1
Tabby 本地 PowerShell
2
    ↓
3
手动执行 ssh user@server
4
    ↓
5
进入远端

这种标签页在 Tabby 看来仍然是本地终端，插件无法取得 Tabby 内置 SSH 会话的 SFTP 对象。

应当在 Tabby 中直接创建并打开 SSH 配置：

1
Tabby
2
→ 配置和连接
3
→ 新建 SSH 配置
4
→ 连接远端

第一步：完全退出 Tabby#

先退出 Tabby 主窗口和系统托盘，然后在 PowerShell 中执行：

1
Get-Process Tabby -ErrorAction SilentlyContinue |
2
    Stop-Process -Force

第二步：进入 Tabby 插件目录#

Windows 默认目录通常是：

1
C:\Users\你的用户名\AppData\Roaming\tabby\plugins

也可以在 PowerShell 中直接进入：

1
Set-Location "$env:APPDATA\tabby\plugins"

第三步：安装插件#

1
npm install --no-save tabby-clipboard-image

--no-save 表示不把插件写入该目录的 package.json 依赖列表；插件包仍会安装到 node_modules 中。

第四步：验证安装结果#

检查插件入口文件：

1
Test-Path `
2
    ".\node_modules\tabby-clipboard-image\dist\index.js"

正常应返回：

1
True

也可以检查 npm 依赖树：

1
npm ls tabby-clipboard-image --depth=0

本文使用的版本应显示为：

1
tabby-clipboard-image@0.1.0

安装完成后重新启动 Tabby。插件默认启用原生附件模式、关闭自动降级、开启通知，并使用 /tmp 作为远端上传目录。

第一步：使用 Tabby 建立 SSH 会话#

打开已经保存的 Tabby SSH 配置并连接远端机器。

不要先打开本地 PowerShell，再手动运行 ssh。

第二步：启动 Claude Code#

例如：

1
cd "/Users/arrog1nt/code/koishi 插件"
2
claude

第三步：在 Windows 上截图#

使用 Windows 截图快捷键：

1
Win + Shift + S

也可以从浏览器或图片软件中复制真实图片。

第四步：触发 Tabby 粘贴#

点击 Claude Code 输入框，按下 Tabby 当前配置的粘贴快捷键。

Tabby 在 Windows 上的默认粘贴快捷键是：

1
Ctrl + Shift + V

插件会把图片上传到远端：

1
/tmp/clipboard_1785200000000.png

默认的 Native Attachment 模式会让 Claude Code 输入框显示：

1
[Image #1]

继续输入问题并提交即可，例如：

1
请分析这张图片中的报错：[Image #1]

如果更希望看到并手动引用文件路径，可以在插件设置中将 Paste mode 改为 Remote Path。此时输入框会出现：

1
"/tmp/clipboard_1785200000000.png"

必要时也可以改为明确的文件引用：

1
@/tmp/clipboard_1785200000000.png

两种模式都会将图片保存为 /tmp/clipboard_<时间戳>.png；区别只在于路径是以 Bracketed Paste 交给 Claude Code 识别为原生附件，还是作为普通文本输入。

按粘贴快捷键没有反应#

先确认剪贴板中确实是图片。推荐使用 Win + Shift + S 重新截图后立即测试。

如果剪贴板中只有文字，插件会放弃图片上传，并让 Tabby 继续执行普通文本粘贴，这是正常行为。

还应检查：

• 当前焦点是否位于 Claude Code 输入框。
• 使用的是否是 Tabby 当前配置的粘贴快捷键。
• 当前标签是否为 Tabby 内置 SSH 会话。
• SSH 是否已经完成连接。
• 插件的 Enable image paste 是否开启。
• 安装后是否已经彻底重启 Tabby。

提示找不到 SSH 会话#

通常是因为使用了：

1
本地 PowerShell → 手动 ssh

请改用 Tabby 中保存的 SSH 配置直接连接远端。

提示 SFTP 错误#

可以在 Windows PowerShell 中测试当前 SSH 配置是否支持 SFTP：

1
sftp macmini

连接成功后输入：

1
quit

如果 SFTP 本身无法建立，插件也无法上传图片。

提示 /tmp 没有权限#

在远端执行：

1
touch /tmp/tabby-image-test &&
2
rm /tmp/tabby-image-test

没有报错说明 /tmp 可写。

如果服务器对 /tmp 有特殊限制，需要修改插件的远端保存目录，或者为当前用户提供一个可写目录。

插件未加载或没有出现在设置中#

完全退出 Tabby，然后检查插件入口文件：

1
Test-Path `
2
    "$env:APPDATA\tabby\plugins\node_modules\tabby-clipboard-image\dist\index.js"

返回 True 后重新启动 Tabby。

如果仍然报错，可以按 Ctrl + Shift + I 打开 Tabby 开发者工具，在 Console 中搜索：

1
clipboard-image

同时检查 Tabby 版本是否达到 1.0.230，以及当前使用的是否为桌面版而不是网页版。

原生附件模式没有出现 [Image #1]#

先确认：

• 插件设置中的 Paste mode 为 Native Attachment。
• Tabby 的 设置 → 终端 → Bracketed paste 已开启。
• 前台程序是 Claude Code，而不是普通 Shell 提示符。
• 上传目录为绝对路径，例如 /tmp。

然后在远端检查文件：

1
file /tmp/clipboard_1785200000000.png

正常应显示：

1
PNG image data

如果当前 Claude Code 版本仍无法识别原生附件，可以开启 Fall back to Remote Path，或者直接将 Paste mode 改为 Remote Path，再使用明确的文件引用：

1
@/tmp/clipboard_1785200000000.png