【2026年最新版】SuperClaudeカスタムコマンド完全ガイド ― 全30コマンドの使い方と、そもそも今も必要なのか問題

スポンサーリンク

Claude Codeを拡張するサードパーティ製フレームワーク「SuperClaude」。
2025年8月公開のQiita記事執筆時点では21個だったカスタムコマンドは、その後のv4.1系アップデート(例:/sc:spec-panelはv4.1.0で追加)を経て、2026年3月リリースの最新版 v4.3.0 時点で 30個 になっています。

一方で、Claude Code本体もこの1年でSkills・Hooks・Plan Modeなど公式機能を大幅に強化しており、「SuperClaudeを今から入れる意味はあるのか?」という疑問も出てきます。
実はこの疑問、SuperClaude開発チーム自身が公式ドキュメントの中で正面から検証しています。

本記事では、

  • 全30コマンドのリファレンス(カテゴリ別・最新版)
  • インストール/アップデート/アンインストール手順と注意点
  • 「Claude Codeが進化した今、SuperClaudeは必要か」の判断材料

を、SuperClaude-Org/SuperClaude_Framework の公式ドキュメント・リリースノートに基づいてまとめます。

コマンドだけざっと確認したい方は 「5. 全30コマンド一覧(カテゴリ別)」 へどうぞ。

この記事の要約(忙しい人向け)

  • SuperClaudeは非公式のサードパーティ製フレームワーク(Anthropic非提携)。
    Claude Codeのカスタムコマンド機能の上に、30個の /sc:* コマンドと20体の専門エージェント、7つのモード、8つのMCPサーバー連携を積み上げたもの
  • インストールは pipx install SuperClaude && SuperClaude install が最短
  • アンインストールは SuperClaude uninstall だが、バージョンによっては動作しない既知の不具合が報告されている。
    最終手段は pip uninstall SuperClaude~/.claude/ 配下の手動削除
  • 「そもそも必要か」の答え:コマンド集・専門エージェントとしては依然として便利。
    ただしSkills移行やHooks活用は開発チーム自身が「未成熟」と認めている領域なので、公式Skillsで代替できる部分は公式機能を使う方が筋が良い

1. SuperClaudeとは何か

SuperClaudeは、Claude Codeの「カスタムスラッシュコマンド」の仕組み(~/.claude/commands/ にコマンド定義ファイルを配置する機能)を使って、体系立った開発ワークフローを追加するオープンソースの構成フレームワークです。

v4.3.0時点の構成:

要素個数内容
コマンド30/sc:brainstorm など、/sc: 名前空間のスラッシュコマンド
エージェント20セキュリティ・フロントエンド等、専門分野別のサブエージェント定義
モード7ブレインストーミング、トークン節約など動作モード
MCPサーバー8Tavily、Context7など外部ツール連携

Anthropicの公式プロダクトではありません。
READMEにも “This project is not affiliated with or endorsed by Anthropic.” と明記されています。

2. 【重要】Claude Codeが進化した今、SuperClaudeは本当に必要か

これが2026年時点で一番気になるポイントだと思います。
結論から言うと、SuperClaude開発チーム自身が、公式ドキュメント内の claude-code-integration.md でこの重複・ギャップを検証しています。

v4.3.0のリリースノートにも次のように明記されています。

Claude Code gap analysis: Full feature mapping identifying skills migration, hooks integration, and plan mode as high-priority alignment opportunities

つまり開発チーム自身が「Skillsへの移行」「Hooks連携」「Plan Mode対応」を”優先度の高い未対応課題”としてリストアップしている状態です。具体的な重複・ギャップは次の通りです。

機能領域Claude Code公式SuperClaudeの現状評価
カスタムコマンド~/.claude/commands/ 読み込み機能30個の /sc:* コマンドとして活用公式機能を素直に拡張。実用性は高い
サブエージェント標準6エージェント+20個の専門エージェントを追加補完的で実用性は高い
Skills独立したスキルシステム1個(confidence-check)のみ「Large gap — should convert commands to skills」と自己申告。30コマンドの多くは本来Skills化すべき領域
Hooks28種類のフックイベント基本的な定義のみ、ほとんど未活用大きな伸びしろが残っている
Plan Mode標準搭載独自の計画系コマンド(/sc:workflow等)で代替公式Plan Modeとの統合はこれから
セッション管理独自の /sc:save/sc:load(カスタムメモリ依存)部分的に公式機能と重複

判断の目安

  • コマンド集・専門エージェントとして使いたいだけ → 素直に便利。
    /sc:analyze --focus security のように、目的別に振る舞いが整理されたコマンドが最初から揃っているのは依然として価値がある
  • Claude Codeの標準Skills/Hooks/Plan Modeで同じことができないか確認してから入れる → 特にSkillsは公式側がどんどん強化されているため、SuperClaudeの一部コマンド(ドキュメント生成・要件整理など)は、公式Skillsやプロジェクト固有のSkillファイルで代替できるケースが増えています
  • 「体系だったコマンド名で迷わず動かしたい」「複数人のプロジェクトでコマンドの型を揃えたい」人には今も向いている。
    逆に「Claude Codeを素の状態で使いこなせている」人が追加で導入するメリットは、以前より小さくなっています

