Agents
运行代理团队
运行代理团队 这一页讲的，就是 运行代理团队 这件事在 Claude Code 里到底怎么用。
页面信息
这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。
如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。
这一页先讲明白
这一页讲的是“多个人一起干一摊活”这件事。
不是一个 Claude 自己来回切角色，而是真的拉出一支小队伍一起干。
你就把它想成包工头带几个工人。你平时主要跟带队的那个说清楚要干什么，带队的再把活分给下面的人。
这种办法适合活大、能拆开、能同时干的时候。要是本来就一条线慢慢做，小队伍反而会显得吵。
先问自己一句：这活能不能分成几路同时干？不能，就别急着拉队伍。
真要拉队伍，也先把“谁去查、谁去改、谁去验”说清楚，别让几个人撞到同一块地。
适合团队的活
下面这几种活，拉一支队伍一起干通常更划算。
1. 好几个地方同时排查问题
2. 一拨人改代码，另一拨人补测试
3. 代码、文档、验收说明分开推进Documentation Index
这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
When to use agent teams
When to use agent teams 到底什么时候值得上，这一段就是在算这笔账。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Compare with subagents
像 Compare with subagents 这种标题，通常就是怕你把两个看着差不多的东西混着用。
Enable agent teams
这一段主要是在拧开关，地方和顺序都别搞错。
如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。
Enable agent teams
这会儿轮到改配置了，字段名和关键字别自己乱换。
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}Start your first agent team
看到这里，就把"Start your first agent team"当成一件真要上手的活来看。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
Start your first agent team
先看下面这块原始片段，等会儿再回头看解释会顺得多。
I'm designing a CLI tool that helps developers track TODO comments across
their codebase. Create an agent team to explore this from different angles: one
teammate on UX, one on technical architecture, one playing devil's advocate.Control your agent team
这段主要是在说平时怎么管，不是光教你怎么开。
Choose a display mode
这里是在帮你做选择题，不是只告诉你"有这个选项"。先看取舍，再决定怎么选。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Choose a display mode 1
想把这条规矩固定住，就把下面这块老老实实写进去。
{
"teammateMode": "in-process"
}Choose a display mode 2
看到这里，别光点头，下面这条命令先跑起来再说。
claude --teammate-mode in-processSpecify teammates and models
看到这里，就把"Specify teammates and models"当成一件真要上手的活来看。
Specify teammates and models
先看下面这块原始片段，等会儿再回头看解释会顺得多。
Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.Require plan approval for teammates
这一块主要是在说"Require plan approval for teammates"真到手上该怎么用，哪里最容易踩坑。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
Require plan approval for teammates
"Require plan approval for teammates"这一段里最要紧的原始写法在下面，先看它怎么落地。
Spawn an architect teammate to refactor the authentication module.
Require plan approval before they make any changes.Talk to teammates directly
这一段主要是在把"Talk to teammates directly"讲实，不是只摆个标题给你看。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Assign and claim tasks
这段看着像个标题，其实是在说"Assign and claim tasks"管到哪儿。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
Shut down teammates
这一块主要是在说"Shut down teammates"真到手上该怎么用，哪里最容易踩坑。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Shut down teammates
这里不是敲命令，而是把下面这句话交给带队的那个 Claude，让它把那位队友稳稳当当地收下来。
Ask the researcher teammate to shut downClean up the team
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
Clean up the team
等队友都停稳了，再把下面这句话交给带队的那个 Claude，让它把整支队伍的摊子收干净。
Clean up the teamEnforce quality gates with hooks
这一段是在说怎么用 hooks 去做 enforce rules when teammates finish work or tasks are created or completed:。看这种内容，光知道名字没用，还是得落到手上。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
How agent teams work
这里主要是在交代"How agent teams work"这一块会碰到哪些事。
How Claude starts agent teams
这里讲底层是怎么运转的。你把它看明白，后面遇到异常时就知道该往哪儿查。
Architecture
看到这里，就把"Architecture"当成一件真要上手的活来看。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
Use subagent definitions for teammates
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Use subagent definitions for teammates
这里不用敲命令，直接把下面这句话发给 Claude 就行，让它按"Use subagent definitions for teammates"这一段的意思去办。
Spawn a teammate using the security-reviewer agent type to audit the auth module.Permissions
这一段主要是在把"Permissions"讲实，不是只摆个标题给你看。
看这段时要特别盯工具和权限边界，别为了省事一把全开。
Context and communication
这里不是让你背"Context and communication"这个词，而是让你看它真干活时怎么使。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
Token usage
这里不是让你背"Token usage"这个词，而是让你看它真干活时怎么使。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Use case examples
这一段主要是在把"Use case examples"讲实，不是只摆个标题给你看。
Run a parallel code review
这一段主要是在把"Run a parallel code review"讲实，不是只摆个标题给你看。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
Run a parallel code review
这一段要真抓重点，通常就抓下面这块原文。
Create an agent team to review PR #142. Spawn three reviewers:
- One focused on security implications
- One checking performance impact
- One validating test coverage
Have them each review and report findings.Investigate with competing hypotheses
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
Investigate with competing hypotheses
"Investigate with competing hypotheses"这一段里最要紧的原始写法在下面，先看它怎么落地。
Users report the app exits after one message instead of staying connected.
Spawn 5 agent teammates to investigate different hypotheses. Have them talk to
each other to try to disprove each other's theories, like a scientific
debate. Update the findings doc with whatever consensus emerges.Best practices
这段算经验活，听劝通常能省事。
Give teammates enough context
看到这里，就把"Give teammates enough context"当成一件真要上手的活来看。
这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。
Give teammates enough context
先看下面这块原始片段，等会儿再回头看解释会顺得多。
Spawn a security reviewer teammate with the prompt: "Review the authentication module
at src/auth/ for security vulnerabilities. Focus on token handling, session
management, and input validation. The app uses JWT tokens stored in
httpOnly cookies. Report any issues with severity ratings."Choose an appropriate team size
这里是在帮你做选择题，不是只告诉你"有这个选项"。先看取舍，再决定怎么选。
这里明显在提醒你：人数不是越多越好。队友一多，花费、沟通和互相绊脚的成本会一起往上走。
Size tasks appropriately
这里讲怎么把活分得刚刚好，不多不少。
原文这种数字建议要当成经验值来用。像 3 到 5 个队友、每人 5 到 6 个任务，意思就是先按这个舒服区间起步，不要一上来拉满。
Wait for teammates to finish
这里是在提醒你先别急着往前冲。该等人的时候就等，别自己抢活。
如果这里反复提 lead 和 teammate，通常是在提醒主代理别抢队友还没做完的活，先等人把结果交回来再继续统筹。
Wait for teammates to finish
这句话是拿来踩刹车的，提醒带队的那个先别急着往前冲，等队友把手头活交回来再说。
Wait for your teammates to complete their tasks before proceedingStart with research and review
这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。
Avoid file conflicts
这一段主要是在把"Avoid file conflicts"讲实，不是只摆个标题给你看。
看这段时要特别盯工具和权限边界，别为了省事一把全开。
照着做一遍
如果你不想来回翻，就先照这几步顺着做。
每做完一步就看一下结果，再决定要不要继续往下。
第 1 步：适合团队的活
下面这几种活，拉一支队伍一起干通常更划算。
1. 好几个地方同时排查问题
2. 一拨人改代码，另一拨人补测试
3. 代码、文档、验收说明分开推进一眼看懂这一页
这页的作用，就是把原本偏专业的话题，拆成能直接照着走的明白话。
运行代理团队
|
v
运行代理团队 这一页讲的，就是 运行代理团队 这件事在 Claude Code 里到底怎么用。
|
v
照着步骤去做文末提醒
这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。
人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。
顺手再看