1. Windows 下 opencode 与 superpowers 的真实痛点
如果你在 Windows 上同时用几个 AI 编程工具，大概率遇到过这种局面：Cursor 里配了一个 Key，Claude Code 里又填了一个，opencode 再单独来一份，哪天想换个模型或者额度用完了，得挨个翻配置文件改。更麻烦的是，每个工具的配置格式还不一样，有的用 JSON，有的用 TOML，改错一个字符就启动报错。
opencode 是一个跑在终端里的编程智能体，支持通过配置文件接入不同的大模型服务。superpowers 则是一套给编程智能体用的软件开发工作流，把头脑风暴、写计划、测试驱动开发、代码评审这些环节串成可调用的 skills。两者结合之后，你在 Windows 终端里就能完成从想法到代码评审的完整流程。
这篇内容面向的是 Windows 用户，尤其是那些手里有多个 AI 工具、Key 管理混乱、想用一套统一配置解决问题的人。我会从零开始讲 opencode 的安装、superpowers skills 的启用、通过 npx 初始化项目，以及怎么用 TaoToken 的统一 Key 把配置收敛到一处。全程命令可复制，配置文件骨架直接给，最后用 npx 验证 skills 加载和 API 连通性。
我试过在 Windows 11 的 PowerShell 和 CMD 里分别跑一遍，下面提到的路径和命令都在这两个环境验证过。如果你用的是 Windows 10，流程基本一致，只是个别路径写法注意一下。
2. TaoToken 前置：统一 Key 解决多工具分散问题
在讲配置之前，先说清楚为什么要用 TaoToken。核心原因就一个：把分散在各个工具里的 Key 收敛成一套。
TaoToken 提供的是 API 接入服务，官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。它的 API 端点统一为 https://taotoken.net/api ，不区分具体模型，你在请求里指定模型名就行。这意味着 opencode、Claude Code、其他支持自定义 base URL 的工具，都可以指向同一个地址、用同一个 Key。
你需要先拿到 Key。登录之后进入控制台，在 API Keys 页面创建一个新的 Key，复制出来备用。这个 Key 就是后面所有配置里填的那一串。
注意：Key 只显示一次，创建后立刻复制保存。如果丢了就重新生成一个，旧的自然失效。
TaoToken 的接入文档在 https://taotoken.net/doc ，里面列出了支持的模型列表和请求格式。opencode 走的是 OpenAI 兼容格式，所以配置里 base URL 填 https://taotoken.net/api ，模型名按文档里写的填。
对于长期做编码、跑 Agent 任务的场景，可以看一下 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。它针对的是持续性的编码任务，比按次调用更适合日常开发。
如果你只是想先验证模型能不能通，可以用模型对话页面直接测，地址是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。在网页里选模型、发一句话，看有没有正常返回，这一步能排除 Key 本身的问题。
3. 可复制配置：opencode 安装与 settings.json 骨架
3.1 安装 opencode
Windows 下安装 opencode 最省事的方式是用 npm。前提是你已经装了 Node.js，版本建议 18 以上。打开 PowerShell 或 CMD，执行：
npm install -g opencode-ai装完之后验证一下：
opencode --version正常会输出版本号，比如0.5.x之类。如果提示命令找不到，检查 npm 的全局 bin 目录有没有加到 PATH 里。Windows 下通常是%APPDATA%\npm，你可以用npm config get prefix看具体路径。
3.2 配置文件位置
opencode 在 Windows 下的配置目录是%USERPROFILE%\.opencode，也就是C:\Users\你的用户名\.opencode。里面主要涉及两个文件：
settings.json：主配置，放模型接入信息config.toml：部分版本用 TOML 格式，放工具和 skills 相关设置
如果目录不存在，手动建一个。下面给的是 settings.json 的骨架，把你的TaoTokenKey替换成第 2 步拿到的 Key：
{ "provider": { "taotoken": { "type": "openai", "baseURL": "https://taotoken.net/api", "apiKey": "你的TaoTokenKey", "models": { "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" }, "gpt-4o": { "name": "GPT-4o" } } } }, "defaultModel": "taotoken/claude-sonnet-4-20250514" }这里type填openai表示走 OpenAI 兼容协议，baseURL就是 TaoToken 的 API 地址，apiKey填你的 Key。models里列你想用的模型，模型名按 TaoToken 文档里的写。defaultModel是启动时默认用的模型，格式是provider名/模型名。
3.3 config.toml 骨架
config.toml 主要管 skills 和工具行为。一个可用的骨架：
[skills] enabled = true paths = ["~/.opencode/skills"] [agent] max_steps = 30 auto_approve = false [tools] shell = true file_edit = trueskills.enabled打开 skills 功能，paths指向 skills 存放目录。superpowers 装完之后会往这个目录里写文件。max_steps控制单次任务最多走多少步，auto_approve设成 false 表示每个操作都要你确认，调试阶段建议保持 false。
提示：两个文件的路径和字段名可能随 opencode 版本微调，如果启动报字段不识别，先看
opencode --help或官方仓库的配置说明，以实际版本为准。
4. 安装 superpowers 并验证 skills 加载
4.1 用 npx 安装 superpowers
superpowers 通过 npx 安装，命令在 CMD 或 PowerShell 里都能跑：
npx skills add obra/superpowers -y-y表示跳过确认，直接装。执行过程中会从仓库拉取 skills 文件，写到 opencode 的 skills 目录。装完之后你应该能在%USERPROFILE%\.opencode\skills下看到一批目录，比如brainstorming、writing-plans、test-driven-development这些。
4.2 验证 skills 是否加载
启动 opencode：
opencode进去之后直接问它：
你现在有哪些skills?如果 superpowers 装好了，它会列出 brainstorming、using-git-worktrees、writing-plans、subagent-driven-development、test-driven-development、requesting-code-review、finishing-a-development-branch 这些。列出来了就说明加载成功。
4.3 用 npx 初始化项目
在你要开发的项目目录下，用 npx 跑一次初始化，让 superpowers 的工作流文件落到项目里：
npx skills init这个命令会在当前目录生成 skills 相关的配置和目录结构。跑完之后项目根目录下会多出.opencode或类似的文件夹，里面是项目级的 skills 配置。这一步的作用是把全局的 superpowers 工作流和具体项目绑定，后续在项目里调用 skills 时能读到项目上下文。
4.4 验证 API 连通性
配置和 skills 都就位之后，验证一下模型能不能通。在 opencode 里发一句：
用一句话说明当前项目是做什么的如果模型正常返回，说明 TaoToken 的 Key、base URL、模型名都对。如果报 401，是 Key 的问题；报 404，是模型名或 base URL 的问题；报超时，检查网络。
你也可以在 opencode 里显式调用一个 skill 来验证整条链路：
/skill_name brainstorming把skill_name换成实际存在的 skill 名。如果 skill 被触发并且模型有响应，说明 skills 加载和 API 接入都正常。
5. 本篇常见错排查
5.1 opencode 命令找不到
装完 npm 包之后opencode提示不是内部或外部命令。原因是 npm 全局 bin 目录没在 PATH 里。执行npm config get prefix拿到路径，通常是C:\Users\你的用户名\AppData\Roaming\npm，把这个路径加到系统环境变量 PATH 里，重开终端。
5.2 settings.json 报 JSON 解析错误
最常见的是尾逗号。JSON 不允许最后一个字段后面有逗号。另外 Windows 路径里的反斜杠在 JSON 里要转义成\\，或者直接用正斜杠/。如果你从网页复制配置，注意引号是不是中文引号，必须是英文双引号。
5.3 401 Unauthorized
Key 不对或者没带上。检查 settings.json 里apiKey字段的值，前后不要有空格。如果 Key 是从控制台复制的，确认没有漏字符。实在不确定就重新生成一个 Key 换上去。
5.4 404 Not Found
模型名写错了，或者 base URL 多了/少了路径。TaoToken 的 base URL 是https://taotoken.net/api，不要在后面加/v1之类的后缀，除非文档明确要求。模型名严格按文档里的字符串填，大小写敏感。
5.5 skills 列表为空
npx skills add obra/superpowers -y跑完了但 opencode 里问 skills 什么都没有。先确认%USERPROFILE%\.opencode\skills目录下有没有文件。如果没有，说明安装没写进去，可能是权限问题，用管理员权限的终端重跑一次。如果有文件但 opencode 读不到，检查 config.toml 里skills.paths指向的路径对不对，Windows 下~不一定被正确解析，可以换成绝对路径C:/Users/你的用户名/.opencode/skills。
5.6 npx skills init 报错
如果提示找不到命令，确认 Node.js 和 npm 版本够新。npx是 npm 自带的，Node 18 以上都有。如果报网络错误，检查 npm 的 registry 配置，必要时换成国内镜像源再试。
6. 把 Key 收敛到一处，后续维护省一半事
配置跑通之后，你手里应该是一套 settings.json 加一个 TaoToken Key，opencode 和 superpowers 都指向同一个 API 端点。以后要换模型，只改 settings.json 里的defaultModel；要换 Key，只改apiKey一处。其他工具如果也支持自定义 base URL，同样填https://taotoken.net/api和同一个 Key，不用再分别管理。
如果你后面要长期跑编码任务或者 Agent 流程，可以去看一下 Coding Plan 的说明：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。日常调试和验证模型，用模型对话页面就够了：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。Key 的管理和新建在控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite ，API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。接入格式和模型列表以文档为准：https://taotoken.net/doc 。
一个实际的小技巧：把 settings.json 里的defaultModel先设成你用得最顺的那个，调试阶段把auto_approve保持 false，等流程稳定了再考虑放开。superpowers 的 skills 是按关键词自动触发的，你在对话里提到「先头脑风暴一下」「写个计划」「跑测试」这类词，对应的 skill 就会激活，不用每次手动敲/skill_name。
