SuperClaude Framework 使い方完全ガイド｜Claude Code動作を上書き・コンテキスト管理・ペルソナ切り替え（★22,900超）

SuperClaude Frameworkは「Claude Codeの振る舞いを上書きするMarkdown設定ファイル群」です。 インストールすると ~/.claude/ 配下に30個のスラッシュコマンドと16〜20個の専門エージェント、7つの振る舞いモードが追加され、Claude Code起動時に自動で読み込まれて挙動を書き換えます。GitHubスター数は約22,900（2026年5月時点）。

この記事では、公式リポジトリ（v4.3.0、2026年3月22日リリース）の最新情報をベースに、仕組み・料金・インストール・実際の使い方・新登場のPlugin版との違い・業務導入時の注意点まで一気通貫で整理します。

この記事でわかること

• SuperClaude Frameworkが「プラグイン」ではなく「コンテキストファイル群」である理由
• 30コマンド／16〜20エージェント／7モード／8MCPサーバーの全体像
• pipx・pip・npm・Git・uvの5つのインストール方式と推奨条件
• 新登場：SuperClaude_Plugin（BETA）とFramework版の違い・移行判断
• ペルソナ（エージェント）の手動呼び出しと自動起動の使い分け
• Claude Code Skills・CLAUDE.md手書き・カスタムスラッシュコマンドとの違い
• 業務PCで導入する際のセキュリティチェックポイント
• コンテキストウィンドウの消費問題と「脱SuperClaude」という選択肢

誰向けの記事か

• Claude Codeをすでに使っていて、さらにワークフローを強化したい開発者
• 「SuperClaudeという名前は聞くが何ができるかわからない」という方
• Framework版とPlugin版のどちらを選ぶか判断したい方
• 個人利用だけでなく、チームや会社で導入できるか判断したい方

SuperClaude Framework とは

SuperClaude Frameworkは、Claude Codeの動作を「構造化された開発プラットフォーム」へ変換する設定フレームワークです。 開発元は第三者コミュニティのSuperClaude-Org。ライセンスはMIT、公式リポジトリ https://github.com/SuperClaude-Org/SuperClaude_Framework で公開されています。

公式では「behavioral instruction injection（動作指示の注入）と component orchestration（コンポーネントの統制）により Claude Code を拡張する」と説明されており、Anthropic本体とは提携関係にない第三者プロジェクトである点は必ず押さえておく必要があります。

基本情報（2026年5月時点）

なぜ「プラグイン」ではなく「設定ファイル群」なのか

SuperClaudeは独立した実行ソフトウェアではありません。本体は .md（Markdown）形式のコンテキストファイル群で、インストール時にホームディレクトリ直下の ~/.claude/ に配置されます。Claude Codeは起動時にこのディレクトリを読み込み、そこに書かれた指示を「追加のプロンプト」として解釈して振る舞いを変えます。

つまり仕組みはシンプルで、「Claude Codeに対して定義済みのプロンプト集を外部から流し込んでいる」だけです。この理解が、コンテキスト消費問題の本質的な理由に直結します。

できること：30コマンド・16〜20エージェント・7モード・8MCP

出典: SuperClaude Framework 公式GitHubリポジトリ

v4.3.0（Framework版）時点で提供される要素は以下の4カテゴリに整理できます。

30個のスラッシュコマンド

公式では用途別に以下の8カテゴリに分類されています。

特に使用頻度が高いのは /sc:brainstorm（企画初期）・/sc:implement（実装）・/sc:troubleshoot（バグ調査）・/sc:research（Web横断リサーチ）の4つです。

16〜20個の専門エージェント（ペルソナ）

エージェントは「ドメインに特化した振る舞いを定義したMarkdownファイル」で、必要に応じて手動または自動で切り替わります。

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

1. 手動指定: @agent-security "認証コードをレビューして" のように明示
2. 自動起動: 指示文中のキーワード（"security", "performance", "refactor" など）で自動的に対応エージェントが起動

公式READMEは「20個」と記載し、公式エージェントドキュメントでは主要16個が個別解説されているため、数字に幅がある点に注意してください。

7つの振る舞いモード

