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

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

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

この記事でわかること

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

誰向けの記事か

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

SuperClaude Framework とは

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

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

基本情報

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

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

つまり仕組みはシンプルで、「Claude Codeに対して定義済みのプロンプト集を外部から流し込んでいる」だけです。この理解が、後述するトラブルシュート（なぜコマンドが効かないか、なぜ設定が競合するか）に直結します。

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

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

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

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

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

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

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

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

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

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

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

7つの振る舞いモード

公式では「Token Efficiencyモード有効時、長大なセッションでのトークン消費を30〜50%削減できる」と説明されており、Max プラン $100/月の元を取りたい利用者に特に有効です。

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

公式では「MCPサーバー併用で2〜3倍高速化、30〜50%トークン削減」と記載されていますが、MCPサーバーは任意です。ローカルのみで使うか、Tavilyだけ導入するか、全部入れるかは自由に選べます。

料金・前提条件

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

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

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

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

方式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

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

インストール後、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非公式の第三者プロジェクトをホームディレクトリ直下に展開する性質上、業務PCで使う際は以下を確認してください。

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

他の選択肢との違い

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

ざっくり選び方:

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

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

こんな方におすすめ

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

おすすめしない方

• Anthropic公式サポートが必須の業務環境
• ~/.claude/ への書き込みが社内ポリシーで制限されている環境
• CLAUDE.md をすでに大量に自作していて、上書きされると困る人
• 最小構成で Claude Code を使いたい初心者（まず素のClaude Codeに慣れることを推奨）
• Python環境の構築・pipx利用が苦手な非エンジニア

よくある質問（FAQ）

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

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

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

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

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

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

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

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

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

A. バージョンによって異なります。v3系は17〜21コマンド、v4系で30コマンドに拡張されました。2026年4月時点の最新 v4.3.0 では30コマンドです。

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

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

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

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

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

A. 公式で「TypeScriptプラグインシステムを v5.0 で導入予定」とアナウンスされていますが、リリース時期は未定です（2026年4月時点）。

まとめ

• SuperClaude Frameworkは、Claude Codeの動作を上書きするMarkdown設定ファイル群。プラグインではなくコンテキスト注入の仕組みを持つ
• v4.3.0（2026年3月）時点で30コマンド・16〜20エージェント・7モード・8MCPサーバーを提供
• インストールは pipx または pip が推奨。1分で導入可能
• 完全無料（MIT）だが、前提のClaude Codeは有料（Pro $20/月、Max $100/月）
• ペルソナ切り替えは @agent-〇〇 で明示、またはキーワードで自動起動
• 業務導入時はホームディレクトリ書き込み・非公式ツール・MCP外部通信の3点を確認
• 個人開発・学習用途には非常に強力。公式サポートが必要な業務環境では Claude Code Skills の方が安全

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

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