Herdr v0.9 使用指南（2026）：一个终端管理多台机器上的 AI 智能体

「想让 Claude Code 在 VPS 上 24 小时跑着，但每次看进度都得 SSH 登上去」——认真用 AI 智能体的人都会撞上这堵墙。

智能体一个任务动辄跑几个小时。正因如此，更合理的做法是让它们跑在全天候在线的机器上，笔记本只当客户端：重活交给 VPS、家里的服务器或 Mac mini。

Herdr——这个懂智能体的终端复用器——刚刚把这件事做得更彻底：2026 年 9 月 7 日发布的 v0.9 版本，把多台机器装进了一个 TUI。

图片来源：herdr.dev 官方 OG 卡片

Herdr 是什么：为 AI 智能体重造的 tmux

Herdr 是一个 Rust 编写的开源工具（单个二进制约 10MB、Apache 2.0），把 tmux 式的会话持久化带进了编程智能体的世界。下载量已超70 万次，社区插件约 1,000 个。

项目	内容
类型	智能体感知的终端复用器（TUI）
实现	Rust 单二进制约 10MB · 零依赖
许可证	Apache 2.0（完全免费）
平台	Linux / macOS（Windows 测试版）
热度	下载 70 万+ · 插件约 1,000 个
支持的智能体	Claude Code / Codex / Cursor / OpenCode / Hermes / Grok CLI 等 15+ 种

一句话概括它能做什么：它是懂智能体的 tmux。

侧边栏把每个智能体归为🔴blocked（等人）·🟡working·🔵done·🟢idle，一眼扫尽
点击面板直接跳进对应智能体
关掉终端智能体也不死，任何终端都能重新接上
与 tmux/Zellij 的本质区别：语义化的智能体状态是一等公民

v0.9 新功能：把机器连起来

以前的 Herdr 严格一客户端=一服务器。想同时看 VPS 和家里服务器上的智能体，得分开开终端标签，还要自己记住谁在哪台机器上。

v0.9 重构了架构：外层 UI 改在客户端渲染，每台服务器继续持有自己的会话和终端。结果是——相互独立的多台机器汇入同一个 TUI。

一条命令添加机器

herdr machine add workbox

workbox 可以是 ~/.ssh/config 里的主机名，也可以是 ssh://you@server:2222 这样的目标。执行后，那台机器的工作区、标签页和智能体会和本地的出现在同一个 TUI 里，不用再开第二个客户端。

还能加标签、指定命名会话：

herdr machine add workbox --label "Build machine" --remote-session agents

首次运行时如果远端没有 Herdr 服务器，setup 会引导安装（需确认，默认回答 No）。它会同时检查二进制和运行中的服务器，替换前都会先询问——安全优先的设计。

操作	命令
添加机器	herdr machine add --label "任意"
列表（拿 profile ID）	herdr machine list（脚本用 --json）
改名	herdr machine rename --label "新名"
停用 / 启用	herdr machine disable / enable
删除	herdr machine remove

前提条件

目标机器可达普通 SSH（局域网、公网、Tailscale 都行）
客户端/服务器都是Linux 或 macOS（x86_64 / aarch64）。Windows 暂不支持多机连接（单机 herdr --remote 仍可用）

切换行为

在侧边栏选中某台机器，它就接收你的输入和屏幕内容。未选中的机器不串流画面，只持续更新智能体状态和通知，带宽占用很小。本机（Local）启动即开、不等 SSH。掉线的机器会把最后状态变暗显示（缓存），重连前输入禁用——一台掉线不影响其他机器。

能做什么：三个实用场景

① 合上笔记本，智能体继续干活

把智能体放到全天候在线的机器上（VPS、家庭服务器、Mac mini），用笔记本的 Herdr 监控。笔记本睡眠、SSH 断开都没关系——智能体在自己的机器上继续跑。这个能力 v0.9 之前就有，v0.9 的提升是所有机器一个屏幕看完。

② 一屏总览分布式机群

「Claude Code 在 VPS、Codex 在家里、实验在本地」——v0.9 之后全部出现在同一个侧边栏，智能体行还带机器标签。不用再脑内维护一张「谁在哪台机器」的地图。一台机器掉线，其他照常。

③ 手机上随时查看

Herdr 会话在 detach 后继续存活。手机 SSH 应用连上、重新 attach，就能看智能体状态、往面板里输入——出门在外问一句「跑完了吗」的场景正好。

Herdr 多机配置：三台机器、一个 TUI（图：cldnavi.com 制作）

读者关心的问题与排查

症状	处理
Attention 状态（连不上）	需要交互确认（主机键、认证、服务器安装）。在终端运行 herdr --remote
认证失败	先确认 ssh 本身能通。带口令的密钥先 ssh-add 再启动 Herdr
连接不稳定	Herdr 会带退避地自动重连。检查 SSH 配置/网络（Tailscale 等）
服务器版本旧	旧服务器会显示 Attention，直到你明确更新它

一个值得了解的设计：保存的 profile 只有 ID、标签、SSH 目标、远端会话名和启用状态。不存密码、不存私钥——认证完全交给 OpenSSH。本地插件和配置也不会被拷贝到远端。

v0.9 的限制与未来（Herdr Cloud）

客观地说，v0.9 的多机支持只是第一阶段。

智能体 CLI 还限定单服务器——跨机器的智能体协作还在路线图上
连接靠自备——SSH 要自己配。把这一步变成一条命令，正是「Herdr Cloud」要做的

Herdr Cloud是机器间的中继层：一条命令把机器连起来，终端流量在机器与客户端之间端到端加密。机器仍然自带，Cloud 只管连接、不托管智能体。本文发布时已在开放等待名单。

更远处还有智能体会话的跨机迁移——开始之前不必决定智能体住哪台机器。

读者想了解的内容

Q: Herdr 怎么安装？ A: curl -fsSL https://herdr.dev/install.sh | sh，也支持 Homebrew / Nix flake。Windows 是测试版。

Q: 和 tmux 有什么区别？ A: tmux 只做会话持久化；Herdr 在此之上加了智能体状态识别（blocked/working/done）、可点击面板和供脚本调用的 socket API。可以理解为「为智能体重造的 tmux」。

Q: 支持哪些智能体？ A: 15+ 种自动识别：Claude Code、Codex、Cursor Agent、OpenCode、Hermes、Grok CLI、Copilot CLI、Kimi Code 等。列表之外的 CLI 也能当普通终端进程跑。

Q: 能连 Windows 机器吗？ A: v0.9 暂不支持（仅 Linux/macOS 之间）。Windows 可用单机 herdr --remote。

Q: 免费吗？ A: 完全免费，Apache 2.0。Herdr Cloud 是未来的服务。

Q: 手机能用吗？ A: 能——任何支持 SSH 的终端应用都可以重新 attach 查看状态。

总结

Herdr v0.9 用herdr machine add 一条命令把多台机器装进一个 TUI（背靠下载 70 万+ 的成熟工具）
合上笔记本智能体照跑。「笔记本当客户端、计算交给常驻机器」的玩法一屏闭环
连接基于 SSH（可走 Tailscale），profile 不存任何凭据——认证交给 OpenSSH，简单干净
下一步：Herdr Cloud（端到端加密 · 一条命令连接）与跨机智能体协作

官网：herdr.dev ／原文：Connecting the machines（Herdr Blog · 2026 年 9 月 7 日）

本文基于 Herdr 官方博客「Connecting the machines」（2026 年 9 月 7 日）及官方文档整理。图片著作权归 Herdr 开发者所有。图由 cldnavi.com 制作。