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

SuperClaude Frameworkは、Claude Codeに /sc: で始まるスラッシュコマンド30個と専門エージェント20個を追加する、無料のOSS（MITライセンス）です。 中身はMarkdownで書かれた指示書なので、Claudeのモデル性能が上がるわけではありません。「作業の進め方の型」をまとめて配る仕組みと考えると実態に近いです。

2026年10月時点の最新版はv4.3.0（2026年3月22日リリース）で、GitHubスターは約2.4万（23,905）。Anthropicの公式ツールではなく、コミュニティのSuperClaude-Orgが開発しています。

この記事でわかること

• SuperClaude Frameworkの仕組みと、v4.3で ~/.claude/ に入るもの・入らないもの
• 30コマンド／20エージェント／7モード／8MCPサーバーの全体像
• 現行のインストール手順（pipx・Git）と、npm版を勧めない理由
• /sc: コマンド・エージェント（ペルソナ）・フラグの実際の使い方
• SuperClaude_Plugin（BETA）とFramework版の違い
• Claude Code標準のSkills・サブエージェント・プラグインとの使い分け
• 業務PCで使うときの確認点、よくあるトラブル、正しいアンインストール手順

誰向けの記事か

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

Claude Code自体がはじめての方は、先にClaude Codeとは？機能・料金・始め方を読んでおくと理解が早くなります。

SuperClaude Framework とは

SuperClaude Frameworkは、Claude Codeを「決まった手順で開発を進める環境」に変えるための設定フレームワークです。 公式READMEでは "A configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies." と説明されています。

公開先は SuperClaude-Org/SuperClaude_Framework。READMEには "This project is not affiliated with or endorsed by Anthropic." とあり、Anthropicとは無関係の第三者プロジェクトです。

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

仕組み：プログラムではなく「指示書」

SuperClaudeの本体は、ほぼすべてMarkdownファイルです。Claude Codeはこれらをカスタムコマンドやサブエージェントの定義として読み込み、書かれた指示に沿って振る舞います。

公式のエージェント解説も「エージェントの自動起動はシステムの処理ではなく、コンテキストファイルに書かれた振る舞いの指示である（"Agent activation isn't automatic system logic - it's behavioral instructions in context files."）」と書いています。つまり、タイトルにある「動作の上書き」は、プロンプトで振る舞いの方向を決めるという意味です。Claude Codeの権限設定やサンドボックスを置き換えるものではありません。

v4.3で入るもの・入らないもの（v3との違い）

古い解説記事では「インストールすると ~/.claude/CLAUDE.md が書き換えられ、起動時に毎回読み込まれる」と説明されていることがあります。これはv3〜v4.0前半の方式で、v4.3.0の superclaude install は CLAUDE.md を編集しません（PyPIで配布されている4.3.0のソースで確認）。

ネット上で --persona-xxx の書き方を見かけたら、v3の情報だと判断してください。以前v3を入れていた方は、~/.claude/CLAUDE.md に古い @import が残っていないか一度確認しておくと安心です。

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

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

v4.3.0の公式の数え方は、コマンド30・エージェント20・モード7・MCPサーバー8です。 以前は「コマンド21」「エージェント14〜16」などと書かれていましたが、v4.3.0で数え方が統一されました。

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

公式READMEでは用途別に8分類されています。/sc と打つと全コマンドの一覧が出ます。

迷ったら /sc:recommend に「やりたいこと」を渡すと、合うコマンドを提案してくれます。よく使うのは /sc:brainstorm（企画初期）、/sc:implement（実装）、/sc:troubleshoot（バグ調査）、/sc:research（調査）の4つです。

コマンドの仕組みそのものを知りたい方は、Claude Code スラッシュコマンドの作り方も参考になります。

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

v3で「ペルソナ」と呼ばれていたものは、v4からClaude Codeのサブエージェントとして配られています。@agent-名前 で呼び出します。

呼び出し方は2通りです。

1. 手動で指定する: @agent-security-engineer "認証まわりの実装をレビューして" のように名前を書く
2. コマンドに任せる: /sc:implement "JWT認証" のように頼むと、コマンドファイル内の指示に従って security-engineer などが選ばれる

2つ目の「自動」は、指示書の上での振り分けです。毎回必ず同じエージェントが選ばれる保証はないので、確実に特定の観点で見てほしいときは手動で指定するのが確実です。サブエージェント自体の仕組みはClaude Code サブエージェントの使い方で詳しく解説しています。

