生活分享
Claude Code|Agent Teams 的分工、阻塞與成果整合
比較單代理、專責代理與團隊協作成本。Agent Teams 可以讓多個 Claude 工作階段分工,但建立更多角色不一定更快。本篇以待辦篩選為同一個目標,先記錄單代理基準,再分派兩個不重疊的責任,練習處理阻塞、需求變動與最後整合,並把協調時間算進結果。
閱讀時間約 7 分鐘

進階 · CLI
本篇目錄
Agent Teams 可以讓多個 Claude 工作階段分工,但建立更多角色不一定更快。本篇以待辦篩選為同一個目標,先記錄單代理基準,再分派兩個不重疊的責任,練習處理阻塞、需求變動與最後整合,並把協調時間算進結果。
先讀Agent Teams 入門Claude Code|Agent Teams 協作拆分責任、交接依賴並整合多代理成果。Agent Teams 讓多個 Claude Code 工作階段共同處理任務,透過任務清單與訊息協調。本篇用兩個只讀角色檢查待辦網站,示範拆分責任、等待結果與最後整合。它是實驗功能,應先在小型練習專案驗證,不把多個代理同時啟動當成品質保證。閱讀全文、專責審查Claude Code|讓 Subagent 提出可核對的審查發現設計專責代理的範圍、工具及回報格式。讓專責代理審查程式,可以分開檢查資料邏輯與畫面,但兩份回報不會自動變成兩次獨立驗證。本篇建立唯讀的 data-reviewer 與 ui-reviewer,要求每項發現都有位置、條件與影響,再由主工作階段重現、去重並駁回沒有依據的意見。閱讀全文及Worktree 整合Claude Code|雙 Worktree 實作與衝突整合隔離兩項功能,最後完成整合與回歸。兩個 Claude 工作階段同時編輯專案,最容易出現的問題是互相改到同一份檔案,或各自測試通過、整合後卻失敗。本篇用兩個 Worktree 分別處理篩選預設值與介面文字,故意製造一次小衝突,再完成整合、驗證與清理。你不需要先啟用 Agent Teams。閱讀全文。下載第 89 篇材料,使用獨立 starter。需要 Node.js 22、Git 與支援該實驗功能的 Claude CLI;閱讀約 20 分鐘,實作約 75 分鐘。
先確認功能與版本
閱讀完整文字說明
Agent Teams 的分工、阻塞與成果整合,以流程和文件圖形呈現教學重點。
官方文件查證時,Agent Teams 仍屬實驗功能,預設關閉。文件也說明較新版本已調整團隊建立與結束方式,不應直接照舊教學呼叫已不存在的 TeamCreate 或 TeamDelete。先記錄 claude --version,再依當前官方說明啟用並觀察實際提供的工具。
本篇在新終端機的程序環境啟用實驗旗標,避免永久改動所有專案。組織政策或帳號條件仍可能限制功能;旗標不是繞過管理設定的方式。看不到支援時,先做 Worktree 替代實驗,報告明確寫 Teams 未實測。
$env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = '1'
claude
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
啟動後確認實際功能狀態,不以環境變數存在就算團隊已開始。官方文件說明這個模式需要互動式工作階段;claude -p 或 Agent SDK 即使設定相同旗標,仍只建立普通 subagent。較新版本在互動模式使用具名 Agent 啟動隊友,再以訊息與任務清單協調。不要把模型對自己架構的口頭判斷當證據,應核對實際工具事件、隊友回覆及後續訊息是否仍送到同一隊友。
建立單代理基準
先在另一份乾淨 starter,用單一工作階段完成 fixtures/issue.json 的三種篩選需求。記錄開始到驗收結束的總時間、重試、改動檔案與測試結果。不要只量模型產生第一份程式碼的時間,因為整合、修正與瀏覽器操作也屬於完成工作。
基準應使用與團隊實驗相同的需求、材料和成功判準。若單代理只寫資料函式,團隊卻還完成 UI,就不能直接比較總時間。也不要把第一次摸索環境的安裝時間只算到其中一組;測量範圍必須一致並事先說明。
完成後保存基準成果,不把它直接交給團隊當答案。團隊版本使用新解壓縮的同一材料起點,保留相同 fixture 與測試。這樣比較的是工作方式,而不是誰先看過完成版。
分配兩個明確責任
資料角色負責 filter.js 與 tests/filter.test.mjs,定義 all、active、completed 並保留原始資料;畫面角色負責 index.html、app.js、style.css,依約定介面接按鈕與顯示狀態。主工作階段負責界面契約、需求變更與最後驗收。
先把函式名稱、參數模型參數(Model Parameters)是什麼模型參數是訓練時調整、用來把輸入轉成輸出的數值,例如權重與偏差。本文用簡單算式示例說明參數如何影響預測,區分模型參數、訓練超參數、提示詞與生成設定,並解釋參數量、數值精度和啟用參數為何是不同指標。讀完能更準確閱讀模型規格,理解參數增加不等於知識逐條增加,也不代表每次聊天都在重新訓練模型。閱讀全文和回傳形狀寫到 task-contract.md,讓畫面角色可以依契約工作。若兩位都需要修改 package.json,指定單一負責者或由主工作階段處理,不讓共用檔成為隱藏的衝突來源。材料的 agents/team-task.md 可作分工表起點。
請以兩位隊友完成 fixtures/issue.json,先確認功能與工具可用。
資料隊友只改 filter.js 與 tests/filter.test.mjs。
畫面隊友只改 index.html、app.js、style.css,依 task-contract.md 串接。
你負責契約、阻塞協調與最後整合;不新增其他隊友。
任何跨出檔案範圍的需求先回報,不直接修改。
不推送、不建立 PR、不部署。
觀察真實任務分配與角色訊息,確認每個人知道輸入、交付和限制。不要把兩個普通終端機同時執行 Claude 就稱為已驗證 Agent Teams;它們可以是有效替代方案,但機制與證據應分開命名。
模擬阻塞,而不是讓所有人重做
刻意讓畫面角色需要確認未知 mode 的行為:應顯示錯誤還是回到全部。要求它先回報阻塞,保留已完成的部分,不自行改資料契約。主工作階段確認決策後,只通知受影響角色更新,避免整組重新開始。
再模擬一個小需求改動,例如按鈕文字改為「所有待辦」,而資料 mode 仍是 all。畫面角色更新文案,資料角色不必改 enum。這能檢查團隊是否把顯示文字與資料契約混用,也能觀察訊息是否傳到真正需要的人。
紀錄等待原因、收到回覆時間與恢復後的工作。若某位隊友停住,先讀它的最後狀態和缺少資訊,不立刻新增另一位重做相同檔案。角色越多可能讓寫入衝突更難追查,並不自然解決阻塞。
整合前檢查實際檔案
每位角色完成時,回報修改檔案、實際測試命令、未完成項目與可能影響。主工作階段核對 diff,確認沒有超出範圍的改動,也沒有引用只存在於另一個工作目錄的檔案。角色說完成是交接訊號,最終檔案才是整合對象。
若使用 Worktree 隔離,還需要合併分支並處理衝突。若共用同一工作目錄,沒有 Git 合併衝突也不代表沒有互相覆蓋,應檢查最終差異與測試。埠號、暫存檔及外部服務不會因 Git 分支不同就自動隔離。
node --test tests/model.test.mjs tests/filter.test.mjs
git diff --check
git diff --stat
接著啟動網站,用新增、切換完成、三種篩選與刪除走完主要路徑。資料函式測試通過,但 UI 匯入拼錯仍可能失敗;因此整合驗收要在最終工作目錄進行。不要沿用某位隊友在另一個版本上跑過的測試當最後證明。
記錄成本與正常結束
完成後比較單代理與團隊的總耗時、重試、整合問題和實際可取得的用量。只有可觀察數據才填入,沒有 token 或成本資料時標為未知,不估一個漂亮百分比。小任務可能因協調成本而更慢,這也是有用結果。
請主工作階段確認各隊友已結束或完成交接,再正常退出本次練習。依版本確認工作階段與相關終端機狀態,不手動刪除未知的全域團隊資料。若使用自己建立的 Worktree,只有乾淨且已整合的工作目錄才移除。
| 比較項目 | 單代理 | 團隊 | 判讀重點 |
|---|---|---|---|
| 驗收完成總時間 | 實測填入 | 實測填入 | 含整合與修正 |
| 重試與失敗 | 全部保留 | 全部保留 | 不只挑最佳結果 |
| 檔案衝突 | 實際觀察 | 實際觀察 | 與責任分配連結 |
| 用量 | 可取得才填 | 可取得才填 | 未知不當成零 |
為整合者保留最後決定權與證據
將子任務分配出去之後,整合者仍要確認需求是否完整覆蓋。每位成員完成自己的檔案,不能直接推定整個功能可以運作;接口、資料格式與使用者流程需要在最後組合上重新檢查。讓每位成員回報修改檔案、執行命令及尚未處理的項目,整合時才有可比較的依據。
若兩位成員都需要修改同一個檔案,先重新劃分責任或改成依序處理。平行工作帶來的時間節省,必須扣除溝通和衝突處理時間;小到只有一處修改的任務通常不值得強行拆成多代理多代理系統(Multi-agent System)是什麼:分工與協作的代價多代理系統由多個能各自處理任務的代理互相協作,可採主管分工、同儕討論或其他協調方式;它不等於把同一題多問幾次。本文用地方活動策展的例子,說明哪些工作適合並行、如何共享證據和處理衝突,以及為什麼更多代理不保證更準。附分工與驗收方法,幫你區分多代理、子代理和單一代理的多次工具呼叫。閱讀全文。
不支援 Teams 時的替代與完成判準
替代練習可以用兩個 Worktree,由讀者手動傳遞契約和結果,再完成同一整合測試。這能驗證分工與隔離方法,但報告應寫 Worktree 替代流程,Teams 互動仍待測。不要因最終網站能用,就填寫未實際使用的產品功能通過。
交付任務表、單代理基準、阻塞與需求變更紀錄、整合成果和成本觀察。小練習是把本來都改 app.js 的兩個角色重新拆分,說明如何減少重疊,再跑同一案例比較。後續可用流程品質與成本評估Claude Code|比較流程品質、用量與執行時間以同一資料集比較兩種工作方法。比較兩種 Claude 工作方法時,不能只挑成功那一次,也不能只看第一個答案有多快。本篇用固定案例、原始紀錄和一致判準,比較品質、重試、等待與人工整合時間,最後寫出有樣本數與限制的報告,而不是保證某個方法一定省錢。閱讀全文整理長期結果,選擇適合任務的工作方式。
回 Claude Code 教學總目錄Claude Code 完整教學目錄:從入門到自動化依平台、程度與功能找到需要的教學,從 96 篇文章與共用練習專案逐步完成操作。這個教學中心把 Claude Code 分成 96 個可以獨立閱讀的小題目,從桌面、CLI、網頁與手機開始,再學 MD 規則、常用指令、Skills、MCP 與自動化。你可以依推薦路線循序學習,也可以直接搜尋正在遇到的功能、命令或檔名。目錄依目前公開狀態顯示可閱讀文章。閱讀全文
覺得這篇整理實用嗎?分享給需要的朋友
同主題延伸閱讀
生活分享
Claude Code|建立第一個 mod:在 Claude Code 行程內數工具呼叫
寫一個三檔案的 mod,用驗證器與測試確認它掛上的事件。文件把 mod 定義成多了入口檔的 plugin:入口檔叫 hooks module,Claude Code 在事件發生時呼叫裡面的函式,函式可以觀察、改寫或接手事件。
生活分享
Claude Code|Git Worktree 平行工作
隔離多個任務的檔案與分支。Git Worktree 讓同一儲存庫擁有多個工作目錄,各自使用分支與檔案。本篇會把待辦篩選與文件整理分開,確認兩個 session 不會直接改到彼此的檔案,再把其中一個成果整合回主分支。你也會知道何時可以安全清理工作目錄。
生活分享
Claude Code|雙 Worktree 實作與衝突整合
隔離兩項功能,最後完成整合與回歸。兩個 Claude 工作階段同時編輯專案,最容易出現的問題是互相改到同一份檔案,或各自測試通過、整合後卻失敗。本篇用兩個 Worktree 分別處理篩選預設值與介面文字,故意製造一次小衝突,再完成整合、驗證與清理。你不需要先啟用 Agent Teams。
引用本文的文章
資料來源
- Best practices for Claude Code查證日期:
- Create custom subagents查證日期:
- Orchestrate teams of Claude Code sessions查證日期:
- Continue local sessions from any device with Remote Control查證日期:
本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。