高级：用 Claude Agent SDK 搭一支有总管和审稿人的 Agent 团队

你会得到什么

一份搭 Agent 团队 的标准作业流程（SOP）：一个总管负责拆任务和汇总，几个专员各干一件事，一个审稿人把不合格的活打回去，再加上预算、层数和时间三道上限。用的是 Claude Agent SDK（Python），每一步都写了"做什么"和"做到什么算完成"，人可以照着做，也可以直接交给 Claude Code 让它照着搭。

先说结论：大多数任务不需要团队。 一个写得好的单 Agent 更快、更便宜。下面第 0 步先判断你需不需要。

第 0 步：判断要不要团队

满足下面至少一条才值得拆成团队，否则用单 Agent：

条件	例子
任务能拆成互不依赖、可以同时做的几块	同时调研三个竞品
某个子任务会读大量材料，但最后只需要一个结论	读五十页文档，只要三行摘要
某部分需要不同的专业说明或不同的权限	审稿人只能读、不能改

完成标准：能用一句话说出"拆成团队是为了 ___"。说不出来就停在单 Agent。

团队里只有三种角色

总管：接目标、拆任务、派给专员、把结果拼起来。它自己不干细活，也是你唯一对话的对象。
专员：每人只做一件窄事，比如只查证事实、只按材料写稿。越窄越好。
审稿人：只负责对照标准检查，不合格就列出问题打回。最常被省略，也最不该省。

第 1 步：装好 SDK

需要 Python 3.10 以上，以及 Claude Console 的 API key。

pip install claude-agent-sdk
export ANTHROPIC_API_KEY="你的 key"

SDK 不会自动读取 .env 文件，key 要在运行程序的环境里设置好。给别人做产品时，请用 API key 认证，不要接入 claude.ai 账号登录。

完成标准：python -c "import claude_agent_sdk" 不报错。

第 2 步：先让总管一个人跑通

不要一上来就设计整个团队。先让一个 Agent 独立完成整件事，记下三件事：哪里最费 token、哪几块其实互不依赖、哪里质量最不稳。

互不依赖的那几块 → 以后拆成并行的专员；
质量不稳的那一块 → 以后交给审稿人。

完成标准：单 Agent 能完成任务，并且你写下了上面三条观察。

第 3 步：定义专员，description 要写成"什么时候叫我"

专员用 AgentDefinition 定义。prompt 是它的岗位说明；description 决定总管什么时候派活给它，写含糊了，总管要么不用它，要么乱用它。

完成标准：每个专员的 description 都能回答"遇到什么情况该叫它"。

第 4 步：每个角色只给最少的工具

tools 里没列的工具，这个专员根本拿不到。这是最干净的安全开关：

角色	工具
研究员	只给搜索和读网页
写稿人	读和写文件
审稿人	只给读，不给写，否则它会悄悄自己改而不是报告问题
总管	必须有 `Agent`，专员是通过 Agent 工具调起来的

完成标准：没有任何一个角色拿到它用不上的写权限。

第 5 步：交接时把话说全

专员是从空白上下文开始的：看不到总管的对话、工具结果和系统提示，只能看到总管派活时写的那段话。总管说一句"写一下"，写稿人根本不知道写什么。所以要在总管的说明里规定：派活时写清目标、所有需要的材料或文件路径、已经做出的决定、输出格式。

完成标准：随便拿一条派活消息单独看，不看上下文也能开工。

第 6 步：完整团队代码

下面是一个"调研 + 写作"团队：三路并行调研，写稿人只用查证过的材料，审稿人只读，最多返工三轮，外面套着预算、轮数和时间上限。

这段关键内容需要登录后解锁

新用户注册就送 10 积分，每天签到再领 1 积分。用 1 积分解锁，以后随时回来都能看。

完成标准：跑完能在 report.md 里看到成稿，终端打印出花费；故意把预算调到很低，确认会以 error_max_budget_usd 结束。

第 7 步：三道上限，一道都不能少

上限	怎么设	默认值
花费	`max_budget_usd`	不限，必须自己设
层数	环境变量 `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`	3 层，建议设 1
并发	环境变量 `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	20 个
时间	你自己的超时（如 `asyncio.wait_for`）	无

另外按角色设 effort：跑腿的研究员用 low，写稿人和审稿人用 medium，总管从 medium 开始，确有需要再调高。

完成标准：表里每一项都有明确的值。

交给 Agent 执行时

把这篇的链接交给 Claude Code，并说明：

按这篇 SOP 帮我搭一个 Agent 团队，任务是 [你的任务]。从第 0 步开始，每完成一步对照"完成标准"自查，
第 0 步判断不需要团队就停下告诉我。不要跳过第 7 步的上限设置，花费上限先设为 [金额] 美元。

注意

先有一个跑通的 Agent，再加第二个。五个平庸的 Agent 连在一起，不如一个好总管。
不可撤销的动作留给人：起草邮件可以交给团队，发送、发布、付款、删除必须由你确认。
团队修不好你没想清楚的流程：如果你说不清这件事一步步该怎么做，拆给五个 Agent 也一样说不清。