7つの振る舞いモード

Token Efficiencyモードについて、公式は「トークンを30〜50%削減」と書いていますが、測定条件は公開されておらず、第三者の検証も見つかりませんでした。また、v4.3のpipx版ではモード定義ファイルが ~/.claude/ に置かれません。フラグを付ければClaudeはそれらしく振る舞いますが、v3時代と同じ精度で働くかは環境ごとに確かめてください。

よく使うフラグ

8つのMCPサーバー（任意）

v4.2.0以降は、これらをまとめて扱うAIRIS MCP Gateway（Docker必須）も選択肢として表示されます。READMEは「MCPなしでも全機能が動き、MCPありなら2〜3倍速く、トークンは30〜50%減る」と書いていますが、これもプロジェクト側の主張です。MCPの基本はMCPとは、Claude Codeへの追加方法はClaude Code MCP連携ガイドを参照してください。

料金・前提条件

SuperClaude Framework本体は無料ですが、Claude Codeが使える有料プランが必要です。 ClaudeのFreeプランではClaude Codeを使えません。

※金額はClaude公式の料金ページに2026年10月時点で掲載されているものです。料金は変わることがあるため、契約前に公式ページを確認してください。Maxの各段階の詳細はClaude Code料金にまとめています。

このほか、Tavily・Morph・21st.dev（Magic）のMCPを使う場合は各サービスのAPI利用料がかかります。AIRIS MCP Gatewayを使うならDockerの実行環境も必要です。

見落としやすいコスト：常に使うコンテキスト

Claude Codeは、使えるエージェントやスキルの名前と説明を毎回のやり取りのコンテキストに含めます。SuperClaudeはユーザー全体の ~/.claude/agents/ に20個のエージェントを置くため、どのプロジェクトを開いても、その説明文の分だけトークンを使い続けます。コマンド本文（30ファイルで約184KB）は呼び出したときだけ読み込まれます。

実際の増え方は環境で変わるため、導入前と導入後に /context を実行して比べるのが確実です。使用量を抑える工夫はClaude Code コスト最適化ガイドも参考にしてください。

インストール手順（Framework版）

現行READMEが案内しているのは、pipx（推奨）とGitからのインストールの2つです。 迷ったらpipxを選んでください。Python 3.10以上が必要です。

方式1: pipx（推奨）

# pipx が無い場合
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# SuperClaude 本体
pipx install superclaude
superclaude install   # コマンド30個とエージェント20個を ~/.claude/ に配置

superclaude install は、同じ名前のファイルがすでにあると上書きせずにスキップします（上書きしたいときだけ --force）。配置先は --target で変えられます。インストール後はClaude Codeを再起動してください。

方式2: Gitからソースで（開発者向け）

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

install.sh はuvでソースを編集可能な形で入れ、続けて superclaude install を実行するスクリプトです。未リリースの修正（masterに入った不具合修正など）を使いたいときに向いています。Windowsは公式リポジトリのWindows向けガイドに沿って進めてください。

npm版・pip版について

npmの @bifrost_inc/superclaude は最新が4.0.7（2025年8月）で止まっており、v4.3は入りません。古い記事にあるnpmの手順は使わないでください。pip install も可能ですが、新しいmacOS（Homebrew版Python）やDebian系では「externally-managed-environment（PEP 668）」のエラーが出やすいため、pipxか仮想環境（venv）を使うのが無難です。

インストール後の確認

superclaude version          # バージョン確認
superclaude install --list   # 配置されたコンポーネントの確認
superclaude doctor           # 環境の診断

Claude Codeを起動して /sc と打ち、コマンド一覧が出れば導入完了です。

配置先ファイル

MCPサーバーの追加（任意）

superclaude mcp --list                               # 使えるサーバーの一覧
superclaude mcp                                      # 対話形式で選ぶ
superclaude mcp --servers tavily --servers context7  # 指定して追加
superclaude mcp --scope project --dry-run            # 範囲を変える／試しに確認だけ

--scope は local / project / user（既定は user）から選べます。特定のプロジェクトでだけ使いたいなら project にしておくと、他のプロジェクトに影響しません。

アップデート

pipx upgrade superclaude
superclaude install --force

superclaude update も用意されています。--force を付けると同名ファイルを上書きするため、SuperClaudeのエージェントと同じ名前の自作ファイルがある場合は先に退避してください。

アンインストール

v4.3.0には uninstall コマンドがありません。 古い記事にある SuperClaude uninstall は動かないので、手で消します。