3. インストール方法

前提条件

項目要件
Python3.8以上
pip最新版
Claude Code事前にインストール済みであること(claude --versionで確認)
ディスク容量約50MB
(任意)Node.jsMCPサーバーを使う場合

方法1:pipx(公式推奨)

隔離された環境にインストールされるため、他のPythonパッケージと衝突しません。

python3 -m pip install --user pipx
pipx install SuperClaude
SuperClaude install

方法2:pip

pip install SuperClaude
SuperClaude install

方法3:npm

npm install -g @bifrost_inc/superclaude
superclaude install

方法4:ソースから(開発者向け)

git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
./install.sh

MCPサーバーの追加(任意)

コマンド本体とは別に、Tavily・Context7などのMCPサーバーを連携させると2〜3倍の実行速度・30〜50%のトークン削減が見込めるとされています。

# 利用可能なサーバー一覧
SuperClaude mcp --list
# 対話形式でインストール
SuperClaude mcp
# 個別指定
SuperClaude mcp --servers tavily --servers context7

インストール後の確認

SuperClaude install --list
SuperClaude doctor

インストール後はClaude Codeを再起動しないと30コマンドが認識されません。

4. アップデート・アンインストール方法と注意点

アップデート

pip install --upgrade SuperClaude
SuperClaude update

アンインストール

SuperClaude uninstall

実行すると「Complete Uninstall(全コンポーネント削除)」または「Custom Uninstall(個別選択)」を選ぶプロンプトが出ます。

うまくいかない場合の代替手段:

pip uninstall SuperClaude

⚠️ 既知の不具合に注意:GitHub Issueでは SuperClaude uninstall 実行時に Error: No such command 'uninstall' となり、コマンド自体が存在しないというバグ報告(Issue #500)が挙がっています。この場合は上記のpip uninstallに加え、~/.claude/commands/sc/~/.claude/agents/ 配下に残るSuperClaude由来のファイルを手動確認・削除する必要があります。アンインストールを試す前に、現在入っているバージョンで動くかどうか SuperClaude --version と合わせて確認しておくと安全です。

セキュリティ面の注意点(v4.3.0での修正内容)

直近のv4.3.0では、以下のセキュリティ修正が入っています。旧バージョンを使っている場合は更新を推奨します。

  • ユーザー制御下の $SHELL を使った subprocess 呼び出しから shell=True を除去(コマンドインジェクション経路を削減)
  • Docker Compose/MCP設定のダウンロードにSHA-256による整合性検証を追加

その他の注意点

  • Anthropic非公式:サードパーティOSSであり、Anthropicのサポート対象外です。挙動が変わったりコマンドが動かなくなったりするリスクは自己責任で許容する必要があります
  • TypeScriptプラグイン化は未実装:一部の古い記事・ドキュメントで言及されているプラグインシステムはv5.0で予定されている機能で、v4.3.0時点ではまだ従来通りのスラッシュコマンド形式です
  • PEP 668エラー:Debian/Ubuntu系で pip install が拒否される場合は、pipxを使うか --user オプション、あるいは仮想環境を使ってください(--break-system-packagesは最終手段)
  • sudoでのインストールは避け、--userかpipxを使う(権限まわりのトラブル回避)

5. 全30コマンド一覧(カテゴリ別)

元のQiita記事「SuperClaudeカスタムコマンド21個の使い方」(2025年8月公開)の21個から、v4.1系のアップデートを経て以下の9個が新たに確認できます:/sc:spec-panel/sc:help/sc:pm/sc:research/sc:business-panel/sc:agent/sc:index-repo/sc:recommend/sc:sc/sc:spec-panelはv4.1.0のリリースノートで追加が確認できるなど、v4.3.0単体での新規追加ではなくv4.1系の積み重ねによるものです)。
緑色の NEW バッジは、Qiita記事時点から増えたコマンドの目印です。

🧠 計画・設計系

コマンド説明
/sc:brainstorm複数視点でのソクラテス式ブレインストーミング。曖昧なアイデアを仕様に変換
/sc:designアーキテクチャ設計・APIスキーマ・DB設計(実装は行わない)
/sc:estimateタスクの工数・複雑度見積もり
/sc:spec-panel NEW複数の専門家視点による仕様レビュー

💻 開発系

コマンド説明
/sc:implement機能・コンポーネントの実装
/sc:buildビルド・コンパイルワークフロー
/sc:improve既存コードの改善提案
/sc:cleanup技術的負債の削減・リファクタリング
/sc:explainコードの説明・ドキュメント化

🧪 テスト・品質系

コマンド説明
/sc:testテスト実行・生成
/sc:analyzeコード・アーキテクチャの品質分析
/sc:troubleshootデバッグ・根本原因調査
/sc:reflect作業内容の振り返り

📚 ドキュメント系

コマンド説明
/sc:documentドキュメント生成
/sc:help NEWコマンド一覧・使い方のヘルプ表示

