为什么要在 Claude Code 里装 superpowers
Claude Code 本身是一个终端里的编码代理,能读写文件、跑命令、做重构。但默认状态下,它更像一个"能动手的助手",而不是一个"有章法的工程搭档"。superpowers 这个插件做的事情,就是给 Claude Code 补上一套技能(Skill)与工作流约束:让它在动手前先规划、在改代码前先理解上下文、在完成任务后主动验证。对于经常用 Claude Code 做长期项目的人来说,这套插件能明显减少"改一半发现方向错了"的情况。
问题出在模型请求这一侧。Claude Code 安装插件、加载 Skill、执行/plugin系列命令,这些动作本身走的是本地逻辑和插件市场,跟模型通道无关。但插件装好之后,Claude Code 每次对话、每次让模型规划任务,都要向模型服务发请求。如果你的网络环境直连官方接口不稳定,或者你想统一管理多个模型的调用入口,就需要把 Claude Code 的模型请求指向一个可控的通道。TaoToken 在这里的角色很明确:它只负责模型请求侧,不替代 superpowers,也不改变插件的安装步骤。你仍然用/plugin install superpowers@claude-plugins-official装插件,只是让 Claude Code 的 Base URL 走 TaoToken。
这篇就按这个顺序来:先在 TaoToken 官网创建 Key,把 Claude Code 的模型通道配好,再执行 superpowers 的安装命令,最后用/plugins搜索确认插件到位。全程不碰插件本身的安装逻辑,只调整模型请求的出口。
TaoToken 前置准备:拿 Key、配通道
在开始装 superpowers 之前,先把模型通道准备好。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并登录,进入控制台。左侧找到 API Keys 相关入口,创建一个新的 Key。这个 Key 就是 Claude Code 向 TaoToken 发请求时的凭证,格式类似YOUR_API_KEY,创建后复制保存,后面配置要用。
TaoToken 的 API 地址是https://taotoken.net/api,这个地址会作为 Claude Code 的 Base URL。注意这里不要加任何查询参数,保持干净。Key 和 Base URL 这两样东西,是接下来配置 Claude Code 的核心。
如果你之前已经装过 Claude Code,可以直接跳到配置环节。如果还没装,Claude Code 的安装方式这里不展开,按官方文档走即可。装好之后,终端里运行claude能进入交互界面,就说明基础环境没问题。
需要强调的是,TaoToken 在这里只出现在模型请求侧。superpowers 插件的安装、市场添加、Skill 加载,全部还是 Claude Code 自己的机制。不要把 superpowers 换成 TaoToken,也不要用 TaoToken 去替代插件市场。两者是不同层面的东西:一个是模型通道,一个是插件生态。
可复制配置:让 Claude Code 走 TaoToken
Claude Code 的模型通道配置,核心是环境变量和 settings 文件。不同版本可能略有差异,但思路一致:把 Anthropic 相关的 Base URL 和 API Key 指向 TaoToken。
最直接的方式是在终端里设置环境变量。打开你的 shell 配置文件,比如~/.zshrc或~/.bashrc,加入以下内容:
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="YOUR_API_KEY"保存后执行source ~/.zshrc(或对应文件)让配置生效。这样 Claude Code 启动时就会读取这两个变量,把模型请求发到 TaoToken。
如果你更习惯用 Claude Code 的 settings 文件,可以在~/.claude/settings.json里配置。这个文件是 Claude Code 的全局设置入口,内容大致如下:
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "YOUR_API_KEY" } }把YOUR_API_KEY替换成你在 TaoToken 控制台创建的真实 Key。保存后重新启动claude,配置就会加载。
这里要注意,ANTHROPIC_BASE_URL填的是https://taotoken.net/api,不要多加斜杠或路径。ANTHROPIC_API_KEY填 TaoToken 的 Key,不是 Anthropic 官方的 Key。这两个变量名是 Claude Code 识别的标准名称,不要改成别的。
配置完成后,可以先不装 superpowers,直接运行claude发一条简单消息,确认模型通道通了。如果回复正常,说明 TaoToken 这一侧已经生效。然后再去装插件,这样出问题的时候容易定位是通道问题还是插件问题。
安装 superpowers 并验证
模型通道配好之后,superpowers 的安装就按它自己的流程走。终端运行claude进入交互界面,然后根据你选择的方式执行命令。
方式一,直接让 Claude Code 帮你装。在对话里输入类似"帮我安装一下 https://github.com/obra/superpowers"的指令,Claude Code 会引导你执行/plugin install superpowers@claude-plugins-official。这条命令是从 Anthropic 官方市场安装 superpowers,安装时选择安装到当前用户即可。
方式二,手动执行官方市场安装命令。在 Claude Code 交互界面里直接输入:
/plugin install superpowers@claude-plugins-official这是最常用的方式,插件来自官方市场,版本和兼容性相对有保障。
方式三,从 Superpowers Marketplace 安装。先添加市场:
/plugin marketplace add obra/superpowers-marketplace然后从这个市场安装插件:
/plugin install superpowers@superpowers-marketplace这个市场除了 superpowers 本身,还提供一些相关插件,适合想一起装齐的人。
三种方式选一种即可,不需要重复安装。装完之后,用/plugins命令搜索 superpowers 来确认:
/plugins在插件列表里搜索 superpowers,能看到已安装的条目,就说明插件到位了。此时 Claude Code 已经具备 superpowers 提供的 Skill 和工作流能力,而模型请求仍然走你配置的 TaoToken 通道。
验证的时候可以做一个简单测试:让 Claude Code 执行一个需要规划的任务,观察它是否按照 superpowers 的工作流先做分析再动手。如果行为符合预期,说明插件和模型通道都在正常工作。
本篇常见错排查
问题一:装完 superpowers 后,Claude Code 报模型请求失败。这通常是通道配置问题,不是插件问题。检查ANTHROPIC_BASE_URL是否填成了https://taotoken.net/api,ANTHROPIC_API_KEY是否是 TaoToken 的 Key。如果环境变量和 settings.json 同时配了,确认两者一致,避免冲突。改完配置后要重启claude才生效。
问题二:/plugin install命令执行后没反应或提示市场不可用。插件市场走的是 Claude Code 自己的网络请求,跟模型通道是两回事。如果市场访问不稳定,可以换一种安装方式,比如从obra/superpowers-marketplace添加市场后再装。插件安装本身不经过 TaoToken,所以不要试图用 TaoToken 的地址去替代市场地址。
问题三:/plugins搜索不到 superpowers。先确认安装命令是否执行成功,有没有报错。如果安装时选了安装到当前项目而不是当前用户,可能需要在对应项目目录下运行claude才能看到。另外,插件安装后有时需要重启 Claude Code 会话才能加载,退出后重新运行claude再试。
问题四:模型通道通了,但 superpowers 的 Skill 没生效。检查插件是否真的装到了当前用户或当前项目。superpowers 提供的是一组 Skill,Claude Code 需要在会话中加载它们。如果/plugins里能看到但行为没变化,尝试新开一个会话,让插件在启动时重新加载。
问题五:Key 泄露或额度异常。如果怀疑 Key 被滥用,去 TaoToken 控制台重新生成一个 Key,然后更新ANTHROPIC_API_KEY。不要把手里的 Key 直接写进会提交到 git 的文件里,环境变量或本地 settings 文件相对安全。
模型通道与插件生态各归其位
回到最初的问题:Claude Code 装 superpowers,模型请求走 TaoToken 行不行?答案是行,而且两者互不干扰。superpowers 的安装步骤不变,/plugin install superpowers@claude-plugins-official或从obra/superpowers-marketplace市场安装,再用/plugins搜索验证,这些全部照旧。TaoToken 只做一件事:让 Claude Code 的模型请求走https://taotoken.net/api这个通道。
如果你在配置过程中遇到 Key 或接入相关的问题,可以去 TaoToken 的 API Keys 页面和接入文档对照检查,确认 Base URL 和 Key 的填写方式。想先验证模型通道是否正常,可以直接用模型对话功能发一条测试消息。如果你打算长期用 Claude Code 做编码和 Agent 任务,Coding Plan 更适合持续调用场景,可以在控制台了解具体方案。
把通道配好,把插件装好,剩下的就是让 Claude Code 带着 superpowers 去干活了。