# 1. コマンドを削除
rm -rf ~/.claude/commands/sc

# 2. エージェントは名前を確認しながら1つずつ削除（ワイルドカードで消さない）
cd ~/.claude/agents
for f in backend-architect business-panel-experts deep-research-agent deep-research \
  devops-architect frontend-architect learning-guide performance-engineer pm-agent \
  python-expert quality-engineer refactoring-expert repo-index requirements-analyst \
  root-cause-analyst security-engineer self-review socratic-mentor system-architect \
  technical-writer; do
  [ -f "$f.md" ] && rm -i "$f.md"
done

# 3. 本体を削除
pipx uninstall superclaude

# 4. 追加したMCPを外す
claude mcp list
claude mcp remove tavily   # 追加したサーバー名ごとに実行

~/.claude/agents/ には自作のエージェントも入っています。インストール時に同名の自作ファイルがあった場合はスキップされているため、そのファイルはあなたのものです。消す前に中身を確かめてください。

SuperClaude_Plugin（BETA）とは

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

SuperClaude_Pluginは、Claude Code公式のプラグイン機能で入れられる試験版（BETA）です。 本体とは別のリポジトリで、本体の内容を6時間ごとに自動で取り込んでいます。

ややこしいのは、本体READMEが「TypeScriptのプラグイン方式はv5.0で予定（時期は未定）」と別に書いている点です。v5.0の公式プラグイン（superclaude-plugin-marketplace）はまだ使えず、関連するIssue #419も2026年10月時点で未解決です。今入れられるのはBETAのSuperClaude_Pluginだけで、v5.0とは別物と理解しておいてください。

Plugin版のインストール方法

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

実行後にClaude Codeを再起動します。PythonやNode.jsの環境づくりは不要です。

公式は次の点を注意として挙げています。

• BETAであり、本番に関わる重要な作業にはまだ勧めない（"Not recommended for production-critical work yet"）
• pip・pipx・npm・uv版とは併用できない。先にFramework版を外す
• Claude CodeのMCP設定を書き換え、AIRIS MCP Gatewayの設定を自動で追加するので、事前に設定をバックアップする

Framework版とPlugin版の違い

どちらを選ぶか

Framework版からPlugin版に移るときは、~/.claude/commands/sc/ と20個のエージェントファイルを削除し、pipx uninstall superclaude でFramework版を外してから /plugin で入れてください。

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

出典: Claude（Anthropic公式）

基本は「/sc: コマンドで作業の種類を決め、必要に応じて @agent- とフラグで観点と深さを足す」という使い方です。 公式ドキュメントが示す基本の流れは、brainstorm → design → implement → test → document → git です。

基本の流れ

# 1. 企画初期の壁打ち（質問されながら要件を固める）
/sc:brainstorm "社内向けのタスク管理ツールを作りたい"

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

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

# 4. テスト
/sc:test "タスク作成APIの正常系・異常系テスト"

# 5. ドキュメントとコミット
/sc:document "タスクAPIの仕様をREADMEに追記"
/sc:git "変更内容をまとめてコミット"

バグ調査は /sc:troubleshoot "デプロイ後に500エラーが出る（ログを貼る）"、調べものは /sc:research "..." を使います。長い作業を中断するときは /sc:save、再開するときは /sc:load です。

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

セキュリティの観点でレビューしてほしいときの例です。

@agent-security-engineer "auth/login.py のJWT実装を、攻撃の想定を立ててレビューしてください"

フロントエンドの構成を相談したいときの例です。

@agent-frontend-architect "Next.jsのApp Routerで、ログイン後だけ見られるダッシュボードの構成を提案して"

コマンドに頼むと指示書に沿ってエージェントが選ばれることもありますが、毎回同じになるとは限りません。観点を外したくない場面では、名前を書いて呼ぶのが確実です。

フラグの組み合わせ例

/sc:implement "ユーザーログイン" --brainstorm        # 実装前に要件を質問で確認
/sc:analyze --focus security --think-hard           # セキュリティに絞って深めに分析
/sc:improve "src/api/" --uc                         # 出力を短くまとめる
/sc:implement "設定画面" --no-mcp                    # MCPを入れていない環境で使う

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

Token Efficiency モードの使い方

出力を短くしたいときは、コマンドに --uc（または --token-efficient）を付けます。

/sc:improve "src/utils/" --uc

