---
title: "Herdr 從 0 開始使用教學 - 完整學習筆記"
type: note
specialty: Programming
tags: [herdr從0開始使用教學, 00-index, agent, terminal]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# Herdr 從 0 開始使用教學 - 完整學習筆記

> 給第一次接觸 Herdr 的使用者：先搞懂它是什麼、怎麼裝、怎麼用滑鼠開始，最後把它變成「Claude 當大腦、Codex 當雙手」的多 agent 工作台，實際套用在刷題網站與 Obsidian 筆記庫兩個專案上。

---

## 一句話結論

**Herdr 是「跑在終端機裡的 agent 多工器（agent multiplexer）」**：它把多個 coding agent 各自關在一個真實的終端 pane 裡，統一顯示誰在 `working`、誰 `blocked` 等你決定、誰已經 `done`，而且你關掉視窗它們照跑，手機 SSH 進來還能接回同一個 session。

再加一句給本站作者的結論：**它讓「Claude 規劃 + 驗證、Codex 大量幹活」這件事第一次變成可以真的落地的日常工作流**，而不是每次都手動開好幾個終端機視窗自己盯。

---

## 目錄

| 檔案 | 主題 | 說明 |
|---|---|---|
| [[01-什麼是Herdr]] | 什麼是 Herdr | 建立心智模型；跟 tmux、跟 Claude 內建 subagent 差在哪 |
| [[02-安裝與環境選擇]] | 安裝與環境選擇 | Windows 原生 beta vs WSL2；為什麼建議 WSL2 |
| [[03-核心概念]] | 核心概念 | Workspace / Tab / Pane / Agent / Session / Client-Server |
| [[04-日常操作-滑鼠與鍵盤]] | 日常操作 | 滑鼠優先、prefix 鍵、copy mode、detach |
| [[05-Agent偵測與狀態機制]] | Agent 偵測與狀態 | 五種狀態怎麼來的、integration、`agent explain` |
| [[06-CLI與自動化基礎]] | CLI 與自動化 | pane / agent 兩套指令、wait、read、JSON + jq |
| [[07-Agent-Skill讓AI自己操控Herdr]] | Agent Skill | 讓 Claude 自己下 `herdr` 指令的關鍵一步 |
| [[08-Claude當大腦-Codex當雙手]] | ⭐ 核心架構 | 訂閱額度分工、完整編排腳本、驗收與踩雷 |
| [[09-實戰-刷題網站Taiwan-IM-board]] | 實戰 A | 詳解量產、驗證、圖片與索引重建 |
| [[10-實戰-Obsidian醫學筆記庫]] | 實戰 B | 筆記 pipeline、worktree 隔離、PubMed 界線 |
| [[11-遠端與手機工作流]] | 遠端與手機 | iPhone SSH 巡場、detach/reattach、通知設定 |
| [[12-設定檔-通知-Plugins-SocketAPI]] | 設定與擴充 | `config.toml`、custom command、plugin、socket API |
| [[13-疑難排解與術語速查表]] | 排錯與速查 | 常見症狀對照 + 術語表 + 指令 cheat sheet |

---

## 學習路線

**只想先會用（約 30 分鐘）**：
1. [[01-什麼是Herdr]] → [[02-安裝與環境選擇]] → [[04-日常操作-滑鼠與鍵盤]]
2. 開一個 workspace、跑一次 `claude`、按 `ctrl+b q` detach、再 `herdr` 接回來。會這個就已經賺到。

**要做多 agent 編排（本教學的重點）**：
3. [[03-核心概念]]、[[05-Agent偵測與狀態機制]] 建立正確模型（不然會誤判 agent 到底做完沒）
4. [[06-CLI與自動化基礎]] 學會 `pane` 與 `agent` 兩套指令
5. [[07-Agent-Skill讓AI自己操控Herdr]] 把控制權交給 Claude
6. [[08-Claude當大腦-Codex當雙手]] ← **整份筆記的核心**
7. 照 [[09-實戰-刷題網站Taiwan-IM-board]] 或 [[10-實戰-Obsidian醫學筆記庫]] 實作一次

**想隨時隨地看進度**：
8. [[11-遠端與手機工作流]]、[[12-設定檔-通知-Plugins-SocketAPI]]

出事就翻 [[13-疑難排解與術語速查表]]。

---

## 為什麼這份筆記值得存在（本站作者視角）

