7 步搭建 Claude Agent 团队：从单线对话到并行工作组
原文: @0x_rody on X · 2026-05-24
你写代码，然后 review，然后跑测试，然后写 PR，然后更新文档。每个任务一个接一个，每天如此。
有办法让这 5 件事同时跑起来。每个 agent 处理一项，你专注下一个 feature。
你写代码，然后 review，然后跑测试，然后写 PR，然后更新文档。每个任务一个接一个，每天如此。
有办法让这 5 件事同时跑起来。每个 agent 处理一项，你专注下一个 feature。
下面是 7 步搭建方法 👇
Step 1：先搞清楚 3 个层级
搭团队之前，得先知道手头有什么。Claude Code 自带三种 agent 能力，每种解决不同问题：
Level 1：Subagents → 跑在你当前的 session 里 → 把结果交回给你 → 彼此之间不能通信 → 适合：可重复任务（review、测试、写文档） → 想象一下：你派活的承包商
Level 2：Agent View → 全屏 dashboard，列出所有 session → dispatch、peek、attach 到任意一个 agent → 终端关了 session 也还在 → 适合：3 到 10 个互不依赖的任务 → 想象一下：一块任务板，上面有人在干活
Level 3：Agent Teams → 一个主 agent 协调队友 → 队友之间能互相通信 → 共享任务列表，真正协作 → 适合：跨文件、有依赖的任务 → 想象一下：一支真正的工程团队
大多数人停在 Level 1。今天我们直接奔 Level 3。
Step 2：开启 Agent Teams
Agent Teams 是实验功能。先打开它：
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
加进 ~/.zshrc（Mac）或 ~/.bashrc（Linux），让它一直生效。
Step 3：写第一个团队 prompt
和普通 prompt 最大的区别：把整个项目讲清楚，让主 agent 自己拆。
I need to build a user authentication system. Spawn separate agents to handle:
1. Backend: Create Express.js routes for login, signup, and token refresh
2. Frontend: Build React login and signup forms with validation
3. Testing: Write integration tests for all auth endpoints
4. Review: Review all code produced by the other agents for security issues
主 agent 会拆任务、分角色、spawn 队友。每个队友在自己的 context window 里干活。你能看到哪些 agent 在跑，各自在做什么。
Step 4：分配模型，省钱
5 个 Opus agent 并行跑，token 烧得快 5 倍。主 agent 和队友走不同模型：
# Lead agent: Opus (needs to reason about architecture)
# Teammates: Sonnet (focused execution tasks)
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-5-20250929"
主 agent 跑你正在用的模型（复杂活就上 Opus）。所有队友自动切到 Sonnet，成本 1/5。执行类任务，质量没差，成本只剩零头。
Step 5：用 Agent View 统一管理
团队跑起来之后，切到 dashboard：
claude agents
全屏看每个 session：
┌─────────────────────────────────────────────┐
│ Agent View │
├──────────┬──────────┬───────────────────────┤
│ Backend │ Frontend │ Testing │ Review │
│ ██████░░ │ ████░░░░ │ ░░░░░░░░░ │ waiting │
│ 72% │ 48% │ queued │ for deps │
├──────────┴──────────┴───────────────────────┤
│ > dispatch new task │
└─────────────────────────────────────────────┘
在这里你能：
- Dispatch 新任务给团队
- Peek 任意 agent 的进度，不打断它
- Attach 到需要输入的 agent
- 关掉 laptop，agent 继续跑（终端关了 session 也还在）
Step 6：建一套决策框架
不是每个任务都需要团队。
简单活儿用 agent，纯属浪费 token。
什么时候用什么：
单 prompt、改一个文件
→ 普通 Claude Code session。不用 agent。
3 个独立任务、互无依赖
→ Agent View。一次 dispatch 3 个，跑完看结果。
可重复 workflow（review、test、文档）
→ Subagents 配 YAML。每次一致。
跨文件、有依赖的 feature
→ Agent Teams。主 agent 协调，队友协作。
夜间清积压
→ headless 模式 + --max-budget-usd 上限。
编排模式选错，时间和 token 都白花。独立任务不需要 Agent Teams 那种协调。
有依赖的任务也不该塞进各自孤立的 Agent View session。
Step 7：加上 guardrails
多个 agent 并行，意味着多件事可以同时出错。
把权限锁死：
{
"permissions": {
"allow": [
"Read", "Glob", "Grep", "LS", "Edit",
"Write(src/**)", "Write(tests/**)",
"Bash(npm test *)", "Bash(npx tsc *)",
"Bash(git add *)", "Bash(git commit *)"
],
"deny": [
"Read(**/.env*)", "Read(**/.ssh/**)",
"Bash(rm -rf *)", "Bash(sudo *)",
"Bash(git push *)", "Bash(npm publish *)"
],
"defaultMode": "acceptEdits"
}
}
团队 session 一定要加预算上限：
claude -p "build the auth system" --max-budget-usd 15.00
5 个 agent 每个 $3 = 整支团队 $15 封顶。没有哪个 agent 能脱缰。
完整配置（拷贝即用）
环境变量
# Add to ~/.zshrc or ~/.bashrc
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-5-20250929"
export CLAUDE_CODE_DEFAULT_EFFORT=high
export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1
团队 prompt 模板
I need to [describe the full feature].
Spawn separate agents:
1. [Role 1]: [specific task with files/modules]
2. [Role 2]: [specific task with files/modules]
3. [Role 3]: [specific task with files/modules]
4. Review: Review all code for [bugs/security/style]
Each agent works in its own context. Coordinate through the shared task list. Flag dependencies before starting dependent tasks.
settings.json 里的 guardrails
{
"permissions": {
"allow": ["Read", "Glob", "Grep", "Edit", "Write(src/**)", "Write(tests/**)"],
"deny": ["Read(**/.env*)", "Bash(rm -rf *)", "Bash(git push *)"],
"defaultMode": "acceptEdits"
}
}
前后对比
BEFORE (solo):
- 一次只跑一件事
- 写、review、测、提交，全串行
- 4 个模块的 feature 要花一整天
- 任务切换之间 context 越积越肿
AFTER (agent team):
- 4 个 agent 并行
- Backend、frontend、tests、review 同时跑
- 同样的 feature 2 小时完成
- 每个 agent 有自己干净、聚焦的 context
- 你只 review 和 merge 结果
同一个工具。同一份订阅。差别就在一个环境变量加一句 "spawn separate agents" 的 prompt。
Thanks for reading!
