在 SSH 环境中舒服地使用 Claude Code：Tabby + Herdr + Reviewr 完整配置

使用官方脚本安装#

在远端 macOS 或 Linux 中执行：

1
curl -fsSL https://herdr.dev/install.sh | sh

安装脚本会根据当前平台和架构下载对应的稳定版二进制，并将其加入 PATH。

使用 Homebrew 安装#

已经安装 Homebrew 时，也可以执行：

1
brew install herdr

验证安装：

1
herdr --version

Herdr 官方为 Linux 和 macOS 提供稳定版本；原生 Windows 版本目前属于预览状态。本文只在远端 macOS 或 Linux 中运行 Herdr。

启动并恢复会话#

进入项目目录：

1
cd "/path/to/project"

启动 Herdr：

1
herdr

Herdr 会创建或连接默认的后台会话。然后在 Pane 中启动 Claude Code：

1
claude

Herdr 会识别 Agent，并在侧栏显示 working、blocked、done 或 idle 等状态。

使用 Herdr 后，可以直接关闭 Tabby，或者主动断开客户端。Herdr 服务和 Pane 中的 Agent 仍会在远端运行。重新连接 SSH 后再次执行：

1
herdr

即可恢复之前的工作现场。

如果需要真正结束整个 Herdr 服务，执行：

1
herdr server stop

常用 Herdr 快捷键#

Herdr 的默认前缀键是：

1
Ctrl + B

文档中的 prefix + v 不是同时按下 Ctrl + B + V，而是按顺序操作：

1
按下 Ctrl + B
2
松开
3
再按 V

常用快捷键如下：

这种 prefix-first 操作方式可以减少与 Claude Code、Shell 和编辑器快捷键的冲突。

使用条件#

Reviewr 当前要求：

• Herdr 0.7.0 或更高版本，并启用插件系统。
• git 已加入远端 PATH。
• 终端支持真彩色和 Unicode 绘图字符。
• 运行环境为 macOS 或 Linux。

PR 标签页还需要已经登录的 gh、glab 或带 Azure DevOps 扩展的 az CLI，并且仓库存在可识别的 origin 或 upstream 远端。

安装并打开 Reviewr#

在远端执行：

1
herdr plugin install persiyanov/herdr-reviewr

打开当前工作区的 Reviewr：

1
herdr plugin action invoke open --plugin persiyanov.reviewr

插件安装的是预编译版本，不需要额外准备 Rust 工具链。

为 Reviewr 设置快捷键#

创建并编辑 Herdr 配置文件：

1
mkdir -p ~/.config/herdr
2
nano ~/.config/herdr/config.toml

加入：

1
[[keys.command]]
2
key = "prefix+shift+o"
3
type = "plugin_action"
4
command = "persiyanov.reviewr.toggle"
5
description = "打开或关闭 Reviewr"

Herdr 在 macOS 和 Linux 中的默认配置路径是：

1
~/.config/herdr/config.toml

重新加载配置：

1
herdr server reload-config

以后依次按下：

1
Ctrl + B
2
Shift + O

即可打开或关闭 Reviewr。

快捷键冲突

prefix + Shift + O 是本文添加的自定义快捷键，并非 Reviewr 默认键。如果发生冲突，可以改成其他未占用组合，再通过 Ctrl + B、? 查看实际生效的绑定。

Reviewr 的日常审查流程#

让 Claude Code 修改完代码后，打开 Reviewr：

1. 使用 j / k 选择修改文件。
2. 按 Tab 切换到代码 Diff。
3. 按 v 开始选择代码行。
4. 使用 j / k 扩大选择范围。
5. 按 c 添加评论。
6. 输入评论后按 Enter 保存。
7. 重复检查其他文件和代码行。
8. 按 s 将全部评论发送给 Agent，S 也可以触发发送。

常用 Diff 范围：

其他常用操作：

为什么普通 SSH 不能直接粘贴图片#

Claude Code 实际运行在远端机器上：

1
Windows 剪贴板
2
       ↓
3
Tabby
4
       ↓ SSH
5
远端 macOS / Linux
6
       ↓
7
Claude Code

普通文本可以通过终端发送，但图片剪贴板不会自动通过 SSH 传输。

直接粘贴时可能提示：

1
No image found in clipboard

也可能出现 Windows 本地路径：

1
C:\Users\你的用户名\AppData\Local\Temp\image.png

这个路径只存在于 Windows，远端机器无法访问。

图片插件采用的方式是：

1
读取 Windows 剪贴板图片
2
→ 转换为 PNG
3
→ 通过当前 SSH 会话上传
4
→ 在远端生成真实 PNG 文件
5
→ 把远端路径输入 Claude Code

通过插件管理器安装#

打开：

1
Tabby
2
→ 设置
3
→ 插件

搜索：

1
tabby-ssh-image-clipboard

安装后彻底退出并重新启动 Tabby。

重新进入：

1
设置 → 插件 → Clipboard Sync

确认：

1
Enabled：开启
2
Show Notifications：开启

正确理解图片粘贴快捷键#

图片插件监听的是 Tabby 的 paste 粘贴动作，并没有硬编码一个独立的插件快捷键。

Tabby 在 Windows 上默认使用：

1
Ctrl + Shift + V

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

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

