如何在 Claude Code 逐步安装 Superpowers

在 Claude Code 逐步安装 Superpowers 的指南：官方市场或 GitHub 两条安装路径、如何确认插件已启用，以及安装时真正会遇到的常见错误。

接下来 5 分钟你会完成什么

读完这篇指南，你的 Claude Code 或 Claude Cowork 客户端里会装好并启用 Superpowers（obra/superpowers），你可以不靠猜测就确认安装成功，并执行第一条命令（/brainstorm）来检查插件是否响应。

前置条件

开始之前，先确认这些：

已安装 Claude Code 或 Claude Cowork，并且已登录会话。
能使用终端（GitHub 安装方式），或能使用支持插件命令（/plugin）的聊天界面（市场安装方式）。
如果走 GitHub，机器上需要已安装 git。
不需要额外付费账号：Superpowers 是开源项目，两条路径都免费安装。

选项 A：从官方市场安装（推荐）

这是最快、也最容易保持更新的路径，因为你不用自己做 git pull。

第 1 步。 打开 Claude Code 或 Claude Cowork 的聊天界面。

第 2 步。 执行直接安装命令：

/plugin install superpowers

到这里，基础插件已经装好了。

第 3 步（可选）。 如果你还想要 Superpowers 生态里的配套插件，先添加第三方市场，再从那里安装：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

这第二步不是让 Superpowers 跑起来所必需的；只有在你想要基础包以外的额外 skills 时才需要。

选项 B：从 GitHub 安装

如果你更希望代码在自己机器上、跟踪开发分支，或先审一下仓库再信任它，用这条路径。

第 1 步。 打开终端。

第 2 步。 把仓库直接克隆到 Claude 的插件目录：

git clone https://github.com/obra/superpowers.git ~/.claude/plugins/superpowers

第 3 步。 重启 Claude Cowork 或 Claude Code 的会话，让它检测到新插件。这一步重启最容易被跳过，很多人随后会以为安装失败了。

如何确认已经装好

不要因为命令没报错就认定成功。用下面两种方法任选一种核实：

列出已启用的插件。 按你的客户端，列出已安装插件的命令应显示 superpowers。如果没有出现，说明安装还没生效。
试一条 skill 命令。 执行 /brainstorm 再跟上一个简短想法，例如 /brainstorm agregar autenticación a mi API。如果 Superpowers 已启用，智能体会用探索性问题回应，而不是直接跳去写代码。

如果 /brainstorm 能正常回应，安装就成功了。

故障排查：安装时的常见错误

执行 `/plugin install superpowers` 时提示“找不到命令”

通常表示你的 Claude Code 或 Claude Cowork 版本没有启用插件支持，或已经过时。把客户端更新到最新版再试一次。

从 GitHub 安装后插件没有出现

几乎总是缺了那一步：重启会话。只克隆仓库不够；客户端在启动时加载插件，不会热加载。把会话彻底关掉再重新打开。

克隆到 `~/.claude/plugins/` 时权限错误

确认 ~/.claude/plugins/ 目录存在，并且当前用户对它有写权限。如果不存在，克隆前先手动创建（mkdir -p ~/.claude/plugins）。

安装配套插件时提示“找不到市场”

这个错误会出现在你跳过添加市场、直接执行 /plugin install superpowers@superpowers-marketplace 的时候。顺序很重要：先 /plugin marketplace add obra/superpowers-marketplace，然后再 install。

第一次快速使用

Superpowers 装好后，用这个最小流程确认一切已经接通：

/brainstorm mejorar el onboarding de mi app

智能体应先问清楚范围再提出方案，而不是立刻写代码。这种行为变化——先提问、先规划，再执行——就是 Superpowers 正在运行、而不只是装上了的信号。

常见问题

安装 Superpowers 需要付费吗？

不需要。它是开源项目（obra/superpowers），官方市场和 GitHub 两条安装路径都免费。

该选市场还是 GitHub？

选官方市场，除非你有明确理由要用 GitHub，比如想先看代码再安装，或跟踪某个开发分支。市场会自己更新；GitHub 克隆不会。

为什么插件装好了却什么都没发生？

最可能是还没重启客户端会话。如果已经重启了仍然不出现，用插件列表确认安装是否完成。

这篇指南对 Claude Cowork 和 Claude Code 都适用吗？

适用。安装命令相同，因为两者都使用 Anthropic 同一套插件系统。如果你想理解 Superpowers 背后的完整框架——不只是怎么装，还有为什么这样设计——请看Superpowers 完整评测。