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サーバー | 8 | Tavily、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化すべき領域 |
| Hooks | 28種類のフックイベント | 基本的な定義のみ、ほとんど未活用 | 大きな伸びしろが残っている |
| 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. インストール方法
前提条件
| 項目 | 要件 |
|---|---|
| Python | 3.8以上 |
| pip | 最新版 |
| Claude Code | 事前にインストール済みであること(claude --versionで確認) |
| ディスク容量 | 約50MB |
| (任意)Node.js | MCPサーバーを使う場合 |
方法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:workflow | PRD等からの実装計画生成(実装は行わない) |
🔍 リサーチ・分析系
| コマンド | 説明 |
|---|---|
/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で代替できる部分は公式機能へ寄せていく方が今後の互換性は高いと考えられる

コメント