Superpowers 的 subagent-driven-development 会派出多个子代理并行开工每个子代理都连续发起多轮模型调用。要把这条开发流稳定跑完先把 Key 统一到 TaoToken官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 再让 Claude Code 或 Codex 走同一个 Base URL子代理就不会因为各家 Key 各自为政而中途停摆。如果你用 Claude Code 或 Codex 跑过这种流程应该对那个画面很熟主代理刚把计划拆完十几个子代理同时开始工作每个子代理又继续请求模型终端里滚动得飞快。这篇文章不会停在「Superpowers 很强大」这个结论上而是把从拿 Key、填 Base URL、装插件到跑通一次两阶段审查的完整路径写清楚。1. subagent-driven-development 的两阶段审查为什么一跑就是十几轮调用1.1 子代理每个任务都要先回答「规格上做对了没有」Superpowers 的做法不是让代理直接写代码。writing-plans 技能会把一个需求拆成很多个小任务每个任务都带着确切的文件路径、具体改动和验证步骤进入 subagent-driven-development 之后主代理再为每个任务派发一个全新的子代理。子代理拿到任务后第一遍审查先看规格合规性这个改动是不是真正实现了设计文档里约定的行为边界条件有没有漏测试用例要覆盖哪些输入这一遍不急着看实现细节而是先把「要做什么」对齐。这很像真实团队里先做一轮需求评审再动手。我在本地跑的时候发现只要任务描述里包含「根据设计文档检查规格」子代理就会把相关文档、代码上下文、测试要求一起读一遍然后用一个较短的回答确认自己的理解。关键是这个过程会自动触发不需要你手动敲技能名。Superpowers 在设计里明确过代理在任何任务之前都会检查相关技能这些是强制工作流不是可选的建议。1.2 代码质量审查与 TDD 检查会紧跟上来规格合规性审查通过后同一个小任务还要再走一遍代码质量审查。这一轮子代理要检查实现是否遵守了 TDD 循环先写失败的测试、看到失败、写最少代码、看到通过、再提交。如果发现实现里没有测试或测试与规格对不上它会按严重程度报告问题关键问题会阻止后续进展。也就是说每个子代理的一次完整任务实际包含「规格审查 实现 质量审查」三个阶段的多次模型往返。这里有一个容易被低估的点子代理不是只问一次就结束。每次它要读文件、修改代码、跑测试、对照计划都会产生新的模型调用。当你同时派发 4 个子代理时主代理与子代理之间的状态同步也要占用上下文窗口。所以我在第 1 章就想提醒你subagent-driven-development 真正消耗的 API 调用量比单会话写代码高出好几倍。通道只要稍微不稳定整个计划流就会卡在某个子代理的某一次重试上。1.3 当十几个子代理同时请求问题就不再是模型能力在并行度拉满的时候你会明显感觉到问题焦点变了不是某个模型写代码好不好而是 API 通道能不能同时支撑这么多会话。每个子代理都有独立的任务上下文都在等待模型返回结果。如果这个阶段每个工具各配一套 Key一边是 Claude Code 的 Key 快超额另一边是 Codex 配置里的模型名已经过期排障起来非常痛苦。把 Key 统一到 TaoToken 之后至少「通道不一致」这个变量被去掉了剩下的注意力可以全部放在 plan 执行本身。下一章就讲怎么在官网完成这一步。2. 支持的编码代理先准备统一 Key再对齐 Base URL2.1 打开官网创建 Key并在模型广场确认模型 ID进入 Superpowers 支持的编码代理列表前先把 API Key 准备好。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册账号登录后进入控制台创建 API Key。创建出来的 Key 统一记为 YOUR_API_KEY后面所有配置都用这个占位符来替代不要到处复制乱贴。同一时间还要做的一件事是打开模型广场看看当前有哪些模型 ID 可用我建议把你要用的模型 ID 直接复制出来存到本地笔记里因为后面 Claude Code、Codex、CC Switch 三处都要填同一个模型 ID而模型广场是有可能更新的。很多人在这一步会把「官网地址」和「接口地址」搞混。官网落地页是给人注册、看模型、看用量用的填进工具配置文件里的 Base URL 是给程序请求用的这两个地址不能互替。下面的表格是这次配置的核心对照建议先看清楚再动手。2.2 分清官网落地页和接口 Base URL用途地址注册、创建 API Key、模型广场、用量记录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end填入 Claude Code / Codex / CC Switch 的 Base URLhttps://taotoken.net/api末尾不要加 /v1提示填进工具的 Base URL 一律用 https://taotoken.net/api不要脑补成 https://taotoken.net/api/v1也不要拿 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 去填接口地址。官网页面和接口通道是两回事。2.3 Cursor、Copilot、Gemini CLI 也走同一个通道Superpowers 的支持面不止 Claude Code 和 Codex。原文列出的工具里Cursor 用/add-plugin superpowersGitHub Copilot CLI 用 marketplace 命令安装Gemini CLI 用 extensions install 安装Factory Droid 和 OpenCode 也有各自的安装路径。不过这些工具无论安装方式差多少API 通道是一致的只要它们支持配置 Base URL就填 https://taotoken.net/apiAPI Key 统一用 YOUR_API_KEY。也就是说你在 TaoToken 创建一个 Key就能让这套方法论在多个编码代理之间共享不需要每个工具再去单独开一遍配置。这也是统一接入通道最直接的收益。3. 安装 Superpowers让技能在任务开始前自动触发3.1 Claude Code 从 marketplace 安装 SuperpowersClaude Code 是 Superpowers 支持得最好的一类工具。安装命令分两种二选一即可。一种是从 Claude Code 官方插件市场直接装/plugin install superpowersclaude-plugins-official另一种是从 Superpowers 自己的 marketplace 装好处是技能库更新跟着项目仓库走/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace执行完后重启 Claude Code再随便给它一个小任务观察它是不是先确认技能再开始工作。如果状态栏或者日志里出现了 skill 加载相关的提示说明 Superpowers 已经进入自动触发流程。3.2 Codex CLI 安装后如何确认技能已生效Codex CLI 是另一条主路径。Superpowers 项目说明里写的是通过官方 Codex 插件市场安装具体命令随 Codex 版本会有出入所以这里不太建议凭记忆抄一条过时的命令。装完之后验证方法和 Claude Code 一样重启 Codex给它一个非常小的任务看它回答之前是不是先进入「检查技能」的步骤。只要它开始读取 skill 相关文件就证明安装成功。真正的 API 请求还不一定发生要到实际执行阶段才会调用模型。3.3 安装前后不需要动 Superpowers 文件Superpowers 的安装和 TaoToken 配置是相互独立的先装哪个都行。唯一要记得的是技能本身只是方法论和流程定义真正执行任务时仍然要走你配置好的模型通道。如果 API 通道没配好技能装得再完整子代理也会在第一次请求时报错。所以装完插件下一步就是把工具指向统一接口。4. 把 Claude Code 和 Codex 的请求指到 https://taotoken.net/api4.1 Claude Code 的 settings.json 环境变量配置Claude Code 读取~/.claude/settings.json里的env字段。把下面内容合并进现有配置或者单独创建一个最小文件{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }ANTHROPIC_BASE_URL就是接口地址必须保持https://taotoken.net/api结尾ANTHROPIC_AUTH_TOKEN填官网创建的 KeyANTHROPIC_MODEL填从模型广场复制的模型 ID。如果你之前为官方 API 配置过ANTHROPIC_BASE_URL先删掉旧值再保存否则会继续请求老地址。也可以用临时环境变量的方式跑一次export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID两者的效果一致区别只是配置保存的位置不同。对于长期跑 Superpowers 的开发机建议直接写进 settings.json省得每次开新终端都要 export 一遍。4.2 Codex CLI 的 config.toml 模型供应商配置Codex 不要套用 Claude Code 的 ANTHROPIC_* 变量。它有自己的模型供应商配置通常写在~/.codex/config.toml里。一个参考写法是这样的model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY这里base_url同样是https://taotoken.net/api不要补/v1YOUR_MODEL_ID仍然以模型广场为准。env_key是 Codex 用来读取 API Key 的环境变量名记得在启动 Codex 前先把这个环境变量设成你创建的 Key。不同版本的 Codex 在字段命名上可能略有差异但核心就是model_provider加base_url这一段。4.3 用 CC Switch 管理多个供应商时的最短配置如果你不直接改配置文件而是用 CC Switch 这类工具管理多个编码代理供应商配置逻辑更简单新建一个自定义供应商三个字段填完就能用。供应商名称随意Base URL 填https://taotoken.net/apiAPI Key 填YOUR_API_KEY模型 ID 从模型广场复制后填进会话参数。切换供应商后再启动 Claude Code 或 Codex让它读取你刚保存的配置即可。CC Switch 只是入口底层请求仍然会发到同一个接口地址。4.4 先用 CLI 做一次通道连通性测试在正式跑子代理之前我建议先用命令行做一次最直接的连通性测试。这能帮你把「Key 是否有效」和「模型 ID 是否存在」两个问题一次解决掉npm install -g taotoken/taotoken taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m YOUR_MODEL_ID如果这条命令能完整返回结果说明 Key、模型 ID、Base URL 三者都没问题。再回到 Claude Code 或 Codex 配置就可以把精力集中在 Superpowers 的计划执行上不用怀疑是通道的问题。注意这里的-u参数同样只能是https://taotoken.net/api不要顺手加上/v1。5. 跑一轮 subagent-driven-development在官网控制台看到子代理请求5.1 用 brainstorming 加 writing-plans 生成一份可执行任务清单要验证整套链路不需要一开始就拆一个大型项目。拿一个真实存在的小模块做实验就够了。比如对一个 Node.js 项目里的日期解析函数给它的任务描述可以这样写「当前函数只支持固定时区我想让它支持传入时区参数并补上对应的测试请先用 brainstorming 澄清需求再产出可以交给子代理执行的计划。」你只需要把这段需求发给 Claude Code 或 CodexSuperpowers 会自动激活对应技能先和你讨论几分钟需求细节然后生成一份带文件路径、改动内容和验证步骤的计划。计划生成后先别急着批准。花两分钟把任务块的数量和依赖关系看一遍确认每块都足够小再让主代理进入执行阶段。因为在 subagent-driven-development 里一个任务块对应一个子代理块拆得越粗越容易在某个子代理上出现长时间占用和偶发断连。5.2 让主代理派发子代理观察两阶段审查计划批准后主代理会为每个任务派发新的子代理。你会看到终端里出现多条并行进度有的子代理在读规格文档有的在写测试有的在运行测试命令。每个子代理完成实现后先进行一次规格合规性审查再进入代码质量审查。如果某个子代理的改动和设计文档对不上质量审查会按严重程度报告问题关键问题会阻止当前分支继续推进。这一阶段的 API 调用量会迅速增长但你不必盯着终端刷新。打开官网控制台去观察请求时序是更直观的验证方式。通过这一轮观察你可以确认每个子代理在工作时段里确实发起了多轮请求而不是只在开始和结束时各调一次。5.3 打开官网控制台核对调用时间打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进入用量或请求记录页面按刚才子代理工作的起止时间筛选。你会看到一串请求记录时间戳和终端里的子代理执行顺序能对上。Superpowers 的核心哲学里有一条是「证据优于声明」代理说它做完了不算数要看到实际运行结果。TaoToken 控制台里的请求记录恰好能充当这一层证据——每个子代理的每一步都对应一条真实的模型调用你能从记录里判断哪些子代理空转、哪些子代理卡在重试、哪些子代理顺利完成了两阶段审查。如果这次请求全部返回成功说明你已经在用统一通道跑完整的 subagent-driven-development 了。之后再叠加 Git worktree 并行分支请求量继续往上涨也不会慌因为你知道问题只会出现在计划拆分和模型选择上不会再是 Key 配置不一致。6. 子代理并发时最常碰到的错以及怎么定位6.1 401Key 复制不完整或把官网地址当成了接口 Base URL子代理并发时出现 401最常见的两个原因一是创建 Key 之后复制少了字符或者把提示信息里的占用符也一起复制进去了二是 Base URL 填成了官网落地页地址。检查~/.claude/settings.json或~/.codex/config.toml里的ANTHROPIC_AUTH_TOKEN/env_key确认它就是从官网控制台复制的完整 Key。官网落地页只负责注册、创建 Key、看模型和用量绝不是接口地址。6.2 404Base URL 多写了 /v1有些官方 API 的历史遗留会把/v1放在接口路径末尾但 TaoToken 的接口地址就是https://taotoken.net/api。如果某个子代理在发起第一次请求时就报 404大概率是你把地址写成了https://taotoken.net/api/v1或者https://taotoken.net/v1。把地址里/v1去掉保留https://taotoken.net/api重新启动编码代理再试一次。6.3 model not found模型 ID 不是模型广场当前列出的名字多个子代理同时跑的时候有一个子代理报 model not found其他子代理正常这种状况通常不是通道问题而是你填了一个已经不在模型广场列表里的模型 ID。尤其是从别人截图里抄来的模型名很可能在模型广场更新后就失效了。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进入模型广场复制当前可用的模型 ID替换配置文件里的YOUR_MODEL_ID然后重新发起一次最小调用验证。6.4 多个子代理同时请求时偶发断连如果单次请求正常、一上并发就出现连接中断或限流提示优先去官网控制台看同一时间段的请求密度。请求确实很密集时可以先把任务拆得更小或者让主代理分批派发子代理而不是一次性全量并发。这与其说是故障不如说是任务编排需要调整。TaoToken 侧能给你的是透明可见的请求记录方便你判断到底是通道限流还是某个子代理进入重试死循环。第一次切换通道时别急着开满并行任务。先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 API Key去模型广场确认模型 ID用第 4 章的 CLI 命令做一次最小验证再进官网控制台确认那一条请求已经记录在案。等这一条链路稳定了再让子代理按计划并发跑你会在控制台里看到请求排成一行整个 subagent-driven-development 才真正闭环。