Claude CodeにSuperClaudeを入れると何が変わるか — 追加物の実体

SuperClaude Frameworkは、Claude Codeに/sc:で始まるスラッシュコマンドと、役割別の指示ファイルを足すオープンソースの設定フレームワークです。READMEはこれを「behavioral instruction injection(振る舞い指示の注入)」で開発手順を構造化するものと説明しています。モデルが賢くなるわけではなく、Claude Codeに読ませる指示が増える仕組みです。

SuperClaudeはAnthropic製ではなく、READMEにも「not affiliated with or endorsed by Anthropic」とあります。

SuperClaudeとは — Claude Codeに指示を足す第三者フレームワーク

SuperClaude Frameworkは、GitHubのSuperClaude-Orgが公開しているMITライセンスのリポジトリです。リポジトリの説明文は「specialized commands, cognitive personas, and development methodologies」でClaude Codeを強化する設定フレームワークとしています。GitHub上のスターは23.9k、フォークは2.0kです。

READMEの統計欄は次の4つを掲げています。

Claude Code本体の拡張には、プラグインでスキル・エージェント・hooks・MCPサーバーを足す仕組みがあります。プラグインのリファレンスには、commands/はフラットなMarkdownのコマンドファイルで、新しいプラグインにはskills/が望ましいと書かれています。SuperClaudeは、この拡張口を使って「開発の型」を一式まとめて配るツールです。ただしv4.xは独自のCLIで入れる方式で、プラグイン経由のインストールはv5.0の予定です。

導入手順 — pipxで入れてコマンドを展開する

READMEが推奨する現行の安定版(v4.3.0)の入れ方は、PyPIのパッケージをpipxで入れ、付属のCLIでコマンドを展開する2段階です。

# PyPIから入れる
pipx install superclaude
 
# 30のスラッシュコマンドを展開する
superclaude install
 
# 展開結果と環境の診断
superclaude install --list
superclaude doctor

インストール後はClaude Codeを再起動すると、/sc:researchや/sc:implementなどが使えるようになります。/scと打つと30コマンドの一覧が出る、とREADMEは説明しています。

MCPサーバーは任意です。READMEによれば、導入は専用のサブコマンドで行います。

superclaude mcp --list                               # 一覧
superclaude mcp                                      # 対話式で導入
superclaude mcp --servers tavily --servers context7  # 個別に導入

git cloneして./install.shを実行する方法もあります。README冒頭の注意書きは、以前のドキュメントにあるTypeScriptのプラグイン方式がまだ使えない点を明記しています。/plugin marketplace addで入れる手順は「This feature is not yet available」で、v5.0は開発中、公開時期は未定と書かれています。

追加されるスラッシュコマンドの実体

READMEが挙げる30コマンドは、8つの分類に分かれています。

コマンドの実体は、リポジトリのsrc/superclaude/commands/にあるMarkdownファイルです。implement.mdが/sc:implementに、research.mdが/sc:researchに対応します。コマンド自体は固有の実行エンジンではなく、Claude Codeに渡す指示文だと分かります。

いくつか実体に触れておきます。

• /sc:implementは、--type component|api|service|featureや--framework react|vue|express、--safe、--with-testsといったオプションを取ります。
• /sc:brainstormは、曖昧な要望をSocratic(問いかけ型)の質問で要件に落とします。--strategyと--depthで進め方を変えられます。
• /sc:researchは、Tavily MCPによる並列のWeb検索と、リンクをたどる多段の探索を行い、報告書をclaudedocs/research_*.mdに保存します。深さはquickからexhaustiveまで4段階です。

調査の深さは、READMEの表では次のように定義されています。

保存先がclaudedocs/であるように、コマンドによってはプロジェクト内にファイルを書き出します。/sc:pmのPDCAサイクルはdocs/pdca/[feature]/に文書を作る設計です。導入後はgitの差分に新しいディレクトリが出る前提で見ておくと混乱しません。

ペルソナの実体は指示ファイル — エージェントとモード

READMEの「About」はcognitive personasと表現しますが、ドキュメントの用語では専門エージェントとモードです。この2つがSuperClaudeの中身です。

エージェントについて、ユーザーガイドは次のように割り切っています。エージェントは別のAIモデルでもソフトウェアでもなく、Claude Codeが読んで振る舞いを変えるコンテキスト設定のMarkdownだ、という説明です。「自動で起動する」という表現も、ロジックで切り替わるのではなく、キーワードやファイル種別に応じて専門領域の指示を読ませる意味だと同じ文書が書いています。

呼び出し方は2つあります。

エージェントの顔ぶれには、system-architect、backend-architect、frontend-architect、devops-architect、security-engineer、performance-engineer、root-cause-analyst、quality-engineer、refactoring-expert、python-expert、requirements-analyst、technical-writer、learning-guide、deep-research-agentなどがあります。