🔧 バージョン管理

コマンド説明
/sc:gitスマートコミットメッセージ生成などGit操作支援

📊 プロジェクト管理系

コマンド説明
/sc:pm NEWプロジェクト管理ワークフロー全般
/sc:taskタスクの管理・追跡
/sc:workflowPRD等からの実装計画生成(実装は行わない)

🔍 リサーチ・分析系

コマンド説明
/sc:research NEW並列Web検索による深い調査
/sc:business-panel NEW複数の専門家視点によるビジネス分析

🎯 ユーティリティ系

コマンド説明
/sc:agent NEW専門特化エージェントの呼び出し
/sc:index-repo NEWコンテキスト最適化のためのリポジトリインデックス作成
/sc:index/sc:index-repo のエイリアス(Qiita記事の21個にも同名コマンドあり)
/sc:recommend NEW状況に応じたコマンド推奨
/sc:select-tool最適なMCPツールの選択支援
/sc:spawn大規模タスクをEpic→Story→Taskに分解し並列実行
/sc:load保存済みセッションの読み込み
/sc:save現在のセッション状態を保存
/sc:sc NEW利用可能な全SuperClaudeコマンドを表示

6. 主要コマンドの使い方(実例つき)

/sc:brainstorm — 要件を固める

/sc:brainstorm "AIを使ったプロジェクト管理ツール" --strategy systematic --depth deep
/sc:brainstorm "リアルタイム共同編集機能" --strategy agile --parallel

ソクラテス式の質問を重ねながら、実装に着手できるレベルまで要件を具体化します。

/sc:implement — 実装する

/sc:implement "ユーザープロフィールコンポーネント" --type component --framework react --with-tests
/sc:implement "認証API" --type api --safe --with-tests

何を作るかが決まっている状態で使います。--with-testsを付けるとテストコードも同時生成されます。

/sc:analyze — コードを分析する

/sc:analyze src/auth --focus security --depth deep
/sc:analyze --focus performance --format report

--focusにはsecurity(脆弱性)・performance(ボトルネック)・quality(コードスメル)などを指定できます。

/sc:troubleshoot — 不具合を調査する

/sc:troubleshoot "ユーザーサービスでNull参照例外" --type bug --trace --fix
/sc:troubleshoot "APIのレスポンスが遅くなった" --type performance

--traceでスタックトレースを追跡、--fixで修正案の適用まで行います。

/sc:workflow — 実装計画だけを作る(コードは書かない)

/sc:workflow docs/PRD/auth-feature.md --strategy systematic --depth deep

PRDやアイデアから「DBスキーマ→API→UI→テスト」のような段階的な実装計画を出力します。このコマンド自体はコードを書きません

/sc:research — 最新情報を調べる(NEW)

/sc:research "量子コンピューティングの最新動向" --depth deep
/sc:research "AIコーディングアシスタントの競合分析" --depth exhaustive

複数の検索を並列実行して深いWeb調査を行います。深さは quick / standard / deep / exhaustive の4段階。

/sc:git — Git操作を支援する

/sc:git commit --smart-commit
/sc:git merge feature-branch --interactive

コマンドを「計画系」と「実行系」で分けて覚える

種別コマンド特徴
計画のみ(コード変更なし)brainstorm, workflow, spawn, design, research, estimateドキュメントを出力して停止する
実行系(実際にコード変更)implement, improve, cleanup, test, build, git実際にファイルを変更する

この違いを意識しておくと、「うっかり本番コードが書き換わった」という事故を防ぎやすくなります。

7. 実践的な組み合わせ例

新規プロジェクトの立ち上げから実装までの一連の流れ:

/sc:brainstorm "SNSアプリ"
/sc:design "SNSアーキテクチャ" --type architecture
/sc:workflow "MVP開発" --strategy agile
/sc:implement "ユーザー認証" --focus security --with-tests
/sc:test --type unit --coverage
/sc:git commit --smart-commit

既存コードの改善サイクル:

/sc:analyze src/ --focus quality --depth deep
/sc:cleanup src/legacy
/sc:improve src/legacy --focus performance
/sc:test --type unit

8. まとめ

  • SuperClaude v4.3.0は30コマンド・20エージェント・7モード・8 MCPサーバー構成。Qiita記事執筆時点(2025年8月・21コマンド)からv4.1系のアップデートで拡張されている
  • インストールは pipx install SuperClaude && SuperClaude install が最短。アンインストールは SuperClaude uninstall だが動作しない既知の不具合があるため、pip uninstall と手動クリーンアップを覚えておくと安心
  • 「Claude Codeが進化した今も必要か」については、開発チーム自身がSkills移行・Hooks活用・Plan Mode統合を”未対応の優先課題”と認めている。コマンド集・専門エージェントとしての実用性は今も高いが、Skillsで代替できる部分は公式機能へ寄せていく方が今後の互換性は高いと考えられる

参考

AI
スポンサーリンク
気になるあの子にも教えてあげよう

コメント

タイトルとURLをコピーしました