Andrew的筆記園地

閱讀時間約 8 分鐘

⬇ MD

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自己操控HerdrAgent 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 §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醫學筆記庫。

🔗 相關筆記

三件套（建議一起讀）：

其他：

參考資料

最後更新：2026-08-04

關係圖譜

反向連結