如何在 Claude Code 逐步安裝 Superpowers

在 Claude Code 逐步安裝 Superpowers 的指南：官方市場或 GitHub 兩條安裝路徑、如何確認外掛已啟用，以及安裝時真正會遇到的常見錯誤。

接下來 5 分鐘你會完成什麼

讀完本指南，你的 Claude Code 或 Claude Cowork 用戶端會裝好並啟用 Superpowers（obra/superpowers），你可以不靠猜測就確認安裝成功，並執行第一條指令（/brainstorm）來檢查外掛是否回應。

前置條件

開始之前，先確認這些：

已安裝 Claude Code 或 Claude Cowork，並且已登入工作階段。
能使用終端機（GitHub 安裝方式），或能使用支援外掛指令（/plugin）的聊天介面（Marketplace 安裝方式）。
如果走 GitHub，機器上需要已安裝 git。
不需要額外付費帳號：Superpowers 是開源專案，兩條路徑都免費安裝。

選項 A：從官方 Marketplace 安裝（建議）

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

第 1 步。 開啟 Claude Code 或 Claude Cowork 的聊天介面。

第 2 步。 執行直接安裝指令：

/plugin install superpowers

到這裡，基礎外掛已經裝好了。

第 3 步（選用）。 如果你還想要 Superpowers 生態系裡的配套外掛，先加入第三方 Marketplace，再從那裡安裝：

/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）。

安裝配套外掛時提示「找不到 Marketplace」

這個錯誤會出現在你跳過加入 Marketplace、直接執行 /plugin install superpowers@superpowers-marketplace 的時候。順序很重要：先 /plugin marketplace add obra/superpowers-marketplace，然後再 install。

第一次快速使用

Superpowers 裝好後，用這個最小流程確認一切已經接通：

/brainstorm mejorar el onboarding de mi app

代理應先問清楚範圍再提出方案，而不是立刻寫程式碼。這種行為變化——先提問、先規劃，再執行——就是 Superpowers 正在執行、而不只是裝上了的訊號。

常見問題

安裝 Superpowers 需要付費嗎？

不需要。它是開源專案（obra/superpowers），官方 Marketplace 和 GitHub 兩條安裝路徑都免費。

該選 Marketplace 還是 GitHub？

選官方 Marketplace，除非你有明確理由要用 GitHub，例如想先看程式碼再安裝，或追蹤某個開發分支。Marketplace 會自己更新；GitHub 複製不會。

為什麼外掛裝好了卻什麼都沒發生？

最可能是還沒重新啟動用戶端工作階段。如果已經重新啟動了仍然不出現，用外掛清單確認安裝是否完成。

本指南對 Claude Cowork 和 Claude Code 都適用嗎？

適用。安裝指令相同，因為兩者都使用 Anthropic 同一套外掛系統。如果你想理解 Superpowers 背後的完整框架——不只是怎麼裝，還有為什麼這樣設計——請看Superpowers 完整評測。