1. 从单 Agent 到多 Agent：为什么你的 claude code 需要 SubAgent 和 AgentTeams
如果你已经在用 claude code 写代码，大概率遇到过这种场景：让它同时改三个页面的样式，它改完第一个就忘了第二个的需求；或者前端组件和后端接口字段对不上，你还得手动来回传话。这不是模型不行，而是单 Agent 的上下文窗口和任务调度方式决定的——一个 Agent 串行处理所有事，上下文一长就开始丢细节。
SubAgent（子代理）和 AgentTeams（多代理团队）就是解决这个问题的。SubAgent 的思路是主 Agent 把任务拆成若干块，每块交给一个拥有独立上下文的子代理去跑，子代理干完只把结果汇报回来，不占用主 Agent 的上下文。AgentTeams 更进一步，多个代理并行开发的同时还能互相通信，比如前端代理可以直接问后端代理“这个接口字段你定好了吗”，协调上下文，避免前后端各写各的。
这套机制适合谁？适合需要并行推进多个模块的开发者，比如一个人同时维护管理后台、移动端 H5 和 API 层；也适合团队里想让 AI 承担更多协调工作的场景。但多 Agent 意味着多路请求并发，如果每个 Agent 都单独配一套 Key 和通道，管理成本会迅速上升。我试过用 TaoToken 统一 Key 来打通这些 Agent 的请求通道，配置一次，所有子代理和代理团队共用同一个入口，省掉大量重复配置。
下面从环境准备开始，一步步把 SubAgent 和 AgentTeams 跑起来。
2. 前置准备：用 TaoToken 统一 Key 打通 claude code 请求通道
claude code 本身通过 Anthropic 兼容接口调用模型，SubAgent 和 AgentTeams 在底层也是走同一套请求链路。所以只要把主通道配好，子代理和代理团队会自动继承。这里用 TaoToken 作为统一入口，好处是一个 Key 覆盖所有 Agent，不用为每个子代理单独申请凭证。
先拿到 Key。打开 TaoToken 控制台，在 API Keys 页面创建一个新 Key，复制出来备用。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，创建时建议给 Key 起个能识别的名字，比如claude-code-multiagent，方便后面排查是哪个 Agent 在用。
拿到 Key 之后，需要确认两件事：一是 API 通道地址，TaoToken 的接口入口是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为 base URL 使用；二是模型名称，claude code 默认走 Anthropic 系列模型，你在配置里填的模型名要和 TaoToken 支持的名称一致，具体可以在模型对话页面确认，地址是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。
如果你打算长期跑多 Agent 协作，尤其是 AgentTeams 这种并行模式，请求量会比单 Agent 高不少。这种情况下可以看一下 Coding Plan，它针对持续编码场景做了额度优化，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，配置过程中遇到字段疑问可以对照查。
环境变量层面，claude code 读取的是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY这两个变量。你可以直接在 shell 里 export，也可以写进 settings.json。多 Agent 场景推荐写进 settings.json，因为子代理启动时会继承主进程的环境，配置文件方式更稳定。
3. 可复制配置：settings.json 接入 TaoToken 与 SubAgent/AgentTeams 骨架
claude code 的配置文件通常放在项目根目录的.claude/settings.json，或者用户级的~/.claude/settings.json。多 Agent 协作建议用项目级配置，这样不同项目可以有不同的 Agent 策略。
先给一份最小可用的 settings.json 骨架，把 TaoToken 通道和 SubAgent 基础配置都放进去：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" }, "subagents": { "enabled": true, "maxConcurrent": 3, "inheritEnv": true }, "agentTeams": { "enabled": true, "communication": true, "maxAgents": 4 } }逐段解释一下。env块里三个变量是核心：ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口，ANTHROPIC_API_KEY填你刚才创建的 Key，ANTHROPIC_MODEL填模型名。subagents块控制子代理行为，maxConcurrent是同时跑的子代理数量，建议从 3 开始，机器和额度都扛得住再往上加；inheritEnv: true表示子代理继承主进程的环境变量，这样它们自动复用同一个 TaoToken Key，不用单独配。agentTeams块里communication: true打开代理间通信，maxAgents控制团队规模。
如果你用的是 AgentTeams 并行模式，建议把maxConcurrent和maxAgents设成一致，避免子代理排队等团队槽位。另外ANTHROPIC_MODEL这个字段，不同版本的 claude code 可能叫法略有差异，有的版本用model而不是ANTHROPIC_MODEL，配置后如果报模型找不到，优先检查这里。
配置写完后，在项目目录下启动 claude code，它会自动读取 settings.json。你可以先用一个简单命令验证通道是否通了：
claude --print "用一句话说明当前使用的模型名称"如果返回了模型名称，说明 TaoToken 通道已经打通，Key 和 base URL 都正确。这一步很关键，因为后面 SubAgent 和 AgentTeams 都依赖这条通道，主通道不通，子代理全部会失败。
4. 验证请求：跑通 SubAgent 与 AgentTeams 的实操动作
通道验证通过后，开始验证 SubAgent。SubAgent 的触发方式是主 Agent 自动识别任务可拆分，你也可以在 prompt 里显式要求拆分。比如在一个有多页面的项目里，输入：
请把首页、关于页、联系页的标题样式统一改成蓝色，用 SubAgent 并行处理。主 Agent 会识别出三个独立任务，分别派给三个子代理。每个子代理拿到自己的上下文，改完只汇报结果。你可以在 claude code 的输出里看到类似[SubAgent 1] 首页标题已更新这样的汇报行。如果只看到一个 Agent 串行处理，说明subagents.enabled没生效，检查 settings.json 是否被正确加载。
AgentTeams 的验证稍微复杂一点，因为它涉及代理间通信。找一个前后端都在的项目，输入：
用 AgentTeams 并行开发：前端代理负责用户列表组件，后端代理负责 /api/users 接口，两者需要对齐字段名。理想情况下，你会看到前端代理在定义字段时主动询问后端代理，后端代理回复字段结构，然后两边各自推进。这个通信过程在输出里会以代理间消息的形式出现。如果两个代理各写各的、字段对不上，说明communication没打开，或者当前 claude code 版本不支持 AgentTeams 通信。
验证成功后，你可以用一个小技巧确认多路请求确实走了 TaoToken：在 TaoToken 控制台的用量页面观察请求数，跑一次 AgentTeams 任务，请求数应该明显多于单 Agent 串行执行。如果请求数没变化，可能是子代理没继承环境变量，回到 settings.json 检查inheritEnv是否为 true。
5. 本篇常见错排查：SubAgent 不触发、AgentTeams 通信失败、Key 继承异常
配置多 Agent 时最容易踩的坑集中在三个地方，我按出现频率排一下。
第一个是 SubAgent 不触发。表现是你明确要求拆分任务，但主 Agent 还是串行处理。原因通常是subagents.enabled写成了字符串"true"而不是布尔值true，JSON 里布尔值不能加引号。另一个原因是maxConcurrent设成了 0 或负数，子代理没有可用槽位。检查方法很简单，把 settings.json 贴到 JSON 校验工具里过一遍，语法错误会直接标出来。
第二个是 AgentTeams 通信失败。表现是多个代理并行跑起来了，但互相不通信，字段对不上。先确认communication是 true，再确认 claude code 版本是否支持 AgentTeams——这个功能比较新，旧版本可能只有 SubAgent 没有 Teams。如果版本没问题，检查maxAgents是否小于实际需要的代理数，比如你开了 5 个代理但maxAgents是 4，第 5 个会被拒绝，通信链路也可能断。
第三个是 Key 继承异常。表现是主 Agent 能跑，但子代理报 401 或 403。这通常是inheritEnv没开，子代理启动时没拿到ANTHROPIC_API_KEY。解决办法是把inheritEnv设为 true，或者干脆在系统环境变量里 export 一份，双保险。还有一种情况是 Key 本身额度用尽，子代理并发请求把额度打满了，这时候去 TaoToken 控制台看一下用量，必要时切到 Coding Plan。
另外提醒一点，多 Agent 并发时请求量是成倍增长的，如果你用的是按量计费，跑 AgentTeams 之前最好估算一下额度。TaoToken 的用量页面可以实时看请求数和消耗，跑之前心里有数。
6. 多 Agent 协作的下一步：把统一 Key 用起来
SubAgent 和 AgentTeams 跑通之后，你会发现多 Agent 协作的核心其实不是模型多强，而是请求通道稳不稳、Key 管不管得住。用 TaoToken 统一 Key 的好处在这里体现得很明显：不管你有多少个子代理、多少个代理团队，底层都是同一个入口、同一套凭证，排查问题时只需要看一个地方。
如果你还没创建 Key，去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 建一个，然后按上面的 settings.json 骨架配进去。配置过程中遇到字段问题，接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里有完整的参数说明。想先确认模型名称和可用性，模型对话页面 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 可以直接试。长期跑多 Agent 编码的话，Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 的额度模型更适合这种并发场景。
最后给一个实用建议：多 Agent 协作初期，把maxConcurrent和maxAgents都设小一点，比如 2 到 3，先观察请求成功率和额度消耗，稳定了再往上加。并行度不是越高越好，通道稳定和上下文对齐才是多 Agent 真正省时间的地方。