公式では「Token Efficiencyモード有効時、長大なセッションでのトークン消費を30〜50%削減できる」と説明されています。ただしこれは公式の主張値であり、個人環境での実測値とは異なる場合があります。

8つのMCPサーバー統合（オプション）

MCPサーバーは任意です。ローカルのみで使うか、Tavilyだけ導入するか、全部入れるかは自由に選べます。MCPを使わなくても30コマンド・16エージェント・7モードはすべて動作します。

料金・前提条件

SuperClaude Framework本体は完全無料（MITライセンス）ですが、利用にはClaude Code（有料）が必須です。

⚠️ 2026年5月確認時点の注意点: Claude Code Maxプランは「Max 5x（$100/月）」と「Max 20x（$200/月）」の2段階構成に変更されています。以前の「Maxプラン $100/月」という表記は現行の5xプランを指します。

公式READMEでは「ベストな体験のためにMax（$100/月）を推奨」と明記されています。これは30コマンド・16エージェント・7モードをフル活用すると、Proプランでは使用量上限に達しやすいためです。

Claude Code の料金体系の詳細は Claude Code 料金プラン解説 をご覧ください。

インストール手順（Framework版：5方式）

公式では5通りのインストール方法が用意されています。迷ったらpipx（macOS / Linux）または pip（Windows含む全プラットフォーム）を選んでください。

前提環境: Python 3.10以上が必要です（PyPI公式記載）。以前は3.8+と案内されていましたが、現行版では3.10+が必須となっています。

方式1: pipx（macOS / Linux 推奨）

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

方式2: pip（全プラットフォーム対応）

pip install SuperClaude
SuperClaude install

方式3: npm（Node.js開発者向け）

npm install -g @bifrost_inc/superclaude
superclaude install

方式4: Gitクローン

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

方式5: uv（開発者向け・編集モード）

git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install -e ".[dev]"
SuperClaude install --dry-run

インストール後の動作確認

SuperClaude --version
SuperClaude install --list-components
SuperClaude doctor

配置先ファイル

既存の CLAUDE.md は自動バックアップされますが上書きされます。自分でカスタマイズしていた場合は事前に手動退避しておくのが安全です。

MCPサーバーの追加

SuperClaude mcp --list                          # 利用可能サーバー一覧
SuperClaude mcp --servers tavily context7       # 指定サーバーをインストール

アンインストール

SuperClaude uninstall
pip uninstall SuperClaude

【新機能】SuperClaude_Plugin（BETA）とは

出典: SuperClaude_Plugin 公式GitHubリポジトリ

2026年春以降、Claude Codeのネイティブプラグインとして「SuperClaude_Plugin」のBETA版が登場しました。 Framework版（pip/pipx/npm等でインストールする従来版）とは別のリポジトリで管理される、まったく異なる実装です。

Plugin版のインストール方法

/plugin marketplace add SuperClaude-Org/SuperClaude_Plugin
/plugin install sc@SuperClaude-Org

Python・Node.jsの環境構築が不要で、Claude Codeが自動的に更新を管理します。

Plugin版の特徴

Framework版からPlugin版へ移行する場合の注意

Plugin版に移行する場合、先にFramework版をアンインストールする必要があります（非互換のため）。

SuperClaude uninstall
pip uninstall SuperClaude
# ↑ Framework版を削除してから↓Plugin版を導入
/plugin marketplace add SuperClaude-Org/SuperClaude_Plugin
/plugin install sc@SuperClaude-Org

どちらを選ぶか

実際の使い方：スラッシュコマンド・エージェント・モード

出典: Claude（Anthropic公式）

インストール後、Claude Codeを起動すると /sc: で始まるコマンドが補完されるようになります。

基本の流れ

# 1. 企画初期の壁打ち
/sc:brainstorm "社内向けのタスク管理SaaSを作りたい"

# 2. 要件を詰める
/sc:design "ユーザー・タスク・プロジェクト3モデルのAPI設計"

# 3. 実装
/sc:implement "POST /api/tasks のハンドラをFastAPIで書いて"

# 4. テスト生成
/sc:test "先ほどのハンドラの正常系・異常系テスト"

# 5. バグ調査
/sc:troubleshoot "デプロイ後に 500 エラーが出る。ログを貼る"

