★ FEATURED ARTICLE 1. 为什么你的 AI 编程助手总在“瞎写代码”先说一个我踩过的坑。前阵子让 Claude Code 给一个用户模块加批量导出它二话不说直接甩出一段export async function exportUsers()没有分页、没有流式处理、没问数据量。跑起来内存直接飙到 2GOOM 报错糊了我一脸。问题不在模型能力而在于它缺少一套“先想清楚再动手”的工作方法论。superpowers-zh 就是来解决这件事的。它是 superpowersGitHub 上 159k star 的 AI 编程技能库的完整汉化增强版额外加了 4 个中国原创 skills覆盖从头脑风暴、TDD、代码审查到调试的完整链路。装完之后同样一句“加个批量导出”AI 会先反问你导出格式是 CSV 还是 Excel预计数据量多大需要异步吗有权限要求吗然后给出 2-3 个方案让你确认再动手写代码。它适合谁三类人一是用 Claude Code、Cursor、Trae、Windsurf、Kiro、Gemini CLI 等 17 款 AI 编程工具的开发者二是团队里想统一 AI 协作规范的技术负责人三是被 AI“自信地写出错误代码”折磨过的所有人。核心检索词就一个superpowers-zh 安装配置让 AI 编程超能力在中文环境真正落地。这篇不是注册教程我会把安装命令、配置文件片段、验证步骤、以及怎么通过 TaoToken 统一 Key/API 通道接进去全部给到可复制级别。你跟着敲就行。2. 安装 superpowers-zh 前先把 TaoToken 通道配好很多人装完 superpowers-zh 发现 skills 是加载了但 AI 工具本身连不上模型或者 Key 散落在四五个工具里各配一遍换台机器就崩。所以第二步我们先解决“通道”问题——用 TaoToken 统一管理 Key 和 API 入口。TaoToken 是什么简单说它是一个统一的模型 API 通道。你不用在每个 AI 编程工具里分别填不同的 Base URL 和 Key而是所有工具都指向同一个入口Key 也只维护一份。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 这个不加 UTM直接填进配置里。为什么装 superpowers-zh 之前要先配这个因为 superpowers-zh 本身只是“技能包”它负责告诉 AI 怎么思考、怎么提问、怎么按 TDD 流程走。但 AI 工具要真正跑起来底层得有模型通道。你如果先装 skills 再配通道中间调试报错会分不清是 skills 没加载还是 Key 没通。顺序反过来通道先通再装 skills验证链路清晰。具体操作先去 console 页面 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建一个 API Key。然后在 api-keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 可以看到你刚生成的 Key复制出来。这个 Key 后面要填进 Claude Code 的 settings、Cursor 的配置、以及 Codex 的 auth.json 里。这里有个关键点TaoToken 的 Base URL 统一是https://taotoken.net/apiModel ID 根据你用的模型填比如claude-sonnet-4-20250514或gpt-4o这类。三个要素——Base URL、Key、Model ID——缺一不可。我见过太多人只填了 Key 忘了 Base URL然后报 401以为是 Key 失效其实是请求根本没打到正确入口。配好之后你可以先用模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发一条测试消息确认 Key 和通道是通的。这一步花两分钟能省掉后面半小时的排障。如果你打算长期用 AI 做编码和 Agent 任务可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对高频编码场景做了额度优化。不过这是后话先把基础通道跑通。通道通了之后我们再进第三步——真正安装 superpowers-zh 并写配置文件。3. 可复制配置superpowers-zh 安装命令与 settings 片段这一步是核心。superpowers-zh 的安装方式很直接用 npx 就行。但不同 AI 编程工具的目录结构和配置文件不一样我按工具拆开讲你对照自己的工具抄。3.1 通用安装先跑默认命令打开终端进入你的项目根目录比如G:\zhixing或~/projects/myapp然后执行npx superpowers-zh如果你没指定工具它会输出类似这样的提示superpowers-zh v1.3.0 — AI 编程超能力中文版 源: 20 个 skills 目标项目: G:\zhixing 未检测到任何已知的 AI 编程工具。 如果你使用的是 Cursor、Trae 等工具请用 --tool 指定 npx superpowers-zh --tool cursor npx superpowers-zh --tool trae 现在将默认安装到 .claude/skills/兼容 Claude Code / OpenClaw 默认安装: 20 个 skills - G:\zhixing\.claude\skills Claude Code: bootstrap - G:\zhixing\CLAUDE.md 安装完成重启你的 AI 编程工具即可生效。默认它会装到.claude/skills/同时给 Claude Code 写一个 bootstrap 到CLAUDE.md。如果你用的就是 Claude Code到这一步基本就完事了。3.2 Claude Code 的 settings 配置片段Claude Code 需要读settings.json来知道模型通道。路径通常在~/.claude/settings.json或项目级.claude/settings.json。你要把 TaoToken 的三件套填进去{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }注意 Base URL 后面不要加/v1TaoToken 的入口就是https://taotoken.net/api。Model ID 按你实际用的填。填完保存重启 Claude Code。3.3 Cursor 的配置Cursor 在设置里找 Models 或 API Keys填入Base URL:https://taotoken.net/apiAPI Key: 你的 TaoToken KeyModel: 选对应模型然后安装 skillsnpx superpowers-zh --tool cursor它会装到.cursor/skills/或类似目录具体看版本输出。3.4 Trae 的激活Trae 用户执行npx superpowers-zh --tool trae输出会显示Trae: 20 个 skills - G:\traework\traeyan\.trae\skills Trae: bootstrap rule - G:\traework\traeyan\.trae\rules\superpowers-zh.mdTrae 的规则文件在.trae/rules/superpowers-zh.mdskills 在.trae/skills/。重启 Trae 生效。3.5 Codex 的 auth.json如果你用 Codex配置在~/.codex/auth.json{ base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model: gpt-4o }三件套齐了Base URL、Key、Model ID。3.6 VS Code / CodeArts 手动激活VS Code 执行npx superpowers-zh --tool vs-code输出VS Code: 20 个 skills - G:\zhixing\.github\superpowers但 CodeArts 比较特殊它的项目级技能目录是./.codeartsdoer/skills和./.codeartsdoer/rule。你需要手动创建目录并挪文件mkdir -p ./.codeartsdoer/skills然后把G:\zhixing\.github\superpowers里的 skills 挪到./.codeartsdoer/skills下。挪完再打开 CodeArts就能在项目技能里看到这 20 个 skills 了。配置这块的核心就一句话Base URL 统一https://taotoken.net/apiKey 用 TaoToken 的Model ID 按需填。三个都对了通道就通。4. 验证请求确认 skills 加载与模型调用成功装完不验证等于没装。这一步我给你两个验证动作一是确认 skills 真的被 AI 工具读到了二是确认模型请求能通。4.1 验证 skills 加载以 Claude Code 为例重启后进入项目输入一句测试提示帮我给用户模块加个批量导出功能如果 superpowers-zh 生效了AI 不会直接写代码而是先反问你在开始实现之前我需要了解几个关键问题 1. 导出格式是 CSV 还是 Excel 2. 预计数据量多大需要异步处理吗 3. 有权限要求吗 → 给出 2-3 个方案确认后再动手看到这个反问说明 skills 加载成功。如果它还是直接甩代码说明 skills 没被读到检查.claude/skills/目录下有没有那 20 个 skill 文件夹。4.2 验证模型通道在 Claude Code 里发一条简单请求比如“用一句话解释什么是 TDD”。如果正常返回说明 TaoToken 通道通了。如果报错看第五节的排障。你也可以直接在模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发消息确认 Key 本身有效。这一步能区分是 Key 问题还是工具配置问题。4.3 验证 TDD skill 的实际效果superpowers-zh 里有个 TDD skill我实测下来最有感。你输入用 TDD 方式实现一个字符串反转函数正常流程应该是先写测试用例跑测试看它失败再写实现让测试通过最后重构。如果 AI 直接给你实现代码而没先写测试说明 TDD skill 没激活。这时候检查.claude/skills/下有没有tdd相关目录。验证通过后你就可以正常用了。但实际过程中报错是常态。下一节我把常见错列出来。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节是实战排障。我按报错原文对照你遇到哪个查哪个。5.1 401 Unauthorized最常见。原因通常是三个Key 填错、Base URL 填错、或者 Key 过期。先检查 Base URL 是不是https://taotoken.net/api不要多写/v1也不要少写。然后检查 Key 有没有复制完整前后有没有空格。最后去 api-keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 确认 Key 还在有效状态。如果三件套都对还报 401试试在模型对话页面直接发消息。那边能通说明 Key 没问题是工具配置的锅。5.2 local proxy failed这个报错通常出现在你本地配了代理但代理没起来或者端口不对。superpowers-zh 本身不涉及代理但你的 AI 工具可能读了系统代理设置。排查检查环境变量HTTP_PROXY/HTTPS_PROXY有没有设成无效地址。如果有临时清掉unset HTTP_PROXY unset HTTPS_PROXY然后重启工具。注意这里说的是本地开发环境的代理配置问题不是让你去搞什么网络通道纯粹是环境变量冲突。5.3 reading choices 相关报错这个一般出现在模型返回格式和工具预期不一致时。比如你 Model ID 填了一个工具不认识的模型它解析响应时读不到choices字段。解决确认 Model ID 是工具支持的。Claude Code 用claude-sonnet-4-20250514这类Cursor 用对应模型名。别填一个不存在的模型 ID。5.4 OAuth 报错有些工具默认走 OAuth 登录流程但你用的是 API Key 模式两者冲突。比如 Claude Code 如果之前登录过官方账号它可能优先走 OAuth。解决在 settings.json 里明确用ANTHROPIC_API_KEY而不是 OAuth token。或者退出登录状态强制走 Key 模式。Codex 的 auth.json 里也是同理确保api_key字段有值而不是空的 OAuth 字段。5.5 skills 不生效装完了但 AI 还是直接写代码。检查三点一是目录对不对Claude Code 看.claude/skills/Trae 看.trae/skills/二是重启了没很多工具要重启才读新 skills三是 bootstrap 文件写了没Claude Code 看CLAUDE.mdTrae 看.trae/rules/superpowers-zh.md。如果都对了还不生效试试重新跑一次安装命令加--force参数覆盖。排障的核心逻辑先确认通道Key/Base URL/Model再确认 skills 目录最后确认工具重启。三层都过了基本没坑。6. 把通道和技能串起来长期编码的稳定姿势装完 superpowers-zh、配好 TaoToken 通道、验证通过之后你得到的是一个“会先想再动手”的 AI 编程环境。但要用得久还有几个实用技巧。第一Key 只维护一份。所有 AI 工具都指向https://taotoken.net/api换工具不用重新配 Key。团队协作时把 settings 片段写进项目文档新人 clone 下来改个 Key 就能跑。第二skills 跟着项目走。superpowers-zh 装到项目目录下比如.claude/skills/随代码库分发。团队每个人的 AI 工具读同一套 skills输出风格和流程就统一了。这比口头约定“你要先问清楚再写代码”靠谱得多。第三长期高频编码的话Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 比按量付费更划算。它针对 Agent 和长会话场景做了优化不会因为一次复杂任务跑太多轮就额度告急。第四接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有各工具的详细配置示例遇到不确定的字段去那边对照。Claude Code 的 Anthropic 兼容配置在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 有专门说明。最后说个真实体验superpowers-zh 最大的价值不是让 AI 写得更快而是让它写得更对。以前我要反复纠正“你没分页”“你没处理异常”“你没问需求”现在它自己会问。省下来的不是打字时间是返工时间。通道用 TaoToken 统一之后换工具、换机器、团队协作都不再是负担。这套组合我用了几个月稳定性没问题。你按上面的步骤走一遍半小时内能跑通。
阅读完成 · 觉得有帮助？