記号を多用した圧縮表現になるので、人が読む報告には向きません。長い作業の途中経過など、要点だけわかればよい場面で使うのがおすすめです。

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

v4.3.0では、インストーラーまわりの安全性が改善されました。 2026年10月時点でもこれが最新リリースです。

• ユーザーが変更できる $SHELL を shell=True で使っていた箇所を、リスト形式の subprocess.run に置き換え（#536）
• ダウンロードしたファイルのSHA-256検証の仕組みを追加（#537）
• 本体へ直接プッシュしていた同期処理を、プルリクエスト経由に変更（#538）
• テストを62本追加

ただし、SHA-256検証は仕組みこそ入ったものの、masterのコードではAIRIS MCP Gatewayの設定ファイルに対する期待ハッシュ値が未設定（None）で、実際の照合はスキップされています。AIRISを使う場合は、外部リポジトリの設定ファイルを照合なしで取得して起動する点を理解したうえで判断してください。

古いバージョンを使っているなら、v4.3.0へ上げておくのが基本です。一方で、4.3.0以降は7か月近くリリースがなく、いくつかの修正はmasterに入ったまま未配布という状態も押さえておきましょう。

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

出典: Anthropic セキュリティ

個人の学習用なら気軽に試してかまいませんが、業務PCに入れるなら「第三者のツールで、外部と通信しうる」前提で確認が必要です。 Claude Code公式のプラグイン安全ガイドも、インストールしたプラグインは「ユーザー権限で任意のコードを実行できる」と注意しています。SuperClaude_Pluginは、公式の区分ではサードパーティのマーケットプレイスです。

また、SuperClaudeのコマンドやエージェントは「指示」でしかありません。Claude Code公式は、CLAUDE.mdなどの指示は強制力のある設定ではなく、確実に止めたい操作にはPreToolUseフックを使うよう説明しています。危ない操作を止める仕組みとしてSuperClaudeに頼らないでください。

チームで使うなら、全員の ~/.claude/ に入れるより、必要なコマンドだけをプロジェクトの .claude/ に置く、MCPは --scope project にするなど、影響範囲を絞る運用が管理しやすくなります。チーム導入全般の進め方はClaude Code チーム導入ガイド、Claude Code自体の安全な設定はClaude Codeのセキュリティと安全な使い方を参考にしてください。

開発チームの効率化から一歩進めて、Claudeなどの新しいモデルを社内の業務システムそのものに組み込みたい場合は、連携の方式によって手間も費用も大きく変わります。具体的な方法と費用の目安は既存システムにAIを組み込む方法で整理しています。

よくあるトラブルと対処法

つまずきやすいのは、MCPまわりとインストール環境の2点です。

他の選択肢との違い

「Claude Codeの振る舞いを整えたい」だけなら、Claude Code標準の機能で足りる場面が増えています。 SuperClaude自身のドキュメント（claude-code-integration.md）も、Skillsやフックの活用は「大きな差がある（Large gap）」と認めています。Claude Code側ではカスタムコマンドがスキルに統合され、新しく作るならスキルが推奨される流れです。

選び方の目安は次のとおりです。

• SuperClaudeのような型がどう役立つか試したい → SuperClaude Framework（pipx） を入れて /context と使い心地を確認
• 使ってみて、よく使うのが数コマンドだけ → その部分を参考にSkillsやサブエージェントを自作して外す
• 社内で配る・統制したい → Skills＋プロジェクト単位の設定＋managed settings
• 確実に止めたい操作がある → Hooks

標準機能の詳細はClaude Code Skills 使い方完全ガイド、Claude Code Hooks 使い方、使い分けはSkills vs Hooks 使い分け、CLAUDE.mdはCLAUDE.md 書き方 ベストプラクティスで解説しています。同じ系統のOSSはSuperpowers for Claude Code 使い方、Everything Claude Codeとは、awesome-claude-codeの使い方で比べられます。

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

こんな方におすすめ

• Claude Codeを個人で使い込んでいて、作業の型をまとめて試したいエンジニア
• /sc:brainstorm → /sc:implement → /sc:test のように、決まった流れで進めたい人
• 観点ごとにエージェントを呼び分けて、レビューの抜けを減らしたい人
• 中身のMarkdownを読んで、自分用に削ったり書き換えたりするのが苦でない人
• Skillsやサブエージェントを自作する前に、完成例を参考にしたい人

おすすめしない方

