SuperClaude 入門｜Claude Code を強化する導入と使い方

SuperClaude とは何か

SuperClaude は、Claude Code を「構造化された開発プラットフォーム」に変える設定フレームワークです。公式リポジトリでは「メタプログラミング型の設定フレームワーク」と表現されており、振る舞いの指示(behavioral instruction)を注入して、ワークフローを体系化します。

重要なのは、SuperClaude は 単体で動くソフトウェアではない という点です。あくまで Claude Code の上に乗る設定の集合体であり、すべての処理は Claude Code を通して実行されます。そのため、利用前提として Claude Code がすでにインストールされている必要があります。

最新版は v4.3.0(2026 年 3 月 22 日リリース)で、実装の修正・セキュリティ強化・Claude Code との整合性向上が中心となっています。

SuperClaude で何ができるのか

SuperClaude を導入すると、Claude Code に以下の 4 つの要素が追加されます(出典: GitHub 公式 README)。

• 30 個のスラッシュコマンド(/sc: で始まる構文):ブレスト・設計・実装・テスト・ドキュメント生成など開発ライフサイクル全体をカバー
• 20 個の専門エージェント:セキュリティ・フロントエンドなどドメインごとの専門家として振る舞う
• 7 個のビヘイビアモード:ブレインストーミング、ディープリサーチ、トークン効率重視など、目的別の動作モード
• 8 個の MCP サーバー連携:Context7・Serena・Tavily など外部ツールとの接続で機能を拡張

つまり、毎回プロンプトを長文で書かなくても、/sc:implement のような短いコマンドで「設計思想を踏まえた実装」を呼び出せるようになる、というのが SuperClaude の価値です。

インストール手順

公式が推奨するのは pipx を使った方法です。Python 3.8 以上が必要です。次の順序で進めます。

1. pipx で本体をインストールする:pipx install SuperClaude
2. インストーラーを実行してコンポーネントを配置する:SuperClaude install
3. インストーラーの案内に従い、導入するプロファイル(コマンド・エージェント・モード等)を選択する
4. Claude Code を再起動して、設定の読み込みを反映させる

pipx を使わない場合は、以下の代替手段もあります。

• pip を使う場合:pip install SuperClaude && SuperClaude install
• npm を使う場合:npm install -g @bifrost_inc/superclaude && superclaude install(パッケージ名は更新されることがあるため、最新は公式リポジトリで確認してください)
• Git から直接導入する場合:git clone でリポジトリを取得し、ディレクトリに移動して ./install.sh を実行する

インストールが終わると、SuperClaude は設定ファイル群を配置し、Claude Code 起動時にそれらの振る舞い指示を読み込むようになります。

出典: SuperClaude Quick Start ガイド / PyPI: superclaude

最初に試したい 4 つのコマンド

導入後、Claude Code 上で動作確認を兼ねて試すとよいコマンドを、公式 quick-start から紹介します。次の順番で触ると流れが掴めます。

1. /sc:brainstorm "タスク管理用の Web アプリ" — 要件を対話的に掘り下げる(まずこれを試すのが推奨)
2. /sc:analyze src/ — 既存コードを解析して構造を把握する
3. /sc:implement "ユーザー認証" — 機能を実装する
4. @agent-security "認証フローをレビュー" — 専門エージェントを名指しで呼び出す

/sc: という接頭辞でコマンドが発火し、@agent- というパターンで専門エージェントが起動する、という 2 系統を覚えておけば基本操作は十分です。

主要スラッシュコマンド一覧(用途別)

30 個のコマンドは用途ごとに整理されています。代表的なものを挙げます。

• 計画・設計:/brainstorm、/design、/estimate、/spec-panel
• 開発:/implement、/build、/improve、/cleanup、/explain
• テスト・解析:/test、/analyze、/troubleshoot、/reflect
• ドキュメント:/document、/help
• バージョン管理:/git
• プロジェクト管理:/pm、/task、/workflow
• リサーチ:/research、/business-panel
• ユーティリティ:/agent、/index-repo、/recommend、/spawn、/load、/save

なお、利用できるコマンドの一覧は /sc で確認できます。最初はすべてを覚える必要はなく、/brainstorm → /implement → /test という王道の 3 つから始めるのが現実的です。

エージェントとビヘイビアモードの使い分け

SuperClaude のもう 1 つの柱が、20 個の専門エージェントと 7 個のビヘイビアモードです。

エージェントは @agent-security のように名前を指定して呼び出し、その分野の専門家として回答させます。たとえばセキュリティレビュー、フロントエンド設計など、観点を切り替えたいときに有効です。

ビヘイビアモードは「どういうスタンスで考えるか」を切り替える仕組みです。アイデアを広げたいときはブレインストーミング、調査重視ならディープリサーチ、コンテキスト消費を抑えたいときはトークン効率重視、といった具合に使い分けます。コマンドとモードを組み合わせることで、同じ /implement でも振る舞いが変わります。

つまずきやすいポイントと対処

導入時にハマりやすい点を整理しておきます。

• Claude Code 未導入のまま入れてしまう:SuperClaude は単体動作しないため、先に Claude Code を用意する
• SuperClaude install を忘れる:pip/pipx で本体を入れただけでは設定が配置されない。必ずインストーラーを実行する
• 再起動せず反映されない:設定は起動時に読み込まれるため、導入後は Claude Code を再起動する
• npm パッケージ名の変動:配布パッケージ名は変わる場合があるので、迷ったら公式リポジトリの記載を正とする

4 週間で身につける学習ステップ

公式 quick-start は、段階的な習熟プランを提案しています。次の順序で広げると無理がありません。

1. 第 1 週:/brainstorm と /analyze など中核コマンドに慣れる
2. 第 2 週:ビヘイビアモードを切り替えて、出力の違いを体感する
3. 第 3 週:MCP サーバー連携を試し、外部ツールと組み合わせる
4. 第 4 週:複数コマンドやエージェントを組み合わせた応用パターンに進む

まとめ

SuperClaude は、Claude Code を「構造化された開発プラットフォーム」へ引き上げる設定フレームワークです。pipx でのインストールと SuperClaude install の 2 ステップで導入でき、/sc:brainstorm を打てばすぐに体験できます。まずは王道の 3 コマンドから触り、慣れてきたらエージェントとモードを組み合わせて、自分の開発フローに合わせて拡張していくのがおすすめです。最新の仕様やコマンドは更新されるため、詳細は必ず公式リポジトリで確認してください。

出典: SuperClaude_Framework(GitHub) / Quick Start / npm: @superclaude-org/superclaude