Claude Code 子代理和代理團隊：實用指南

你可能看到過「子代理」、「代理團隊」、「編排」等詞彙，並想知道自己是否錯過了什麼。簡短回答：對於大多數任務來說，沒有。但對於大型工作來說，是的，並且值得了解。

讓我們在不使用術語的情況下解開它。

子代理到底是什麼

子代理是一個具有自己上下文、提示和工具權限的專業助手。

當主代理遇到一個定義明確的子任務時，它會將其委派給子代理。子代理在自己的上下文視窗中工作，完成任務後僅返回結果。主代理不會被其完整歷史汙染上下文，只會得到結論。

這就是重點：保持主代理的上下文清晰。與其讓一個代理在50,000個令牌的檔案搜尋中淹沒，不如讓一個子代理進行搜尋並報告三行有用的資訊。

你可以在專案的.claude/agents/資料夾中宣告你的子代理。每個子代理都有一個名稱、一個說明何時使用的描述和一個系統提示。

---
name: test-writer
description: 當需要編寫或修復測試時使用
---
你編寫測試。你以覆蓋邊緣情況為目標，
而不是快樂路徑。你從不接觸生產程式碼。

代理團隊，進一步提升

代理團隊是內建於Claude Code中的多代理編排器。仍在實驗階段，預設情況下禁用，但它是一個可靠的入門點。

其理念是：一個主代理分解一個大任務，將每個部分委派給一個專業代理（具有自己的模型、提示、工具），這些專業代理在共享檔案系統上並行工作，結果返回給主代理。

如果「委派給專業人員」聽起來像子代理，那是正常的。代理團隊是將這個想法推到真正並行執行多個代理，而不僅僅是一個接一個。

除了內建的，還有第三方編排器如Multiclaude和Gas Town。它們有自己的見解，這使它們成為你開始時的良好起點：它們為你做決定，直到你建立自己的習慣。

什麼時候需要（什麼時候不需要）

讓我們明確：對於95%的代理輔助任務來說，多代理編排是沒有意義的。對於你大多數日常工作來說，單個代理更快更簡單。

目前，多代理仍然是一種昂貴且實驗性的方式來處理大型專案。

你需要它當：

• 專案分成真正獨立的部分，涉及不同的檔案。
• 單個上下文視窗無法容納整個內容。
• 你想並行化一個廣泛的重構或一個儲存庫範圍的遷移。

你不需要它用於修復錯誤、專注的功能或任何可以在一個頭腦中完成的事情。

陷阱在於為一個五分鐘內單個代理就能完成的任務啟動一個十代理的「團隊」。你為任務從未要求的並行性支付了令牌和複雜性的代價。

真正的問題：可見性

這裡有一個不被充分討論的問題。當你執行幾個子代理或一個代理團隊時，你會失去線索。

一個主代理委派給五個專業代理。哪個在工作？哪個完成了？哪個在等待決策？在終端中你看到的是滾動的文字牆，而你無法分辨誰在做什麼。

這就是視覺儀表板改變一切的地方。AgentsRoom將每個代理和每個子代理顯示為自己的瓷磚，狀態一目瞭然。你可以看到委派的發生，看到誰在等待你的回覆，看到誰崩潰了。文字牆變成了一張可讀的地圖。

沒有這種檢視，多代理編排仍然是一個令人印象深刻但日常無法管理的演示。有了它，它就成為了一個你真正使用的工具。

從哪裡開始

不要直接跳到一個八代理的團隊。

從一兩個子代理開始，用於精確、重複的任務：一個編寫測試，一個搜尋程式碼庫。你會很快感受到對主代理上下文的提升。

一旦這種機制變得自然，為清晰分割的工作啟用代理團隊。關注誰在做什麼，在執行前批准計劃，並在審查成為瓶頸時立即停止。

多代理獎勵那些在啟動前進行結構化的人，而不是那些啟動最多代理的人。