你决定试试Superpowers。接下来需要安装和配置。这一步本身体现了方法论：不同的平台有不同的最佳适配方式，理解差异能帮助你选择合适的工具。
Superpowers的多平台支持
Superpowers支持5个主要的AI编程平台：
- Claude Code——Anthropic官方的AI编程CLI，官方市场和Superpowers市场都支持
- Cursor IDE——基于VS Code的AI IDE，插件市场安装
- OpenAI Codex CLI/App——OpenAI的AI编程工具，CLI和App版本
- Gemini CLI——Google的AI编程CLI，extensions机制
- OpenCode——另一个AI编程CLI，fetch指令安装
这些平台的核心体验一致——技能内容相同，方法论流程相同。差异在安装方式、配置位置、技能加载机制。
Claude Code安装（官方推荐）
Claude Code是体验Superpowers最佳的平台。有两个安装方式：
方式一：官方市场
Claude Code有官方的插件市场，Superpowers已经被收录：
/plugin install superpowers@claude-plugins-official
这是最简单的方式，Anthropic官方维护插件市场，安装后自动更新。
方式二：Superpowers市场
如果你想使用Superpowers自己的市场（可能有其他相关插件）：
# 先注册市场
/plugin marketplace add obra/superpowers-marketplace
# 然后安装
/plugin install superpowers@superpowers-marketplace
两种方式的插件内容相同，选择哪个取决于你偏好哪个市场。
配置文件位置
安装后，配置在~/.claude/settings.json。你应该能看到：
{
"enabledPlugins": {
"superpowers@claude-plugins-official": true
}
}
如果你想用本地开发版本（用于修改技能），可以在项目目录创建.claude/settings.json：
{
"enabledPlugins": {
"superpowers@superpowers-dev": true
}
}
验证安装成功
启动Claude Code，输入一个需要创建功能的请求：
我想添加一个功能
如果Superpowers正确安装，你应该看到：
I notice this is about creating a feature. I need to use the brainstorming skill first.
AI不会直接开始写代码，而是进入brainstorming流程——这是技能生效的标志。
Cursor IDE安装
Cursor是基于VS Code的AI IDE，有自己的插件系统。
安装方式
在Cursor的Agent chat中：
/add-plugin superpowers
或者在插件市场搜索"superpowers"，点击安装。
配置差异
Cursor的hook格式略有不同。Superpowers的session-start hook会检测Cursor环境，输出正确的JSON格式。
Cursor也使用~/.claude/settings.json作为配置（兼容Claude Code的配置格式）。
体验差异
Cursor的Agent chat体验与Claude Code类似，技能加载和执行方式相同。
差异在于：
- Cursor没有CLI的headless模式，不能运行集成测试
- Cursor的subagent机制略有不同，但核心体验一致
如果你主要用Cursor的IDE界面，Superpowers可以正常工作。如果你想运行技能的集成测试，需要用Claude Code CLI。
OpenAI Codex安装
Codex有CLI和App两个版本，安装方式略有不同。
CLI版本
在CLI中：
/plugins
进入插件搜索界面，输入：
superpowers
选择"Install Plugin"。
App版本
在Codex App中：
- 点击侧栏的"Plugins"
- 在"Coding"分类找到"Superpowers"
- 点击"+"安装
配置文件
Codex使用.codex-plugin/plugin.json作为manifest。安装后，配置在Codex的设置目录。
Codex的skill tool名称与Claude Code相同，技能加载机制类似。
Gemini CLI安装
Gemini CLI使用extensions机制。
安装
gemini extensions install https://github.com/obra/superpowers
更新
gemini extensions update superpowers
配置差异
Gemini使用GEMINI.md文件引用技能内容。Superpowers的GEMINI.md内容是：
@./skills/using-superpowers/SKILL.md
@./skills/using-superpowers/references/gemini-tools.md
这意味着Gemini会加载这些文件作为技能内容。
Gemini的工具名称不同，使用activate_skill而非Skill工具。Superpowers的references/gemini-tools.md提供工具映射表。
OpenCode安装
OpenCode使用fetch指令安装。
安装
告诉OpenCode：
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
OpenCode会下载安装指令并执行。
详细文档
docs/README.opencode.md提供完整的OpenCode使用文档。
安装后的第一步验证
无论哪个平台，安装后都应该验证技能生效。
测试方法
输入一个触发技能的请求。最简单的是问关于技能的问题：
What does the brainstorming skill do?
如果技能加载正确，AI会描述brainstorming技能的内容：
- 它在创建功能前激活
- 它通过问答探索需求
- 它形成spec文档后才能继续
如果AI不知道这个技能，说明安装有问题。
运行测试项目
如果想更全面验证，可以创建一个简单项目：
我想创建一个计算器库，有加减乘除功能
完整流程应该是：
- AI进入brainstorming，问你问题
- 形成spec文档
- 形成实现计划
- 创建worktree
- 执行任务（你观察AI自主工作）
- 完成验证
这个过程可能需要30-60分钟，但能完整验证Superpowers流程。
常见问题解决
问题一：技能未加载
症状：AI直接开始写代码，没有进入brainstorming流程。
可能原因：
- 配置文件没有正确设置enabledPlugins
- 本地开发版本的settings.json位置不对
解决：
- 检查
~/.claude/settings.json是否有superpowers的enabledPlugins条目 - 如果用本地开发版本，确保在项目根目录运行Claude Code
问题二：配置路径问题
症状：安装命令执行了，但配置文件没有更新。
可能原因：
- 配置文件不存在或格式错误
- 安装命令没有正确写入配置
解决：
- 手动检查配置文件
- 添加enabledPlugins条目
问题三：权限问题
症状：hook脚本执行失败。
可能原因：
- hook脚本没有执行权限
解决：
chmod +x ~/.claude/plugins/superpowers/hooks/session-start
问题四：版本不一致
症状：技能内容与文档描述不同。
可能原因：
- 安装的是旧版本
解决：
- 重新安装最新版本
- 或更新：
/plugin update superpowers
平台选择建议
如果你在选择平台：
最佳体验：Claude Code
- 官方市场支持
- 完整的hook机制
- Agent tool的subagent类型丰富
- 可以运行集成测试
良好体验：Cursor、Codex
- 核心技能内容相同
- hook和subagent支持略有差异
- 适合主要用IDE界面的开发者
基本支持：Gemini、OpenCode
- 技能加载机制不同
- 需要手动配置工具映射
- 适合有特定平台偏好的开发者
核心方法论在所有平台一致。差异是工具层面的，不影响体验本质。
下一步
安装完成后，你准备开始第一个项目。
下一篇《第一个项目：从想法到代码的完整流程》将通过一个完整的Todo应用案例，展示Superpowers的每个阶段：
- Brainstorming：你和AI的问答对话
- Writing Plans：任务分解过程
- Subagent-driven Development：AI自主工作观察
- Finishing：验证和提交
