# 7 步搭建 Claude Agent 团队：从单线对话到并行工作组
> **原文**: [@0x_rody on X](https://x.com/0x_rody/status/2058475548242784649) · 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 和队友走不同模型：
```bash
# 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：
```bash
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 并行，意味着多件事可以同时出错。
把权限锁死：
```json
{
"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 一定要加预算上限：
```bash
claude -p "build the auth system" --max-budget-usd 15.00
```
5 个 agent 每个 $3 = 整支团队 $15 封顶。没有哪个 agent 能脱缰。
---
## 完整配置（拷贝即用）
### **环境变量**
```bash
# 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
```json
{
"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!**
---
**原推文链接**: https://x.com/0x_rody/status/2058475548242784649