---
title: "01 - 什麼是 Herdr"
type: note
specialty: Programming
tags: [herdr從0開始使用教學, 01-什麼是herdr, agent, terminal]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# 01 - 什麼是 Herdr

← [[00-Index]] | 下一篇 → [[02-安裝與環境選擇]]

---

## 一句話理解

Herdr 是一個 **agent multiplexer**：跑在你現有終端機裡的一支 Rust 執行檔，把多個 coding agent（Claude Code、Codex、Gemini…）各自放進一個真實的終端 pane，然後幫你**一眼看出每一個現在是什麼狀態**。

官方自己的描述是 "agent multiplexer that lives in your terminal"，四個賣點：

1. **every agent at a glance** — `blocked` / `working` / `done` 一目瞭然，而且看到的是**真實終端畫面**，不是被包裝過的詮釋。
2. **detach, agents keep running** — 關掉終端機，agent 繼續跑；從任何終端機、甚至 SSH 進來都能接回。
3. **agents can use herdr too** — 有一套純 socket API，agent 可以自己開 pane、讀輸出、等別的 agent。**這是本教學的核心。**
4. **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`](https://github.com/dirtywolf1213/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](https://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 四層模型
- [[Programming/Codex/Codex從0開始使用教學/01-什麼是Codex|Codex 01 - 什麼是 Codex]] — 對照組：agent 本身在做什麼

---

*最後更新：2026-08-04*