モードは、状況に応じた話し方や進め方の切り替えです。ガイドの表にある自動の切替条件は次のとおりです。

• 曖昧な依頼(「I want to build an app」など)では、Brainstormingモードがオンになります。
• 3ステップ超、または2ディレクトリ超の作業では、Task Managementモードになります。
• コンテキストの使用量が増えると、Token Efficiencyモードで記号による圧縮表現に寄ります。

手動で強制するフラグも用意されています。--brainstorm、--introspect、--task-manage、--orchestrate、--uc(トークン圧縮)で、--introspect --ucのような組み合わせも書けます。Token Efficiencyモードのトークン削減はガイドの表で「estimated 30-50%」と見積もりの扱いです。

PMエージェントは少し特殊です。コマンド集の説明では、/sc:pmは呼ぶコマンドではなく常時動くバックグラウンド層とされています。セッション開始時の文脈復元、タスクの各エージェントへの委任、Plan→Do→Check→ActのPDCAサイクル、進捗の保存を担います。

素のClaude Codeと何が変わるか

追加されるのは「依頼の型」と「読ませる指示の量」です。ツールの権限や実行環境は変わりません。

最後の行は、READMEの記述から導ける注意点です。振る舞いを指示文で実現する以上、読み込む指示が増えた分は会話の前提として毎回のコンテキストに乗ります。READMEは「Smaller framework, bigger projects」と、4.1でフレームワークの占有量を減らしたと述べています。数値は載っていないため、自分の環境での消費量は導入前後で比べる必要があります。

MCPを足したときの効果として、READMEは「2-3x faster execution and 30-50% fewer tokens」と書きます。READMEのコメントは、Serenaを「Code understanding (2-3x faster)」、Sequentialを「Token-efficient reasoning (30-50% fewer tokens)」と書き分けています。ただし、これはプロジェクト側の主張です。計測条件は示されていません。

MCPなしでも動くことは明記されています。「Without MCPs: Fully functional, standard performance」です。導入の最小構成は、MCPを入れずにコマンドとエージェントだけで始める形になります。

入れる前に突き合わせたい食い違い

README、インストールガイド、ユーザーガイドを読み比べると、記述がそろっていない箇所があります。第三者ツールなので、手元で動かすときは次の点を頭に置いておくと混乱を避けられます。

コマンド集の「Last Updated」は2026-01-18です。表記が割れたときは、手元でsuperclaude install --listとsuperclaude doctorの出力を見るのが確実です。

また、インストールガイドは展開先として~/.claude/を挙げ、~/.claude/CLAUDE.mdをメインの入口、~/.claude/*.mdを振る舞いの指示ファイル、~/.claude/claude-code-settings.jsonをMCP設定としています。すでに自分のユーザー設定CLAUDE.mdを育てている場合は、導入前に退避しておくと戻せます。ガイドにはSuperClaude backup --createもあります。サブエージェントへのCLAUDE.mdの渡し方はomitClaudeMdでサブエージェントにCLAUDE.mdを渡さない設定にまとまっています。

入れたあとの確かめ方と外し方

導入前後で何が変わったかは、ファイルの差分で見られます。次の例は、展開先のディレクトリを事前にコピーして比べる手順です(コマンドは筆者の例で、SuperClaude側の手順ではありません)。

cp -R ~/.claude ~/.claude.bak
superclaude install
diff -rq ~/.claude.bak ~/.claude

増えたMarkdownの行数は、そのままClaude Codeに読ませる指示の量の目安になります。会話ごとのトークン消費は、Claude Codeの/usageでLoopの内訳から消費トークンを特定する方法で導入前後を見比べられます。

外すときは、インストールガイドによればSuperClaude uninstallでフレームワークを削除し、pip uninstall SuperClaudeでパッケージを外します。

向く場面と向かない場面

プラグインを複数読み込む運用なら、CLAUDE_CODE_PLUGIN_DIRSで複数プラグインをセッション単位で読み込むのように、セッション単位で切り替えるやり方もあります。SuperClaudeの30コマンドを常時有効にするか、必要な場面だけ使うかは、コンテキストの消費と相談になります。

まとめ

SuperClaudeがClaude Codeに足すのは、新しい能力ではなく、役割別のコマンドとエージェント定義という「型」です。エージェントも指示ファイルの束で、別のモデルが動くわけではありません。導入する前に決めたいのは、自分のCLAUDE.mdとの衝突、コンテキスト消費の増え方、プロジェクトに書き出されるファイルの3点です。ドキュメント間の食い違いは手元の出力で突き合わせるのが近道です。