Anthropic官方教程:如何7步構(gòu)建你的Claude Agent戰(zhàn)隊

你寫代碼，然后審查代碼，接著測試代碼，再編寫 PR，最后更新文檔。每一項任務(wù)，接踵而至，日復(fù)一日。

其實有一種方法可以讓你同時運行這 5 項任務(wù)。當(dāng)你專注于下一個功能開發(fā)時，讓不同的 Agent 分別處理其中的每一項任務(wù)。

以下是具體配置的 7 個步驟

Step 1: 理解 3 個層級

在構(gòu)建團(tuán)隊之前，你需要了解現(xiàn)有的功能。Claude Code 交付了三種 Agent 能力，每種能力解決不同的問題：

Level 1: Subagents
→ 在你當(dāng)前的 session 中運行
→ 向你匯報結(jié)果
→ 彼此之間無法通信
→ 最適合：可重復(fù)的任務(wù)（審查、測試、文檔）
→ 形象比喻：你給他們發(fā)送任務(wù)簡報的承包商

Level 2: Agent View
→ 顯示所有 session 的全屏 dashboard
→ 可以派發(fā)、窺探（peek）并接入（attach）任何 Agent
→ 即使關(guān)閉終端，session 依然存在
→ 最適合：3-10 個獨立的任務(wù)

→ 形象比喻：一個帶有在線工人的任務(wù)看板

Level 3: Agent Teams
→ 由一個主導(dǎo) Agent 協(xié)調(diào)團(tuán)隊成員
→ 團(tuán)隊成員之間可以相互通信
→ 共享任務(wù)列表，實現(xiàn)真正的協(xié)作
→ 最適合：跨文件的相互依賴任務(wù)
→ 形象比喻：一個真正的工程團(tuán)隊

大多數(shù)人從未超越 Level 1。今天，我們將直奔 Level 3。

Step 2: 啟用 Agent Teams

Agent Teams 目前是實驗性功能（experimental）。請先啟用它：

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

將此行添加到你的 ~/.zshrc（Mac）或 ~/.bashrc（Linux）中，以便它始終處于開啟狀態(tài)。

Step 3: 編寫你的第一個團(tuán)隊 Prompt

與常規(guī) prompting 的核心區(qū)別在于：描述完整的項目，并讓主導(dǎo) Agent 對其進(jìn)行拆解。

主導(dǎo) Agent 會將任務(wù)拆解、分配角色并派生團(tuán)隊成員。每個成員都在自己的 context window 中工作。你會看到輸出信息，顯示哪些 Agent 正在活躍以及各自正在處理什么。

Step 4: 路由 Model 以節(jié)省成本

并行運行 5 個 Opus Agent 會讓 token 的消耗速度加快 5 倍。請智能地對你的團(tuán)隊進(jìn)行路由：

主導(dǎo) Agent 運行在你當(dāng)前使用的任何 model 上（處理復(fù)雜工作時使用 Opus）。

所有團(tuán)隊成員將自動使用 Sonnet，成本僅為原來的 1/5。針對專注型任務(wù)，在保證相同質(zhì)量的同時，大幅降低開銷。

Step 5: 使用 Agent View 管理一切
團(tuán)隊運行起來后，切換到 dashboard：

重試

全屏視圖將顯示每一個 session：

在這里你可以：

向團(tuán)隊派發(fā)（Dispatch）新任務(wù)

在不中斷程序的情況下，窺探（Peek）任何 Agent 的進(jìn)度

當(dāng)某個 Agent 需要輸入時，接入（Attach）該 Agent

合上電腦，Agent 仍會繼續(xù)工作（session 在終端關(guān)閉后依然存在）

Step 6: 建立決策框架

并非每個任務(wù)都需要一個團(tuán)隊。在簡單任務(wù)上使用 Agent 會浪費 token。

以下是什么時候該使用什么：

單次 prompt，單文件修復(fù)
→ 常規(guī) Claude Code session。無需 Agent。

3 個獨立的任務(wù)，無依賴關(guān)系
→ Agent View。同時派發(fā)這 3 個任務(wù)，完成后檢查結(jié)果。

可重復(fù)的工作流（審查、測試、文檔）
→ 帶有 YAML 配置的 Subagents。每次都能保持一致。

具有依賴關(guān)系的多文件功能開發(fā)
→ Agent Teams。主導(dǎo) Agent 進(jìn)行協(xié)調(diào)，團(tuán)隊成員相互協(xié)作。

通宵清理積壓任務(wù)（backlog）
→ 帶有 --max-budget-usd 上限的 Headless 模式。

錯誤的編排（orchestration）模式既浪費時間又浪費 token。獨立的任務(wù)不需要 Agent Teams 的協(xié)調(diào)，而有依賴關(guān)系的任務(wù)也不應(yīng)該在隔離的 Agent View session 中運行。

Step 7: 添加 Guardrails（防護(hù)欄）

多個 Agent 并行運行意味著多件事情可能會同時出錯。

請將其鎖定：

并且一定要為團(tuán)隊 session 設(shè)置預(yù)算上限：

5 個 Agent，每個預(yù)算 3 美元 = 整個團(tuán)隊上限 15 美元。這樣沒有任何一個 Agent 會因為失控而超支。

完整配置

環(huán)境變量

團(tuán)隊 Prompt 模板

settings.json 文件中的安全約束機(jī)制

改變前后的對比

同樣的工具。同樣的訂閱。

區(qū)別只在于一個環(huán)境變量，和一句“派生獨立的 Agent”的 prompt。