多代理人與後台自動化

10.1　同時做很多事：四種分工方式

有時候一個任務很大——比方說「把整個專案的程式重寫一遍」——讓一個 Claude 慢慢做會很久。這時你可以讓好幾個 Claude 同時開工、各做一塊，就像找一組人分工，而不是一個人校長兼撞鐘。

官方提供四種分工做法。它們的差別，講白話就三件事：誰來指揮、它們之間要不要互相講話、會不會同時改到同一個檔案打架。下面用一張表認識它們，看完你大概知道哪些跟你有關、哪些純粹是「知道有就好」。

新手只要先認識前兩種（子代理人、背景代理人）就夠了。後面兩種（agent teams、動態工作流）是給有規模化需求的進階玩家，這裡列出來只是讓你知道天花板在哪——你現在完全不必碰。

10.2　子代理人：派一個小助手去辦事

子代理人，你可以想成是 Claude Code 從主對話裡「派出去的小助手」。你把一件子任務交給它，它自己跑、自己查，做完只把結論帶回來給主對話——中間一堆瑣碎的查找過程，不會塞爆你正在看的主對話。

為什麼要用它？有幾個實在的好處：

• 主對話保持乾淨：瑣碎的查找丟給小助手，你的主對話只看到重點。
• 限制工具範圍：你可以規定某個小助手「只能讀檔、不能改檔」，更安全。
• 跨專案重用：一個寫好的小助手，換個專案也能叫它出來做事。
• 省錢：把不需要動腦的瑣事，交給比較快、比較便宜的模型去做。

怎麼建立、怎麼派它出馬？最簡單的入口是在對話裡打一個指令：/agents。它會開一個面板，讓你建立和管理自己的小助手。下面帶你實際走一遍。

1. 1
   ✋動手做

   在對話裡打開 /agents 面板

   在你正在跟 Claude Code 對話的視窗裡，直接輸入 /agents 再按 Enter。它會跳出一個面板，上面有兩個分頁：Running（執行中）列出目前正在跑的小助手；Library（資料庫）讓你建立和編輯自己的小助手。

2. 2
   ✋動手做

   切到 Library 分頁，建立一個新的子代理人

   點面板上的 Library 分頁，依畫面指示新增一個子代理人。最重要的是幫它寫一段「description（描述）」——用一句話講清楚「這個小助手是幹嘛的」。例如：「專門找出程式裡跑很慢的地方」。

3. 3
   ✋動手做

   讓 Claude 自己決定何時派它出馬

   建好之後你不用每次手動叫它。Claude 會根據你寫的那段 description，在適合的時候自動派這個小助手去做事。描述寫得越清楚，它派得越準。

   ✅ 預期會看到

   # 之後當你交辦相關任務時，主對話裡會看到類似這樣的提示
   > 正在派「效能檢查」子代理人處理這個任務…
   ✓ 子代理人已完成，回報結果如下

   複製

一個實用的玩法是把小助手串起來用。例如你可以這樣交辦：「先用『效能檢查』子代理人找出跑很慢的地方，再用『最佳化』子代理人把它們修好。」一個負責找問題、一個負責修，分工清楚。

想自己手刻一個？子代理人的檔案長這樣

/agents 面板背後其實就是在幫你寫一個檔案。子代理人的定義是一份開頭一段設定、底下接一段 Markdown 說明文字的 .md 檔，放進專案的 .claude/agents/ 資料夾（放在使用者層級的 ~/.claude/agents/ 則每個專案都叫得到）。必填只有兩樣：name（名字）跟 description（描述）——Claude 就是靠這段描述判斷什麼時候該派它出馬，寫得越具體，派得越準。一個最精簡的版本大概長這樣：

# 存成 .claude/agents/code-reviewer.md
---
name: code-reviewer
description: 審查程式碼品質與最佳實務，程式碼一改完就主動使用
tools: Read, Glob, Grep
model: sonnet
---

你是一位程式碼審查員。收到任務時，仔細看過變動的程式碼，
針對品質、安全性、最佳實務給出具體、可以直接動手改的意見。

tools 欄位能把這個小助手能用的工具鎖進一個安全範圍——像這個例子只給了三個唯讀工具，它想手動改檔案也沒有權限，這就是前面「限制工具範圍」那條好處的具體做法。model 欄位決定它跑哪個模型，不寫的話預設沿用主對話當下用的模型。不想留檔案、只是想臨時測試，也可以在啟動指令上用 --agents 旗標直接帶一段等效的設定進去，只在那次 session 有效。要留意的是：如果系統裡設了 CLAUDE_CODE_SUBAGENT_MODEL 這個環境變數，它的優先權比檔案裡的 model 欄位還高，會悄悄蓋過你的設定又不會有任何提醒——子代理人跑的模型跟你預期的不一樣，先檢查看看是不是這個變數在搞鬼。