• 有图片：上传图片并输入远端路径。
• 没有图片：交还给 Tabby 执行普通文本粘贴。

在线安装出现 [object Object]#

部分 Windows 环境会在 Tabby 中显示：

1
ssh-image-clipboard 中的错误：
2
[object Object]

直接全局安装：

1
npm install -g tabby-ssh-image-clipboard

还可能因为 tabby-ssh 的 postinstall 脚本失败：

1
npm error path ...\node_modules\tabby-ssh
2
npm error run-script-os was unable to execute the script 'postinstall'

这时不要全局安装，而是将插件安装到 Tabby 自己的用户插件目录。

彻底关闭 Tabby：

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

进入插件目录：

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

验证入口文件：

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

正常应返回：

1
True

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

使用图片粘贴#

首先通过 Tabby 保存的 SSH 配置连接远端，然后启动 Herdr 和 Claude Code。

在 Windows 上截图：

1
Win + Shift + S

回到 Claude Code，按下 Tabby 当前配置的粘贴快捷键。默认情况下是：

1
Ctrl + Shift + V

插件会完成：

1
Windows 剪贴板图片
2
→ PNG
3
→ SFTP
4
→ 远端 /tmp/clipboard_<时间戳>.png
5
→ 在 Claude Code 中输入远端路径

输入框中会出现类似路径：

1
"/tmp/clipboard_1785200000000.png"

继续补充问题即可：

1
请查看这张截图，分析其中的报错："/tmp/clipboard_1785200000000.png"

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

1
@/tmp/clipboard_1785200000000.png

图片插件无效时检查#

确认当前标签是 Tabby 直接建立的 SSH 会话，而不是本地 PowerShell 中手动执行的 ssh。

在远端检查 /tmp 是否可写：

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

检查上传后的图片：

1
file /tmp/clipboard_*.png

正常应显示：

1
PNG image data

如果粘贴快捷键仍然只粘贴普通文字，通常说明剪贴板中没有真实图片，或者插件没有取得当前 SSH 会话。建议重新使用 Win + Shift + S 截图后立即粘贴。

通过插件管理器安装#

在 Tabby 插件页面搜索：

1
tabby-nv-shift-enter

安装并彻底重启 Tabby。插件管理器正常工作时，不需要手动安装。

手动安装预编译插件包#

直接执行：

1
npm install tabby-nv-shift-enter

可能再次触发 tabby-ssh 的 postinstall 错误。

这种情况下，可以只下载并解压已经编译好的插件包，不安装它声明的 Tabby 宿主依赖。

彻底关闭 Tabby：

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

然后执行：

1
$pluginRoot = "$env:APPDATA\tabby\plugins"
2
$target = Join-Path $pluginRoot "node_modules\tabby-nv-shift-enter"
3

4
Set-Location $pluginRoot
5

6
Remove-Item $target `
7
    -Recurse -Force -ErrorAction SilentlyContinue
8

9
New-Item -ItemType Directory `
10
    -Path $target -Force | Out-Null
11

12
$tgz = (
13
    npm pack tabby-nv-shift-[email protected] --silent |
14
    Select-Object -Last 1
15
).Trim()
16

17
if (-not $tgz -or -not (Test-Path $tgz)) {
18
    throw "插件包下载失败"
19
}
20

21
tar -xzf $tgz `
22
    -C $target `
23
    --strip-components=1
24

25
if ($LASTEXITCODE -ne 0) {
26
    throw "插件解压失败"
27
}
28

29
Remove-Item $tgz -Force
30

31
if (Test-Path "$target\dist\index.js") {
32
    Write-Host "安装成功：$target"
33
} else {
34
    throw "安装失败：缺少 dist\index.js"
35
}

插件 1.0.1 的发布包入口是 dist/index.js，并且发布内容中包含已经构建好的 dist 目录，因此这种解压方式不需要本地编译。

配置纯换行#

打开：

1
Tabby
2
→ 设置
3
→ NV Shift Enter

关闭：

1
Include backslash before newline

然后进入：

1
设置
2
→ 快捷键

找到：

1
Send configured custom text

绑定为：

1
Shift + Enter

最终效果：

1
Shift + Enter → Claude Code 输入框内换行
2
Enter         → 发送消息

为什么换行时会出现反斜杠#

插件默认开启：

1
Include backslash before newline

这个模式主要用于 Bash 或 Zsh 命令续行，会发送：

1
反斜杠 + 换行

在 Claude Code 输入框中可能表现为：

1
第一行
2
第二行 \
3
第三行

这不是 Claude Code 自动添加的字符，而是插件主动发送的内容。关闭该选项后，插件只发送纯换行。

Tabby 与 Claude Code#

Herdr#

Reviewr#

完成配置后，SSH 环境中的 Claude Code 不再只是一个能够运行的远程命令行，而会形成完整的开发工作台：

1
Tabby 负责本地输入和 SSH 连接
2
Herdr 负责远端会话和 Agent 管理
3
Reviewr 负责代码审查
4
图片插件负责跨 SSH 发送截图
5
NV Shift Enter 负责自然的多行输入

这套方案适合使用 Windows 本机，通过 Tabby SSH 连接 macOS 或 Linux 服务器，并在远端运行 Claude Code 的开发方式。