解决 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 插件目录#

在 Tabby 插件页面右上角点击 插件目录。

Windows 默认目录通常是：

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

也可以在 PowerShell 中直接进入：

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

第三步：清理安装失败的残留#

1
Remove-Item `
2
    ".\node_modules\tabby-ssh-image-clipboard" `
3
    -Recurse -Force -ErrorAction SilentlyContinue

第四步：在插件目录中安装#

1
npm install tabby-ssh-image-[email protected] `
2
    --legacy-peer-deps `
3
    --ignore-scripts `
4
    --no-audit `
5
    --no-fund

这里没有使用 -g，因为插件需要安装到 Tabby 的用户插件目录。

两个关键参数的作用如下：

• --legacy-peer-deps：避免 npm 自动安装 Tabby 已经内置的宿主依赖。
• --ignore-scripts：跳过依赖中可能失败的 postinstall 脚本。

第五步：验证安装结果#

检查插件入口文件：

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

正常应返回：

1
True

再查看插件目录：

1
Get-ChildItem `
2
    ".\node_modules\tabby-ssh-image-clipboard"

应当至少包含：

1
dist
2
package.json
3
README.md

也可以检查 npm 依赖树：

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

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

1
[email protected]

插件发布包已经包含构建完成的 dist/index.js，因此使用 --ignore-scripts 安装后仍可被 Tabby 加载。安装完成后重新启动 Tabby。

第一步：使用 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

随后自动向 Claude Code 输入：

1
"/tmp/clipboard_1785200000000.png"

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

1
请分析这张图片中的报错："/tmp/clipboard_1785200000000.png"

如果当前版本的 Claude Code 没有自动读取普通路径，可以改用明确的文件引用：

1
@/tmp/clipboard_1785200000000.png

例如：

1
分析这个界面的问题：@/tmp/clipboard_1785200000000.png

插件的标准行为是将图片保存为 /tmp/clipboard_<时间戳>.png，再把带引号的远端路径写入当前终端。

按粘贴快捷键没有反应#

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

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

还应检查：

• 当前焦点是否位于 Claude Code 输入框。
• 使用的是否是 Tabby 当前配置的粘贴快捷键。
• 当前标签是否为 Tabby 内置 SSH 会话。
• SSH 是否已经完成连接。
• 插件的 Enabled 是否开启。
• 安装后是否已经彻底重启 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 仍然显示 [object Object]#

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

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

返回 True 后重新启动 Tabby。

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

1
ssh-image-clipboard

这样可以查看具体异常，而不是插件页面中被简化成 [object Object] 的错误。

图片路径出现了，但 Claude Code 没有识别#

先确认输入的是远端路径：

1
/tmp/clipboard_1785200000000.png

而不是 Windows 本地路径：

1
C:\Users\用户名\...

然后在远端检查文件：

1
file /tmp/clipboard_1785200000000.png

正常应显示：

1
PNG image data

确认文件存在后，再使用明确的文件引用：

1
@/tmp/clipboard_1785200000000.png