• Anthropicの公式サポートがあるツールしか使えない業務環境
• MCPを通じてコードを外部サービスへ送ることが社内規定で禁止されている環境
• ~/.claude/agents/ に自作のエージェントを多く置いていて、管理が混ざると困る人
• コンテキストの消費を最小限にしたい人（全プロジェクトで常に説明文の分を使う）
• 頻繁なアップデートや手厚いメンテナンスを求める人（2026年3月以降リリースなし）
• Claude Codeにまだ慣れていない初心者（まずClaude Codeの使い方で標準機能に慣れるのがおすすめ）

よくある質問（FAQ）

Q1. Proプラン（月$20）でも使えますか？

使えます。Claude Codeが使えるプランなら動きます。ただしエージェントの説明文が毎回コンテキストに入り、--ultrathink のように深く考えさせるフラグはトークンを多く使うため、Proでは使用量の上限に早く届くことがあります。

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

いいえ。SuperClaude-Orgというコミュニティのプロジェクトで、READMEにも「Anthropicと提携しておらず、承認も受けていない」と明記されています。「SuperClaude」という名前の別プロジェクトもあるため、入れるときは SuperClaude-Org/SuperClaude_Framework かどうかを確認してください。

Q3. 自分で書いた CLAUDE.md や自作エージェントは消えますか？

v4.3.0のpipx版は CLAUDE.md を編集しません。エージェントは同名ファイルがあればスキップされます。消えたり上書きされたりするのは --force を付けたときです。以前v3を入れていた場合は、当時の @import が CLAUDE.md に残っている可能性があります。

Q4. MCPサーバーは入れないといけませんか？

必須ではありません。ただし一部のコマンドはSequentialやContext7を前提に書かれているため、MCPを入れないなら --no-mcp を付けると動きが安定します。入れるなら、まずAPIキー不要のContext7から試すのが手軽です。

Q5. コマンド数やエージェント数が記事によって違うのはなぜ？

数え方とバージョンの違いです。v4.3.0で「コマンド21→30、エージェント14/16→20、モード6→7、MCP 6→8」と公式の数え方が統一されました。Plugin版の説明文は「29コマンド・23エージェント」で、本体の数え方とも一致していません。

Q6. 日本語で使えますか？

使えます。指示は日本語で書いてかまいません。公式リポジトリには日本語のREADME（README-ja.md）と日本語のユーザーガイドもあります。ただし4.3.0で、pm-agentの日本語の呼び出しキーワードは英語に置き換えられています。

Q7. Cursor や Codex でも使えますか？

公式が対象としているのはClaude Codeだけです。中身はMarkdownなので内容を参考にすることはできますが、他ツールでの動作は公式にはうたわれていません。

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

情シス・セキュリティ担当への確認を前提にしてください。特に、どのMCPを有効にするか（データが外部へ送られるか）と、Plugin版を使うかどうかが判断の分かれ目です。迷うなら、MCPなしのFramework版をプロジェクト単位で試すところから始めると影響を抑えられます。

Q9. v5.0 はいつ出ますか？

2026年10月時点で時期は発表されていません。READMEは「TypeScriptのプラグイン方式をv5.0で予定」とだけ書いており、関連するIssue #419も未解決のままです。

まとめ

• SuperClaude Frameworkは、Claude Codeに /sc: コマンド30個とエージェント20個を足す無料のOSS。中身はMarkdownの指示書で、モデル性能を上げるものではない
• 2026年10月時点の最新はv4.3.0（3月22日）。GitHubスターは約2.4万だが、それ以降リリースはない
• v4.3のpipx版は ~/.claude/commands/sc/ と ~/.claude/agents/ に配置するだけで、CLAUDE.md は編集しない。--persona-xxx はv3の書き方
• インストールは pipx install superclaude → superclaude install が基本。npm版は4.0.7で止まっている
• アンインストールコマンドはないので、コマンドフォルダとエージェント20個を手で消し、pipx uninstall superclaude を実行する
• Plugin版（BETA）は手軽だが、Framework版と併用できず、MCP設定を書き換える。v5.0の公式プラグインとは別物
• 全プロジェクトでエージェントの説明文分のコンテキストを使うので、導入前後に /context で確認する
• 業務で使うなら、MCPへのデータ送信、AIRISのハッシュ未照合、サードパーティ扱いであることを確認し、確実に止めたい操作はHooksで守る

Claude Codeの全体像はClaude Codeとは、並列で複数のエージェントを動かす方法はClaude Code Agent Teamsの使い方もあわせて参考にしてください。