ペルソナ（エージェント）切り替えの具体例

セキュリティ観点でコードレビューしてほしい場合は、@agent-security を明示的に呼び出します。

@agent-security "auth/login.py のJWT実装を脅威モデル観点でレビューしてください"

フロントエンドのコンポーネント設計なら:

@agent-frontend-architect "Next.js 15のApp Routerで、
認証後にしかアクセスできないダッシュボード構成を提案して"

キーワードに「security」「performance」「refactor」などを含む自然言語の指示では、対応エージェントが自動的に起動します。明示的に切り替えたいときだけ @agent-〇〇 を使う、というのが基本運用です。

業務別・おすすめコマンド一覧

Token Efficiency モードの使い方

トークン消費を抑えたいときは、Claude Code起動直後に以下のように宣言します。

Token Efficiency モードで進めてください。
以下のリファクタリングを、変更差分の要点だけ返してください。

公式説明では30〜50%のトークン削減が見込めます。長時間セッションでのコスト最適化に有効です。

v4.3.0 のセキュリティ改善（2026年3月22日リリース）

最新版のv4.3.0では、セキュリティと安定性に関する大きな改善が入っています。

• shell=True による危険なコマンド実行を排除（シェルインジェクションリスク除去）
• ダウンロードファイルのSHA-256整合性検証を追加
• プレースホルダーコードを本番実装に置き換え
• テストケースが62個追加され、合計136件に

業務PCで導入するなら v4.3.0 以降を強く推奨します。 以前のバージョン（v4.2以前）にはシェルインジェクションの余地があったため、アップデートせず古いバージョンを使い続けることは避けてください。

業務導入時のセキュリティ注意点

出典: Anthropic セキュリティポリシー

Anthropic非公式の第三者プロジェクトをホームディレクトリ直下に展開する性質上、業務PCで使う際は以下を確認してください。

個人開発や学習用途であれば気軽に入れて問題ありません。 ただし業務利用では、情シス部門・セキュリティ部門に使用申請・ポリシー確認を通すことを推奨します。

他の選択肢との違い

「Claude Codeの挙動を拡張したい」というニーズには、SuperClaude以外にもいくつかの選択肢があります。

選び方の目安:

• まず試すなら SuperClaude Framework（個人利用・学習）
• Python不要で試すなら SuperClaude_Plugin（BETA）
• 業務で大規模に配布するなら Claude Code Skills（公式機能）
• 軽量・最小限なら CLAUDE.md手書き

Claude Code Skills 活用ガイド や CLAUDE.md 書き方 ベストプラクティス も合わせてご覧ください。

こんな方におすすめ / おすすめしない方

こんな方におすすめ

• Claude Codeを個人で深く使い込みたいエンジニア
• ドメイン別にエージェントを切り替えて開発スピードを上げたい人
• /sc:brainstorm /sc:research などのワークフロー支援がほしい人
• OSSをフォークしてカスタマイズするのが苦ではない人
• トークン消費を抑えて長時間セッションを回したい人
• Python環境なしで試したい人（Plugin版BETA）

おすすめしない方

• Anthropic公式サポートが必須の業務環境
• ~/.claude/ への書き込みが社内ポリシーで制限されている環境
• CLAUDE.mdをすでに大量に自作していて、上書きされると困る人
• 最小構成でClaude Codeを使いたい初心者（まず素のClaude Codeに慣れることを推奨）
• Python環境の構築・pipx利用が苦手な非エンジニア（ただしPlugin版BETAなら不要）
• 設定ファイルにコンテキストを取られたくないパワーユーザー（カスタムサブエージェント等の代替を検討）

よくある質問（FAQ）

Q1. SuperClaude Frameworkは無料で使えますか？

フレームワーク自体は完全無料（MITライセンス）です。ただし前提となるClaude Code（Anthropic公式）が有料で、Proプラン $20/月、Max 5xプラン $100/月、Max 20xプラン $200/月のいずれかが別途必要です。

Q2. Anthropic公式のツールですか？

いいえ。SuperClaude-Org というコミュニティが運営する第三者プロジェクトです。公式READMEにも「Anthropicと提携しておらず、承認も受けていない」と明記されています。