現有的痛點，在 [`Taiwan_IM_board/CLAUDE.md`](https://github.com/dirtywolf1213/Taiwan_IM_board) §5 已經寫得很清楚：

> 「一個 agent 約 10–12 題最穩……超過 ~16 題容易 stream idle timeout」
> 「agent 常在 token / 每日滾動上限 / 週上限間擺盪；多數會『寫完檔案才回報上限』，所以失敗也先檢查 `tmp_drafts/` 有沒有產出，再決定重派。」

這兩句話描述的正是「看不見 agent 在幹嘛」造成的成本。Herdr 直接解決這件事：

| 痛點 | Herdr 怎麼處理 |
|------|---------------|
| subagent 是黑箱，只有最後回報 | 每個 agent 是**一個真實終端畫面**，隨時可看 |
| stream idle timeout 整批失敗 | 沒有 stream 這層；agent 是本機 process，慢就慢，不會被切斷 |
| 撞到 Claude 用量上限就停擺 | 幹活的是 **Codex（ChatGPT Plus 額度）**，Claude 只花在規劃與審核 |
| 關掉終端機就沒了 | server 常駐，`ctrl+b q` detach 後 agent 照跑 |
| 要盯著哪個 agent 在等你 | sidebar 直接把 `blocked` 往上冒到 workspace 層級 |

---

## 快速結論（懶人包）

- Herdr 是**基礎設施**，不是另一個 AI。它不會幫你想事情，它讓你同時管好很多個會想事情的 agent。
- 觀念上只有四層：`workspace`（專案）→ `tab`（版面）→ `pane`（真終端）→ `agent`（pane 裡被認出來的 coding agent）。
- **滑鼠就能用完全部功能**，鍵盤 prefix（`ctrl+b`）是選配。
- 真正的殺手鐧是 `herdr` CLI：**agent 自己可以呼叫它**，於是「Claude 開 pane、啟動 Codex、丟任務、等它、讀結果」變成一段可重複的腳本。
- 對本站作者的具體價值：**把 Claude Pro 額度留給判斷與醫學正確性，把 ChatGPT Plus 額度拿去量產**。
- ⚠️ 前提：Codex 產出的醫學內容**仍必須由 Claude（有 PubMed MCP）查證**，這條界線不能因為省額度而放掉。細節見 [[10-實戰-Obsidian醫學筆記庫]]。

---

## 🔗 相關筆記

**三件套（建議一起讀）**：

- [[Programming/Claude-Code/Claude-Code-CLI從0開始使用教學/00-Index|Claude Code CLI 從 0 開始使用教學]] — **大腦**：怎麼設定、怎麼用 skill / hook / subagent
- [[Programming/Codex/Codex-CLI從0開始使用教學/00-Index|Codex CLI 從 0 開始使用教學]] — **雙手**：sandbox / approval 權限模型、`AGENTS.md`、`codex exec`
- 本教學 — **牧場**：同時管理它們的環境

**其他**：

- [[Programming/Codex/Codex從0開始使用教學/00-Index|Codex 從 0 開始使用教學]] — Codex 產品層的觀念（Project / Thread / cloud）
- [[Programming/Codex/Codex從0開始使用教學/07-實戰工作流範例|Codex 07 - 實戰工作流範例]] — 「平行產出 + 中央驗證」的觀念原型，Herdr 是它的執行環境
- [[Programming/Git-GitHub/09-實戰工作流範例|Git 09 - 實戰工作流範例]] — 多 AI 協作時的 rebase / reconcile 紀律
- [[Programming/AI/00-Index|AI 筆記目錄]] — AI 基礎概念

---

## 參考資料

- Herdr 官方站與文件：<https://herdr.dev/> ／ <https://herdr.dev/docs/>
- 原始碼與 `AGENTS.md`：<https://github.com/herdrdev/herdr>
- Agent skill 檔（本教學第 07 章的主角）：<https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md>
- 同類工具比較：<https://herdr.dev/compare/>
- 本教學內容以 repo `docs/next/website/src/content/docs/` 之官方草稿文件為準（讀取日期 2026-08-04，commit `1997b88`），並以 `herdr --help` / CLI reference / `src/main.rs` 交叉核對。
- 第 01 章「外界怎麼描述它」一節，補充自 2026 年多篇獨立評測與導覽文章的共通描述（Mervin Praison、Akmatori、Medium Open Intelligence、CoddyKit、Shareuhack 等），僅用於交叉驗證官方說法，未採用任何與官方文件衝突的敘述。

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