10.3　讓它在背景默默跑、隨時回來看

有時候 Claude Code 在跑一件要花點時間的工作，你又想空出終端機去做別的事。這時你可以把整個對話「丟到背景」，讓它自己慢慢跑，你的終端機就空出來了。之後想看它跑到哪，再用指令叫它出來。

這三個指令搭配著用：

• 把目前的對話丟到背景：在對話裡打 /background。終端機會被釋放出來，讓你繼續做別的。
• 看所有在背景跑的對話：在終端機打 claude agents，會打開一個「agent view（代理人總覽）」畫面，列出每個對話的狀態，還會標出哪一個正在等你回話。
• 看目前這個對話在背景跑什麼：在對話裡打 /tasks，可以查看、接回、或停掉某個背景任務。

💡 建議執行：想讓它在背景跑時再用

# 在對話裡：把目前這個對話丟到背景，空出終端機
/background

# 在終端機：打開「代理人總覽」，看所有背景對話的狀態
claude agents

# 在對話裡：查看 / 接回 / 停掉目前的背景任務
/tasks

10.4　寫進腳本：用管線把資料餵給它

這一節偏進階，新手看過、知道有這回事就好，不必照做。

平常我們是「跟 Claude Code 對話」——它問你答、來回討論。但有時你只想要一個乾脆的答案、不想進對話，好把它寫進腳本自動跑。這時用 claude -p "你的問題" 就行：它不開對話，直接給你結果。這種「不進對話、直接出答案」的用法，叫做 headless（無介面模式）。

更厲害的是，Claude Code 遵循一個老牌的設計哲學叫「Unix 哲學」——簡單講就是：每個小工具各做一件事、再用「管線」把它們串起來。你可以把其他指令的輸出，用一條直線符號 |（叫做「管線」）餵給 Claude Code，讓它接手分析。

# 把最近 200 行的程式日誌餵給它，發現異常就用 Slack 通知我
tail -200 app.log | claude -p "Slack me if you see any anomalies"

# 把這次相對 main 分支改動的檔案清單餵給它，做一次安全檢查
git diff main --name-only | claude -p "review these changed files for security issues"

claude -p 後面還能接很多參數（flags）去微調行為，完整清單在官方的 CLI 參考頁（章末「官方出處」有連結）。這部分純粹是進階玩家的工具，你現在記得「它能被寫進腳本」這個能力存在就夠了。

如果你想要「不管在哪台機器跑，結果都一模一樣」——像是排進 CI 管線——還有 --bare（跳過 hooks／skills／MCP／CLAUDE.md 自動載入）、--output-format json 這類讓輸出變成程式讀得懂的固定格式可以用，這些留到大師篇的〈Headless 與 CI〉章節細講。

10.5　排程：讓它定時自己跑

除了你主動叫它，Claude Code 還能設定時間自己跑——像鬧鐘一樣，到點就自動執行你交代好的任務。常見的用法像是：每天早上自動幫你審一次程式提交、每週稽核一次相依套件、每晚分析一次測試失敗的原因。你休息時，它仍能繼續工作。

排程有三種做法，差別在「它跑在哪台電腦上、有什麼特點」：

三種裡，/loop 最輕量、就在你眼前的對話裡跑；桌面排程綁你這台電腦；Routines 最強的地方是「電腦關機也照跑」，因為它跑在雲端，不靠你的電腦開著。

💡 建議執行：想試排程時

# 建立一個雲端 routine（之後依面板指示設定時間與任務）
/schedule

# 在同一個對話裡，重複跑同一個提示做輪詢
/loop

Routines 除了「到時間自動跑」，官方還開放另外兩種觸發方式，同一個 routine 可以疊加不只一種：API 呼叫（你自己的系統送一個帶專屬驗證金鑰的請求，等於從外部「按一下開關」）、以及 GitHub 事件（PR 開啟、release 發布時自動觸發）。這代表你能把它接在別的系統後面當收尾——例如告警系統一偵測到異常，順手打一支 API 就讓 Claude 接手去查，不用自己盯著告警面板手動貼進對話框。

10.6　隨處工作：換裝置也不中斷

你的工作不一定要綁死在同一台電腦上。Claude Code 提供好幾個「換場景接著用」的入口——在公司電腦開的工作，回家用手機接著看；在手機上丟個任務，回桌機已經幫你開好。下面這六個入口，看過知道有就好，需要哪個再去設定。