01 - 什麼是 Herdr
← 00-Index | 下一篇 → 02-安裝與環境選擇
一句話理解
Herdr 是一個 agent multiplexer：跑在你現有終端機裡的一支 Rust 執行檔，把多個 coding agent（Claude Code、Codex、Gemini…）各自放進一個真實的終端 pane，然後幫你一眼看出每一個現在是什麼狀態。
官方自己的描述是 “agent multiplexer that lives in your terminal”，四個賣點：
- every agent at a glance —
blocked/working/done一目瞭然，而且看到的是真實終端畫面，不是被包裝過的詮釋。 - detach, agents keep running — 關掉終端機，agent 繼續跑；從任何終端機、甚至 SSH 進來都能接回。
- agents can use herdr too — 有一套純 socket API，agent 可以自己開 pane、讀輸出、等別的 agent。這是本教學的核心。
- one rust binary, no electron — 沒有 Electron，就是一支執行檔，跑在你原本用的終端機裡。
它「不是」什麼
搞清楚這幾點可以少走很多冤枉路：
- 它不是另一個 AI。 Herdr 本身沒有任何模型、不會幫你寫東西。它是管理層。
- 它不是 Claude Code 或 Codex 的替代品。 它是跑它們的地方。
- 它不是雲端服務。 全部在你自己機器上，agent 也是本機 process。
- 它不是把 agent 輸出「摘要」給你看的儀表板。 它顯示的是 agent 真正畫在終端上的東西。
跟 tmux 差在哪
如果你用過 tmux 或 zellij，Herdr 的操作模型會很熟悉：背景 server + 可 detach 的 client、prefix 鍵、split pane。差別在它認得 agent：
| 面向 | tmux | Herdr |
|---|---|---|
| 分割終端、detach/reattach | ✅ | ✅ |
| 知道某個 pane 裡跑的是 Claude Code | ❌（只知道是某個 process） | ✅ 自動偵測 |
| 知道那個 agent 現在在等你批准 | ❌ | ✅ blocked 狀態 |
| 狀態往上冒（pane → tab → workspace） | ❌ | ✅ sidebar rollup |
| 滑鼠原生操作（點、拖、右鍵選單） | 需設定，體驗普通 | ✅ 設計時就是 mouse-first |
| 「等某個 agent 做完」這種指令 | ❌ 要自己 hack | ✅ herdr agent wait |
| 專案層級容器 | session（扁平） | workspace / tab / pane 三層 |
一句話：tmux 管的是終端；Herdr 管的是在終端裡工作的 agent。
跟 Claude Code 內建 subagent 差在哪 ⭐
這題對本站作者最重要，因為現在的 Taiwan_IM_board 詳解量產就是靠 Claude 的 subagent（Task tool）在跑。
| 面向 | Claude 內建 subagent | Herdr + 獨立 agent |
|---|---|---|
| 額度來源 | 全部算 Claude 的額度 | 可以指定用 Codex → 算 ChatGPT Plus 的額度 |
| 可見度 | 黑箱，只有最後回報 | 每個 agent 一個真實畫面，隨時看 |
| 失敗模式 | stream idle timeout、整批沒了 | 本機 process，慢就慢，不會被切斷 |
| 中途介入 | 不行 | 可以直接打字進那個 pane |
| 存活期 | 綁在你這次對話裡 | server 常駐，關終端機也還在 |
| 手機看得到 | 不行 | SSH 進去就看得到 |
| 建立成本 | 一行 Task 呼叫，很輕 | 要 split pane、start agent，重一點 |
結論不是「subagent 不好」，而是分工：
- 需要快速、短、用同一顆腦袋的判斷 → 用 Claude subagent。
- 需要長時間、大量、可平行、而且不想燒 Claude 額度 → 用 Herdr 開 Codex pane。
這正是 08-Claude當大腦-Codex當雙手 要處理的主題。
Herdr 能認出哪些 agent
官方文件列出的支援清單（agent start --kind 可用的種類）：
pi、claude、codex、gemini、cursor、devin、agy、cline、omp、mastracode、opencode、copilot、kimi、kiro、droid、amp、grok、hermes、kilo、qodercli、maki
對本站作者來說重點只有兩個：claude 和 codex 都在清單裡，而且兩個都有官方 integration。其餘不用管。
沒被支援的 agent 也照樣能跑，只是 Herdr 不會給它豐富的狀態資訊。
一個具體的畫面長怎樣
┌ sidebar ──────────┬ pane w1:p1 ───────────┬ pane w1:p2 ──────────┐
│ ▸ obsidian-vault │ claude (大腦) │ codex writer-a │
│ ● codex writer-a│ │ │
│ ● codex writer-b│ > 我把 GBS 那篇的 │ ⏳ 正在改寫 §Diagnosis │
│ ▸ 刷題網站 │ frontmatter 修補 │ │
│ ⚠ codex fixer │ 丟給 writer-a 了 │ │
│ ● claude │ │ │
└───────────────────┴────────────────────────┴──────────────────────┘
左邊 sidebar 是 Herdr 的核心價值：⚠ 代表那個 agent 正在等你回答，而且這個警示會從 pane 一路冒到 workspace 層級——所以你不用一個一個切過去看。
外界怎麼描述它（補充查證）
2026 年幾篇獨立評測與導覽文章的共通描述，可以當作官方說法的交叉驗證：
- 單一 Rust binary，約 10 MB，把一個終端機變成 AI coding agent 的「控制室」。
- 每個 agent 拿到一個真正的 PTY pane，一個可以透過 SSH detach 的常駐 session，以及一個顯示 blocked / working / done / idle 的 sidebar——不需要額外的 hook。
- 可以在同一個終端裡跑 Claude Code、Codex、Copilot CLI、Cursor Agent 等 15 種以上 agent。
- 跟 tmux 的差別被總結成一句話：「tmux 保存終端機；Herdr 保存 agent workspace，而且理解 agent 狀態。」
官方另有一個 herdr.dev/compare 頁面做同類工具比較。
📌 一個對你有用的觀察：多數評測都強調「不需要額外 hook 就能看出狀態」。這是因為 Herdr 用的是畫面偵測（screen manifest）——這也是為什麼 05-Agent偵測與狀態機制 要強調「狀態是猜的，關鍵結果要親自 read 確認」。方便和精確在這裡是一組取捨。
什麼情況下你不需要 Herdr
誠實講，以下情況它幫不上忙、甚至是多餘的：
- 你一次只開一個 agent、而且都坐在電腦前盯著 → 直接用終端機就好。
- 你的任務都是 5 分鐘內結束的小問答 → 開 pane 的成本比省下的多。
- 你完全不寫 CLI、也不打算讓 AI 幫你下指令 → 那 Herdr 只剩「比較好看的 tmux」。
它的價值跟「同時在跑的長時間任務數量」成正比。 一次跑 3–5 個 Codex 在量產詳解時，它的價值最大。
給初學者的心法
把 Herdr 想成牧場（herd = 畜群，這也是它名字的來源）：
- 你是牧羊人，不是羊。
- 羊（agent）自己吃草，你負責知道哪隻卡住了、哪隻走丟了、哪隻吃飽了。
- 牧場圍籬（workspace / tab）是給你自己看的秩序，不是給羊的限制。
最穩的起手式：先只用滑鼠，把一個專案開成一個 workspace，裡面跑一個 Claude。等這個順了，再談多 agent 編排。
🔗 相關筆記
- 00-Index — 目錄與學習路線
- 02-安裝與環境選擇 — 下一步：在 Windows 上怎麼裝
- 03-核心概念 — Workspace / Tab / Pane / Agent 四層模型
- Codex 01 - 什麼是 Codex — 對照組：agent 本身在做什麼
最後更新：2026-08-04