1. 为什么单装 Claude Code 还不够工作台的真实痛点Claude Code 本身已经是一个很强的终端编程助手能读项目、改文件、跑命令。但很多人装完之后会发现一个问题它更像一个随叫随到的临时工而不是一个有工程纪律的搭档。你让它加个登录它可能直接开写写到一半发现你要的是扫码登录你让它修个 Bug它顺手把旁边两个函数也重构了测试全挂。这就是 Superpowers 想解决的问题。它是一套挂在 Claude Code 上的技能插件核心思路是流程大于提示——在写代码之前强制走设计确认、计划拆解、测试驱动、Git 隔离这几步。配合起来你的终端里就有了一个会先想清楚再动手的 AI 工作台。这篇文章要做的是把这套工作台从零搭起来Node.js 和 Git 环境打底Claude Code 装好Superpowers 插件挂上然后用 TaoToken 统一 Key 把模型通道接进去。全程给可复制的配置骨架最后用一条真实请求验证工作台能不能跑通。适合已经会用终端、想认真做项目的开发者也适合刚接触 AI 编程、想一步到位搭对环境的新手。2. 前置准备Node.js、Git 与 TaoToken 统一 Key2.1 Node.js 与 Git 环境Claude Code 跑在 Node.js 上Superpowers 的 Git Worktree 隔离依赖 Git。两个都装好后面才不会卡。Node.js 去官网下 LTS 版本一路 Next。装完在 PowerShell 里验证node --version npm --version看到v22.x.x这类版本号就说明就绪。Git 同理装完验证git --version如果git --version报不是内部或外部命令多半是安装时没勾选Add to PATH重装一遍勾上即可。2.2 为什么用 TaoToken 统一 KeyClaude Code 默认走 Anthropic 官方通道但很多人的实际场景是手上有多个模型来源想在一个入口统一管理 Key 和额度不想每个工具单独配一遍。TaoToken 做的就是这件事——它提供一个统一的 API 通道Claude Code、Coding Plan、模型对话都从同一个 Key 走。对工作台来说好处很直接你只需要维护一个 Key换模型、查用量、做额度控制都在一个地方。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。先去控制台把 Key 建出来路径是 API Keys 页面。建好之后复制那串sk-开头的字符串后面配置要用。注意Key 只显示一次建完立刻存到安全的地方别直接写进会提交到 Git 的文件里。3. 可复制配置settings.json 与 config.toml 骨架3.1 安装 Claude Code用 npm 全局装npm install -g anthropic-ai/claude-code装完验证claude --version有版本号输出就成功了。如果提示权限问题Windows 下用管理员 PowerShell 重跑一次。3.2 settings.json 配置骨架Claude Code 的配置分两层全局配置放在用户目录项目配置放在项目根目录的.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, Write, Bash(git status), Bash(git diff), Bash(npm test) ], deny: [ Bash(rm -rf *), Bash(git push --force) ] } }这里几个点值得说清楚。ANTHROPIC_BASE_URL指向 TaoToken 的 API 端点Claude Code 会把请求发到这里ANTHROPIC_API_KEY填你刚建的 KeyANTHROPIC_MODEL指定默认模型按你订阅的套餐填对应模型名。permissions里把危险命令挡掉尤其是rm -rf和强制推送AI 再聪明也不该有这两样权限。注意.claude/settings.json如果包含真实 Key务必加进.gitignore。更稳妥的做法是把 Key 放环境变量配置文件里只留占位。3.3 config.toml 配置骨架如果你用的是支持 TOML 配置的客户端或 Coding Plan 场景配置长这样[api] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 timeout 120 [model] default claude-sonnet-4-20250514 max_tokens 8192 [workspace] auto_approve_read true auto_approve_write false git_worktree truegit_worktree true这一项是给 Superpowers 用的开启后它会在隔离工作树里干活主分支不受影响。auto_approve_write false表示写文件前要你确认前期建议保持 false等信任度上来了再放开。3.4 安装 Superpowers 插件前置是 Git 已装好。在 Claude Code 终端里依次执行/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace装完输入/help能看到一批/superpowers:开头的命令就说明挂载成功。核心技能包括brainstorming设计细化、systematic-debugging根因分析、writing-plans计划拆解、test-driven-development红绿重构、using-git-worktrees隔离开发。4. 验证请求确认工作台真的能跑配置写完不算数得发一条真实请求验证整条链路通不通。4.1 启动并信任目录进入项目目录启动cd my-project claude首次启动会问是否信任当前文件夹输入Y。这一步是 Claude Code 的安全机制信任后才允许读写项目文件。4.2 发一条验证请求在对话里输入请读取当前项目结构列出所有源文件并说明这个项目是做什么的。如果配置正确Claude Code 会通过 TaoToken 通道拿到模型响应输出文件列表和项目说明。这一步验证了三件事Key 有效、Base URL 可达、模型名正确。4.3 验证 Superpowers 是否生效再发一条/superpowers:brainstorming 我想给这个项目加一个用户配置模块正常的话AI 不会直接写代码而是开始反问你配置存哪里、要不要支持多环境、敏感字段怎么处理。它停下来问就说明 Superpowers 的流程约束起作用了。如果它直接开写检查插件是否装成功、/help里有没有对应命令。4.4 验证 Git Worktree 隔离/superpowers:using-git-worktrees执行后跑git worktree list应该能看到一个新的工作树路径。AI 后续的改动都发生在这个隔离目录里主分支干净。满意就合并不满意直接删掉工作树主代码毫发无损。5. 本篇常见错排查报错一ANTHROPIC_API_KEY无效或 401先确认 Key 复制完整没有多余空格。再确认ANTHROPIC_BASE_URL是https://taotoken.net/api结尾不要多加斜杠。如果还报错去控制台看 Key 是否被禁用或额度耗尽。报错二claude: command not foundnpm 全局 bin 目录没进 PATH。跑npm config get prefix看路径把它加到系统环境变量。Windows 下通常是%APPDATA%\npm。报错三Superpowers 插件装了但命令不出现多半是 marketplace 没加成功。重新执行/plugin marketplace add obra/superpowers-marketplace确认没有网络报错再/plugin install。装完重启一次 Claude Code。报错四Git Worktree 创建失败检查当前目录是不是 Git 仓库git status能跑通。不是的话先git init并做一次初始提交Worktree 需要至少一个 commit 才能建。报错五模型名不匹配导致 404ANTHROPIC_MODEL填的模型名必须是你套餐里实际有的。不确定就去控制台看可用模型列表别照抄文章里的示例名。报错六写文件时反复要确认很烦这是auto_approve_write false的正常行为。想省事可以在permissions.allow里加具体路径的 Write 权限而不是全局放开。6. 把工作台用起来从配置到日常环境搭好之后日常流程大概是这样新功能先/superpowers:brainstorming把需求聊清楚再/superpowers:writing-plans拆成 2 到 5 分钟一个的小任务然后/superpowers:using-git-worktrees开隔离区接着test-driven-development先写失败测试再实现每个任务完成触发代码审查最后finishing-a-development-branch验证全局测试再合并。这套流程前期会显得慢但项目一旦超过几百行它省下的返工时间远超投入。我自己的习惯是小脚本直接用 Claude Code 裸跑正经项目一律走 Superpowers 流程两者不冲突。Key 和通道这块统一走 TaoToken 之后换模型、查用量、控额度都在一个入口不用每个工具单独配。需要建 Key 或看接入文档的从 API Keys 页面进https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 想先试试模型对话效果的走模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 长期做编码和 Agent 任务的直接看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。配置骨架已经给全剩下的就是打开终端把第一条/superpowers:brainstorming敲进去。
