Claude CodeにSuperpowersをインストールする方法

目次

• これから5分でできること
• 事前準備
• オプションA：公式マーケットプレイスからインストール（推奨）
• オプションB：GitHubからインストール
• インストールできたか確認する方法
• トラブルシューティング：インストール時によくあるエラー

  • /plugin install superpowersを実行すると「コマンドが見つかりません」
  • GitHubから入れたのにプラグインが出てこない
  • ~/.claude/plugins/へのクローンで権限エラー
  • 補完プラグインのインストールで「マーケットプレイスが見つかりません」
• 最初の短い使い方
• よくある質問

  • Superpowersのインストールにお金はかかりますか？
  • マーケットプレイスとGitHub、どちらを使うべきですか？
  • プラグインを入れたのに何も起きないのはなぜですか？
  • このガイドはClaude CoworkとClaude Codeの両方で使えますか？

これから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

この2つ目の手順は、Superpowersを動かすだけなら不要です。ベースパッケージに入っていない追加スキルが欲しいときだけ必要です。

オプションB：GitHubからインストール

コードを手元に置きたい、開発ブランチを追いかけたい、信用する前にリポジトリを確認したい場合に使います。

手順1. ターミナルを開きます。

手順2. Claudeのプラグイン用フォルダへ、リポジトリを直接クローンします。

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

手順3. 新しいプラグインを検出させるため、Claude CoworkまたはClaude Codeのセッションを再起動します。この再起動を飛ばす人がいちばん多く、あとから「インストールに失敗した」と思い込みます。

インストールできたか確認する方法

コマンドがエラーを出さなかったからといって、成功したと思い込まないでください。次のどちらかで確認します。

1. 有効なプラグインを一覧する。 クライアントによって違いますが、インストール済みプラグインを出すコマンドにsuperpowersが表示されるはずです。出てこなければ、インストールはまだ反映されていません。
2. スキルのコマンドを試す。 /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のインストールにお金はかかりますか？

かかりません。オープンソースのプロジェクト（obra/superpowers）で、公式マーケットプレイスとGitHubのどちらの経路も無料です。

マーケットプレイスとGitHub、どちらを使うべきですか？

公式マーケットプレイスです。コードを入れてから確認したい、特定の開発ブランチを追いたい、といった具体的な理由がある場合だけGitHubを使ってください。マーケットプレイスは自動で更新されます。GitHubのクローンは更新されません。

プラグインを入れたのに何も起きないのはなぜですか？

いちばん多いのは、クライアントのセッションを再起動していないことです。すでに再起動しても出てこない場合は、プラグイン一覧でインストールが完了しているか確認してください。

このガイドはClaude CoworkとClaude Codeの両方で使えますか？

使えます。どちらもAnthropicの同じプラグインシステムを使うので、インストールコマンドは同じです。Superpowersのフレームワーク全体——入れ方だけでなく、なぜそう動くのか——を知りたい場合は、Superpowersの完全レビューを読んでください。