企业官网建设流程全解析

Jesse（obra）昨天又在 GitHub 上更新了 Superpowers，star 数已经突破 3 万。这个插件解决的问题很直接：Claude Code 以前拿到需求就开写，现在要先 brainstorming、强制 TDD、四步调试。想稳定跑完这套流程，Key 我建议用 TaoToken——先打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并创建 API Key，再把 Claude Code 的 Base URL 填成 https://taotoken.net/api。前一个地址是给人点的官网落地页，用来注册、建 Key、看模型广场、看用量；后一个地址是给工具填的接口，末尾没有 /v1。这两个别弄混，下面每一步都按这个区分来。

1. Superpowers 是什么：让 Claude Code 先想清楚再动手

1.1 从技能树看作者的设计思路

Superpowers 不是独立程序，作者 Jesse Vincent 把它做成了 Claude Code 的插件系统。装好之后，Claude Code 的命令行里会多出一组以/superpowers:开头的命令。最常用的几个是brainstorming、test-driven-development、systematic-debugging、writing-plans、subagent-driven-development。

brainstorming适合的场景是你只有一个模糊想法，希望 AI 帮你把需求问清楚。作者在实现上刻意让它「多问、少猜」，所以技能触发后不会立刻写代码，而是逐个确认：用户是谁、关键路径是什么、异常情况怎么处理。第一次用会不太适应，但这个过程本质上是在模拟一个负责任的开发者在开工前会做的事。

test-driven-development对不熟悉测试的人来说最反直觉：以前写完代码才看结果，现在要先写一个失败测试来定义「什么叫做完成」。等测试真的从红变绿的时候，你已经拿到一个可验证的单元，而不是一大坨没跑过的代码。

systematic-debugging则是给「乱改 bug」这份冲动装了个刹车。遇到报错先按固定步骤走：收集现场数据、提出可能原因、设计最小验证、验证后再修改。它拦住的是你「顺手试一下」的念头。

writing-plans把大需求拆成 2-5 分钟能完成的小任务，subagent-driven-development再把这些小任务交给多个子代理流水线式执行。小白可以先不碰这两个，先把前面三个用熟。

1.2 为什么 3 个月涨了 3 万 star

第一，作者身份特殊。Jesse Vincent 是 Claude Code 的核心贡献者，Superpowers 属于「亲儿子级」插件，不是野生脚本，文档和迭代节奏跟官方比较同步。第二，真实痛点抓得准。直接让 Claude Code 写代码时，最常见的问题就是 AI 接到需求就猜，猜错就返工；代码生成后没有测试；bug 一出现就这边改一下那边改一下，最后引入新问题。Superpowers 等于把专业开发流程变成一组可执行的命令，原本靠人盯着才有效的规矩，现在由插件强制触发。第三，开源免费 MIT 协议，GitHub issue 回复快。这几个因素叠加起来，star 涨得夸张也就不奇怪了。

2. 装之前先配 Key：settings.json 把 Claude Code 指到 TaoToken

2.1 拿到你的 Key 和模型 ID

在安装插件之前，先保证 Claude Code 本身能通过 TaoToken 正常调用模型。打开 TaoToken 注册并登录，进入控制台创建一个 API Key，复制下来。Key 只在那次创建时完整显示一次，如果关掉页面后找不到了，就删掉重建一把。

然后到模型广场挑一个模型，把页面上显示的模型 ID 复制下来。这里有个容易踩的坑：网上不少教程会写一个带日期后缀的模型名，你把它填进ANTHROPIC_MODEL，插件运行时很可能直接报 model not found。正确做法是只认模型广场上现成展示的标识，没有就刷新再看，不要凭记忆造一个 ID。

2.2 修改 ~/.claude/settings.json

Claude Code 在启动时会读取~/.claude/settings.json里的env块作为默认环境变量。新建或者修改这个文件，写入以下内容：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "MODEL_ID" } }

YOUR_API_KEY替换成刚才从 TaoToken 控制台复制的 Key，MODEL_ID替换成模型广场上复制的模型 ID。如果你习惯用环境变量，也可以等价写成：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="MODEL_ID"

每次改完settings.json，要把 Claude Code 完全退出再重新进入，配置才会被重新加载。注意ANTHROPIC_BASE_URL一定写https://taotoken.net/api，不要加/v1，也不要填入官网落地页 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 那个地址——后者是给人点的页面，前者才是接口入口。ANTHROPIC_AUTH_TOKEN只放能用于认证的 Key，别把官网登录密码填进去。

3. 官方三步安装：从 superpowers-marketplace 到插件生效

3.1 第零步：先卸载旧版本

如果你以前装过任何版本的 Superpowers，先把它卸掉。在 Claude Code 里输入：

/plugin remove superpowers

如果返回「没有找到该插件」，说明之前没装过，直接跳到下一步。这一步不能省：旧插件残留会和新的 marketplace 定义冲突，导致命令列表里出现同名入口但实际不可用。

