1. 为什么 Claude Code 需要 Superpowers 这套技能系统Claude Code 本身已经是一个很强的终端编码助手能读文件、改代码、跑命令。但很多人用一段时间后会遇到同一个瓶颈它太容易“直接开写”。你让它加个导出功能它二话不说先改三个文件改完你一看字段对不上、边界没考虑、测试也没有只能推翻重来。问题不在模型智商而在于缺少一套工程纪律——什么时候该先问清需求什么时候该写计划什么时候必须先写测试。Superpowers 就是补上这块的插件。它是一套跑在 Claude Code 之上的技能Skills框架把“头脑风暴 → 写计划 → TDD → 审查 → 验证”这条链路固化成 Claude 会自动遵守的流程。装上之后Claude 不再是“你说一句它写一段”而是先对齐需求、再动手、收尾给证据。这篇面向想用 TDD 工作流增强编码体验的开发者从安装、settings.json 与 config.toml 配置骨架到技能调用和一次完整 TDD 循环验证全部给可复制的操作。模型通道统一走 TaoToken 的 Key/API省去多平台切换的麻烦。适合谁已经在用 Claude Code、但被返工折磨过的开发者想给团队统一 AI 编码规范的 Tech Lead以及想体验 TDD 但懒得自己搭流程的独立开发者。下面每一步都能直接跟做。2. 前置准备TaoToken 统一 Key 与 API 通道Superpowers 负责“怎么干活”模型通道负责“能不能稳定干活”。Claude Code 需要访问 Claude 系列模型如果你本地环境直连不稳定会话经常断技能流程走到一半就崩体验会很差。我自己的做法是把模型请求统一走 TaoToken 的 API 通道一个 Key 管所有模型调用配置一次到处能用。TaoToken 在这里的角色是统一的模型接入层你拿到一个 API Key把 Claude Code 的请求指向它的 API 地址就不用为每个工具单独配一套凭证。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数配置里直接写它。操作顺序建议这样先注册拿到 Key再配置 Claude Code 的环境变量或配置文件最后验证一次请求通不通确认没问题再装 Superpowers。顺序反了的话插件装好了但模型调不通你会以为是插件的问题白白排查半天。需要提前准备的东西一个可用的 TaoToken API Key在控制台的 API Keys 页面创建较新版本的 Claude Code支持插件系统先跑claude --version确认终端能正常访问网络提示Key 属于敏感凭证不要写进会提交到 Git 的文件里。用环境变量或本地未跟踪的配置文件承载。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层一层是应用级设置settings.json一层是模型/通道相关配置config.toml。下面给的是可直接改用的骨架把占位符替换成你自己的值即可。3.1 settings.json 骨架这个文件通常放在~/.claude/settings.json全局或项目根目录.claude/settings.json项目级。项目级优先级更高适合团队统一规范。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read, Edit, Bash(git status), Bash(git diff:*), Bash(npm test:*) ], deny: [ Bash(rm -rf:*), Bash(git push --force:*) ] }, includeCoAuthoredBy: false }几个关键点解释一下。ANTHROPIC_BASE_URL指向 TaoToken 的 API 基址这样 Claude Code 的所有模型请求都走统一通道。ANTHROPIC_API_KEY填你在控制台创建的 Key。permissions.allow里我特意放开了npm test和git diff因为 TDD 流程会频繁跑测试、看差异每次弹权限确认会打断节奏。deny里挡掉危险命令防止技能流程里误执行破坏性操作。3.2 config.toml 骨架如果你用的是支持 TOML 配置的客户端或 CLI 包装层可以用下面这份[api] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 timeout_seconds 120 [model] default claude-sonnet-4-20250514 max_tokens 8192 temperature 0.2 [skills] enabled true skills_dir ~/.claude/skills auto_invoke true announce truetemperature 0.2是我实测下来比较适合编码的值太低会死板太高容易跑偏。auto_invoke true让技能自动匹配调用announce true让 Claude 每次调用技能时声明“正在使用 XX 技能”过程透明你能随时知道它处于什么模式。3.3 环境变量方式临时验证用不想改文件的话终端里临时导出也行export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 claude --version这种方式只对当前终端会话生效适合先验证通道通不通确认没问题再落到配置文件里。4. 安装 Superpowers 并验证技能系统生效配置好通道后装 Superpowers。推荐用插件市场方式三条命令搞定。4.1 通过插件市场安装在 Claude Code 会话里依次输入/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace /plugin install superpowers-marketplacesuperpowers-marketplace第一条把官方插件市场加进来相当于装了个“应用商店”第二条装 Superpowers 本体第三条装市场插件本身方便以后接收更新推送。装完必须重启会话才生效这一步别省。4.2 CLI 方式安装如果你更习惯在终端里操作对应的 CLI 命令是claude plugin marketplace add obra/superpowers-marketplace claude plugin install superpowerssuperpowers-marketplace claude plugin install superpowers-marketplacesuperpowers-marketplace claude plugin list最后一条claude plugin list用来确认插件处于已安装状态。4.3 手动复制技能快速体验技能本质就是 Markdown 文件不用插件系统也能用。把技能目录复制到 Claude Code 的技能目录即可git clone https://github.com/obra/superpowers.git mkdir -p ~/.claude/skills cp -r superpowers/skills/* ~/.claude/skills/ ls ~/.claude/skills全局目录~/.claude/skills/对所有项目生效项目级.claude/skills/只对当前项目生效。团队规范放项目级个人习惯放全局。4.4 验证安装是否成功重启会话后用下面任意一种方式确认直接问 Claude“你现在有哪些技能”它会列出已加载的技能清单。或者检查目录ls ~/.claude/skills | head -20 claude plugin list安装成功并启用后新会话启动时 SessionStart 钩子会把using-superpowers技能内容注入上下文Claude 从一开始就知道自己有这些技能、该怎么用。如果你问它技能清单它能报出 brainstorming、test-driven-development、systematic-debugging 这些名字就说明生效了。5. 技能调用与一次完整 TDD 循环验证装好之后重点来了怎么让技能真正跑起来以及怎么验证 TDD 流程确实在工作。5.1 技能调用流程Claude 收到消息后的行为链路是这样的先读错误日志避免重犯历史错误再判断当前任务是否匹配某个技能匹配到就调用并声明“正在使用 XX 技能完成 XX”。如果技能带检查清单它会把每一项转成 Todo 逐项跟踪而不是闷头干完。技能优先级是“先流程、后实现”同时匹配多个技能时brainstorming、systematic-debugging 这类流程技能优先前端/后端规范类实现技能其次。指令优先级则是你的明确指令 技能 系统默认提示词。你永远最高说“这次不用 TDD”它就会照做。5.2 手动触发技能除了自动匹配你也可以用斜杠命令手动调用/brainstorming /test-driven-development /systematic-debugging5.3 一次 TDD 循环的验证动作下面用一个真实的小需求演示给一个函数加“计算订单折扣”的能力要求满 100 减 20不满不打折。走 TDD 流程。第一步先写一个会失败的测试红色// discount.test.js const { calcDiscount } require(./discount); test(满100减20, () { expect(calcDiscount(150)).toBe(130); }); test(不满100不打折, () { expect(calcDiscount(80)).toBe(80); });此时discount.js还不存在跑测试必然失败npm test # FAIL ./discount.test.js # Cannot find module ./discount这就是“红色”阶段——测试描述了你期望的行为但实现还没写。第二步写最简实现让测试通过绿色// discount.js function calcDiscount(amount) { return amount 100 ? amount - 20 : amount; } module.exports { calcDiscount };再跑npm test # PASS ./discount.test.js # Tests: 2 passed, 2 total第三步重构。比如把阈值和减免额抽成常量测试保护下随便改const THRESHOLD 100; const REDUCTION 20; function calcDiscount(amount) { return amount THRESHOLD ? amount - REDUCTION : amount; } module.exports { calcDiscount };再跑一次测试仍然全绿说明重构没破坏行为。这就是一个完整的红-绿-重构循环。5.4 验证技能确实介入了关键验证点在整个过程中Claude 应该主动声明“正在使用 test-driven-development 技能”并且先写测试再写实现而不是反过来。如果它直接给你实现代码、跳过测试说明技能没触发。这时你可以手动输入/test-driven-development强制进入或者在提示词里明确说“请用 TDD 流程先写测试”。收尾时verification-before-completion 技能会强制它给出验证证据——测试结果、运行输出而不是一句空洞的“搞定了”。你看到的是Tests: 2 passed这样的实际输出才算真的完成。6. 本篇常见错误排查装和用的过程中下面这些坑我基本都踩过对照排查能省不少时间。报错一Cannot find module或模型请求 401。多半是 API Key 或 base_url 配错了。检查ANTHROPIC_BASE_URL是不是https://taotoken.net/apiKey 有没有多余空格。可以先用环境变量方式临时验证curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的密钥 | head能返回模型列表说明通道没问题问题在 Claude Code 配置层。报错二插件装了但技能不生效。三个检查点一是装完有没有重启会话二是claude plugin list是否显示已安装三是技能目录是否被覆盖或清空。手动方式装的确认~/.claude/skills/下有对应文件夹和SKILL.md。报错三Claude 不自动调用技能。技能匹配依赖 description 与任务的契合度。任务描述太模糊时它可能不触发。解决办法手动斜杠命令调用或在提示词里点名“先做需求分析再动手”。报错四TDD 流程太啰嗦小改动也走全套。技能覆盖的是默认行为你的明确指令优先。一行配置修改直接说“这个很简单直接改”它会跳过流程。任务越复杂越值得走完整流程简单任务走快车道。报错五token 消耗比预期高。头脑风暴、写计划、TDD 都会增加对话轮次。但一次需求理解错误的返工成本往往远超走流程的开销。对复杂任务“多花 20% token少返 200% 的工”是划算的。留意用量别在超大任务上无脑全流程。报错六Windows 下路径或权限问题。技能目录C:\Users\用户名\.claude\skills\要确保可写。路径分隔符用反斜杠复制命令时注意别混用。排障和接入相关的细节可以对照 TaoToken 的接入文档和 API Keys 页面核对参数如果只是想先验证模型对话通不通用模型对话页面发一条测试消息最快。7. 把技能系统用成团队资产Superpowers 真正有意思的地方是技能文件本身是活的 Markdown你可以随时读、随时改。团队规范不用靠口头提醒写成技能放进项目.claude/skills/所有协作者和他们的 Claude 自动遵守同一套流程。错误日志mistake-log/errors.md纳入版本管理后谁踩过坑记一笔全队都不再踩第二次。长期跑编码和 Agent 任务的话把模型通道固定成 TaoToken 的统一 Key配合 Coding Plan 管理用量比每次临时找通道省心得多。技能负责“怎么干得规范”通道负责“干得稳定”两件事分开配好剩下的就是让 Claude 按流程把活干完。最后留一个实用习惯每次让 Claude 报“完成”之前先要它给测试输出或运行日志。看到真实证据再收工比听一句结论靠谱得多。