1. 为什么你的 Claude Code 装了 superpowers 却跑不起来superpowers 是 Jesse Vincentobra开源的一套 Agent Skills 框架核心理念是给 AI 编码代理套上一套软件开发方法论先 brainstorm 再 plan然后严格走 TDD而不是一上来就闷头写代码。它主要面向 Claude Code同时兼容 Codex、OpenCode 这类编码代理工具。适合谁适合所有被 AI跳过测试、过度设计、改一处崩三处折磨过的开发者。但国内开发者装它通常会卡在两个地方。第一是拉取源默认走 GitHubclone 阶段就超时插件市场注册直接失败。第二是鉴权Claude Code 和 Codex 各自要配模型端点很多人把 Key 散落在多个配置文件里改一处忘一处最后报 401 却不知道是哪个环节的问题。我试过的组合是用 AtomGit 镜像解决拉取用 TaoToken 统一 Key 解决鉴权两边各配一次Claude Code、Codex、OpenCode 共用同一个 Key。下面按前置准备 → 可复制配置 → 三步验证 → 排障的顺序拆开讲配置骨架可以直接抄。2. 前置准备TaoToken 统一 Key 与镜像源在动手改配置文件之前先把两样东西准备好后面所有步骤都依赖它们。第一样是 TaoToken 的 API Key。它的作用是给你一个统一的模型接入端点Claude Code、Codex、OpenCode 都指向同一个地址和同一个 Key不用每个工具单独申请。注册和创建 Key 的入口在这里控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite Key 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite创建完记得复制Key 一般只完整显示一次。API 基础地址是https://taotoken.net/api注意这个地址不带任何查询参数配置里直接写它。第二样是 superpowers 的镜像源。官方仓库在 GitHub国内直连不稳用 AtomGit 镜像https://atomgit.com/GitHub_Trending/su/superpowers.gitClaude Code 走本地 marketplace 指向这个 git 地址Codex 和 OpenCode 直接在提示词或配置里写这个地址。两样准备好就可以进配置环节了。3. 可复制配置Claude Code 与 Codex 骨架3.1 Claude Codesettings.json 与本地 marketplaceClaude Code 的鉴权配置写在~/.claude/settings.json。如果你之前没这个文件直接新建。核心是把模型请求指向 TaoToken{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥 } }ANTHROPIC_BASE_URL决定请求发往哪里ANTHROPIC_AUTH_TOKEN是鉴权凭证。两个字段名不要写错写错会静默回落到官方端点然后因为网络问题超时你会误以为是插件没装好。接着创建本地 marketplace把插件源指向 AtomGit 镜像mkdir -p ~/.claude/marketplaces/superpowers-cn/.claude-plugin cat ~/.claude/marketplaces/superpowers-cn/.claude-plugin/marketplace.json JSON { name: superpowers-cn, owner: { name: local }, metadata: { description: Superpowers via AtomGit mirror, version: 1.0.0 }, plugins: [ { name: superpowers, source: { source: url, url: https://atomgit.com/GitHub_Trending/su/superpowers.git }, description: Superpowers from AtomGit mirror, strict: true } ] } JSON然后在 Claude Code 里注册并安装/plugin marketplace add ~/.claude/marketplaces/superpowers-cn /plugin install superpowerssuperpowers-cn /reload-pluginsstrict: true表示插件按严格模式加载技能入口不会被随意覆盖建议保留。3.2 Codexconfig.toml 与技能入口固定Codex 的配置在~/.codex/config.toml。模型端点同样指向 TaoTokenmodel_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [model_providers.taotoken.env] TAOTOKEN_API_KEY sk-你的TaoToken密钥装 superpowers 有两种方式。用 CLI 的直接在 Codex 对话里发提示词用国内镜像 https://atomgit.com/GitHub_Trending/su/superpowers 安装 superpowers用 VSCode 插件的再补一条把技能入口固定下来把技能入口固定到 ~/.codex/skills/superpowers固定入口这一步很关键。不固定的话新开对话时 Codex 可能找不到技能目录表现就是装了但没生效。3.3 OpenCodeplugin 数组一行搞定OpenCode 的全局配置在~/.config/opencode/opencode.json在 plugin 数组里加一行{ $schema: https://opencode.ai/config.json, plugin: [ superpowersgithttps://atomgit.com/GitHub_Trending/su/superpowers.git ] }重启 OpenCode启动时会自动安装声明的插件。三个工具的配置到这里就齐了接下来验证。4. 三步验证配置生效、技能加载、最小任务配置写完不代表生效按下面三步逐个确认每步都有明确的成功信号。4.1 第一步检查配置文件生效Claude Code 里执行/config看当前生效的 base URL 是不是https://taotoken.net/api。Codex 里发一句你现在用的是哪个模型端点看返回是否指向 TaoToken。这一步排除的是配置写错位置——比如把 settings.json 写到了项目目录而不是用户目录。4.2 第二步确认 Agent Skills 加载Claude Code 执行/plugin列表里应该能看到superpowerssuperpowers-cn且状态为已启用。Codex 新开一个对话问你有哪些可用的 skills正常会列出 superpowers 相关的技能项。如果列表为空回到 3.2 检查技能入口是否固定。4.3 第三步运行最小示例任务给一个足够小、但能触发方法论的任务比如帮我给一个字符串工具函数加一个 trim 方法先写测试再实现如果 superpowers 生效AI 不会直接甩代码而是先 brainstorm 需求边界再给 plan然后先写测试用例最后才实现。这个先测试后实现的顺序就是最直观的生效信号。想单独验证模型链路是否通可以到模型对话页发一条消息模型对话验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite5. 本篇常见报错排查报错一/plugin marketplace add提示路径不存在。多半是marketplace.json没写对或者目录层级错了。正确路径是~/.claude/marketplaces/superpowers-cn/.claude-plugin/marketplace.json注意.claude-plugin是隐藏目录前面有个点。报错二clone 超时或could not resolve host。说明插件源还在走 GitHub。检查 marketplace.json 里的 url 字段和 Codex 提示词里的地址都必须是atomgit.com开头的那条。报错三401 或鉴权失败。先确认 Key 有没有多余空格再确认字段名。Claude Code 用ANTHROPIC_AUTH_TOKENCodex 用env_key指定的变量名两者不能混。Key 失效的话到 API Keys 页重新生成重新生成 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite报错四装了插件但 AI 行为没变化。九成是没执行/reload-plugins或者 Codex 没新开对话。技能是在会话初始化时加载的旧会话不会自动感知新插件。报错五Codex 里技能入口找不到。回到 3.2确认发过把技能入口固定到 ~/.codex/skills/superpowers这条提示词并检查该目录下是否真的有文件生成。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔用 Claude Code 写点小脚本上面这套配置够用了。但如果你打算把 superpowers 当成日常编码工作流的一部分尤其是跑长任务、多子代理协作的场景建议把接入方式换成 Coding Plan它在长会话和 Agent 编排上的稳定性更好不用每次手动确认端点Coding Plan 接入https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite配置细节和字段说明以官方文档为准遇到本文没覆盖的报错先查文档再动手改接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite最后留一个我踩过的坑改完settings.json后不要只重启终端Claude Code 进程本身也要退出重进否则环境变量不会重新读取。这个细节文档里没写但能省你半小时排查时间。