3.2 添加 marketplace 并安装

依次执行这两条命令：

/plugin marketplace add obra/superpowers-marketplace

/plugin install superpowers@superpowers-marketplace

第一句把作者的插件源注册进来，第二句从该源安装 Superpowers 本体。注意superpowers@superpowers-marketplace的语法是包名加@加源名，手动输入时别漏掉@。两条命令不要调换顺序，安装过程中如果出现确认提示，输入y回车。

3.3 用 /help 验证

安装完成后，输入/help，往下翻到插件区域，看到这三个命令就说明装好了：

/superpowers:brainstorm/superpowers:write-plan/superpowers:execute-plan

这一步只是列出命令，不会真正调用模型，所以暂时不会在 TaoToken 控制台产生调用记录。真正的调用从你执行第一个/superpowers:brainstorm才开始。

4. 实测：从「AI 直接开写」到「先问八个问题」

4.1 流程变了，返工少了

我拿一个真实需求跑过一次。这个需求如果发给之前的 Claude Code，它大概会先写一长串代码，然后我发现理解偏了又让它重写。装完 Superpowers 后，/superpowers:brainstorm先问我：这个功能要不要包含登录态、前端组件能不能复用、失败时的提示文案有没有要求。被问的时候觉得烦，但这些问题本来就应该在写代码之前确认清楚。

回答完进入/superpowers:write-plan，AI 把需求拆成 15 个小任务，每个任务预估 2-5 分钟能完成。执行时先写测试，测试红了再写实现。中间真遇到一次 bug，/superpowers:systematic-debugging让我按固定格式填现场数据、期望结果、实际结果，最后定位在一个边界条件处理上，而不是无脑重写。整体跑完，没有返工。

4.2 这种多轮流程对 Key 的真正考验

Superpowers 的 brainstorming 是多轮问答，execute-plan 阶段还会反复调用模型。跑一个小需求，消耗也可能比普通聊天高一个量级。Key 用 TaoToken 之后，这些调用全部打到https://taotoken.net/api这一个统一通道。好处有两个：一是连接出错时能很快判断是模型 ID 的问题还是 Key 的问题，控制台记录一目了然；二是整个会话的 Token 消耗归到一个控制台下面，不用在几个官方后台之间来回切换对账。Superpowers 本身的技能流程完全不变，该问的问题、该写的测试一步都不会少。

5. 报错排查：401、Base URL 多了 /v1、旧插件冲突

5.1 401 或 auth error

启动 Claude Code 后如果连不上模型，先检查~/.claude/settings.json里的ANTHROPIC_AUTH_TOKEN是不是有效 Key。最稳妥的做法是登录 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 控制台重新复制一次，粘贴时注意前后不要有多余空格。另外一个常见错误是把官网落地页地址直接填进ANTHROPIC_BASE_URL，或者习惯性在https://taotoken.net/api后面补上/v1。TaoToken 的接口就是https://taotoken.net/api，路径末尾什么后缀都不需要。

5.2 model not found 或 model not supported

如果在settings.json里填了一个模型广场上不存在的 ID，执行/superpowers:brainstorm时会直接报模型不存在。回到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的模型广场，选一个页面上有明确标识的模型 ID。尤其是带日期后缀的那一类，只有模型广场上确认存在才可以用，别拿第三方文章里的配置照抄。

5.3 插件命令不出现

输入/help看不到三个/superpowers:命令时，先确认旧版本是否卸载干净，执行/plugin remove superpowers。然后再执行 marketplace add 和 install，顺序不能反。如果安装时提示 Already installed，可以先 remove 再重来一次。

5.4 长任务中断

execute-plan 可能持续几分钟。中途网络断开时，TaoToken 控制台能看到这次会话在中断前消耗了多少 Token。重新执行时建议从/superpowers:write-plan恢复，不要重新跑 brainstorm，避免同一份需求被重复问一轮。

6. 建议和下一步：装完先跑一次 brainstorm

6.1 我的建议

如果你是第一次用 Superpowers，我的建议和那位作者一致：装。它不会让你一夜变成专家，但会把「先想清楚再动手」这件事通过强制流程变成肌肉记忆。前期会觉得问答环节多，尤其是 brainstorm 连珠炮一样的问题容易让人想跳过。忍过第一次，后面会越来越顺手。

如果你已经有一套成熟的工作流，可以只启用brainstorming和systematic-debugging两个技能，其余环节保留自己原来的习惯。这两个技能对任何水平的开发者都有效。

6.2 你的下一步

打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册账号、创建 API Key，把settings.json里的三个变量填好，装完 Superpowers 后执行一次/superpowers:brainstorm。哪怕就拿「我要写一个用户登录」当需求也行。

跑完以后回 TaoToken 控制台看一眼，这次多轮问答有没有产生调用记录、Token 花费是否符合预期。确认整条链路跑通，之后再装其他 MCP 或者技能，都会省事很多。