Q3. インストールするとClaude Codeの既存設定は上書きされますか？

既存の ~/.claude/CLAUDE.md があれば自動でバックアップされた上で上書きされます。独自カスタマイズしている場合は事前に手動バックアップを推奨します。

Q4. MCPサーバーは必須ですか？

いいえ、オプションです。MCPサーバーを入れなくても30コマンド・16エージェント・7モードは動作します。Web検索やブラウザ自動化を使いたい場合だけ追加すればOKです。

Q5. コマンド数が「17」「21」「30」と情報源によって違うのはなぜ？

バージョンによって異なります。v3系は17〜21コマンド、v4系で30コマンドに拡張されました。2026年5月時点の最新Framework版（v4.3.0）では30コマンドです。なお、Plugin版（BETA）では29コマンドと若干異なります。

Q6. 設定ファイルがコンテキストを大量消費するという問題は本当ですか？

現実として指摘されている問題です。大量のMarkdown設定ファイルがコンテキストウィンドウの50%超を占有するという報告が複数あります。これは「コンテキストファイル群を注入する」というSuperClaude自体の仕組みに由来します。

この問題には現在いくつかの対処法があります。Token Efficiencyモードで全体消費量を30〜50%削減する、SuperClaude_Pluginに移行する（改善が期待されるが確認中）、あるいはSuperClaudeをやめてプロジェクト特化のカスタムサブエージェントを自作するという選択肢もあります。Claude Code サブエージェント 使い方 を参考に自作を検討するのも有効です。v5.0では選択的ロードによる根本解決が予定されています。

Q7. Framework版とPlugin版はどちらを選べばいいですか？

現時点では安定性重視ならFramework版（v4.3.0）、Python環境なしで最新機能を試したければPlugin版（BETA）です。Plugin版はまだBETAステータスで、Framework版との非互換性があります。業務環境ではPlugin版のBETAが外れるまでFramework版を推奨します。

Q8. 業務PCで使っても大丈夫ですか？

情シス・セキュリティ部門への確認を推奨します。非公式ツールであること、ホームディレクトリに書き込むこと、MCPサーバー有効化時に外部APIと通信することが主な確認ポイントです。セキュリティ修正済みのv4.3.0以降を使ってください。

Q9. アンインストールはできますか？

できます。SuperClaude uninstall と pip uninstall SuperClaude の2コマンドで削除できます。~/.claude/ 配下のバックアップファイルは必要に応じて手動整理してください。

Q10. v5.0はいつリリースされますか？

公式で「TypeScriptプラグインシステムをv5.0で導入予定」とアナウンスされていますが、リリース時期は未定です（2026年5月時点）。Plugin版（BETA）の登場がv5.0の一部機能の先行実装とも見られますが、正式な関係は公式から明示されていません。

まとめ

• SuperClaude Frameworkは、Claude Codeの動作を上書きするMarkdown設定ファイル群。プラグインではなくコンテキスト注入の仕組みを持つ
• v4.3.0（2026年3月）時点で30コマンド・16〜20エージェント・7モード・8MCPサーバーを提供
• ⚠️ Python 3.10+が必要（旧情報の「3.8+」は古い。現行PyPI要件は3.10+）
• ⚠️ Claude Code MaxはMax 5x（$100/月）とMax 20x（$200/月）の2段階に変更済み
• インストールはpipxまたはpipが推奨。1分で導入可能
• 完全無料（MIT）だが、前提のClaude Codeは有料
• 新登場のPlugin版（BETA） はPython不要・自動更新・23エージェント対応だが、Framework版と非互換。安定版はFramework版
• コンテキストウィンドウの50%超を消費するケースがあるため、Token Efficiencyモードや自作サブエージェントとの使い分けも検討する価値あり
• 業務導入時はホームディレクトリ書き込み・非公式ツール・MCP外部通信の3点を確認

より深く調べたい方は、下記の関連記事も合わせてご覧ください。

• Claude Codeとは？機能・料金・始め方ガイド
• Claude Code 使い方ガイド
• Claude Code Skills 活用ガイド
• CLAUDE.md 書き方 ベストプラクティス
• Claude Code サブエージェント 使い方
• Claude Code 料金プラン解説