【詳細版】Super Claude 上級者向けコマンドガイド

はじめに

非エンジニアの方やバイブコーディングのみで
専門用語が苦手な初心者の方はこちらの記事からご覧ください。

SuperClaudeとは？

SuperClaudeは、Claude Codeをより強力にするための設定フレームワークです。19個の専門コマンド、9つの認知ペルソナ、高度なMCP統合、エビデンスベースの方法論を提供します。

バージョン: v2.0.1

目次

• インストール方法
• クイックスタート
• 基本的な使い方
• ユニバーサルフラグ（すべてのコマンドで使用可能）
• 9つの認知ペルソナ
• コマンド詳細リファレンス
• 実践的なワークフロー
• 初心者向けのコツ

---

インストール方法

前提条件

• Bash バージョン 3以上
• Git
• Claude Code
• 約50MBの空き容量

基本インストール

# GitHubからクローン
git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude

# 基本インストール（デフォルト: ~/.claude/）
./install.sh

# 高度なオプション
./install.sh --dir /opt/claude    # カスタムディレクトリにインストール
./install.sh --update             # 既存のインストールを更新
./install.sh --dry-run --verbose  # インストールのプレビュー

⚠️ 重要な注意事項

SuperClaudeにはMCPサーバーは含まれていません。MCPフラグ（--c7、--seq、--magic、--pup）を使用するには、Claude CodeのMCP設定で別途インストールする必要があります。

---

🚀 クイックスタート

最初に試すべきコマンド

# 1. プロジェクトのコンテキストを読み込む
/load

# 2. コードを分析してみる  
/analyze --code --think

# 3. アーキテクチャ分析を専門家モードで
/analyze --architecture --persona-architect

基本的なワークフロー例

# APIの設計から実装まで
/design --api --ddd                      # アーキテクチャ設計
/build --feature --tdd                   # 実装
/test --coverage --e2e                   # 品質保証  
/deploy --env staging --plan             # デプロイ計画

---

基本的な使い方

コマンドの書き方

/コマンド名 [フラグ] [引数]

実例

/review --files src/ --quality --evidence    # エビデンス付きコードレビュー
/analyze --code --persona-architect          # アーキテクト視点でコード分析
/build --react --magic --tdd                # AI機能付きReactアプリ構築
/troubleshoot --prod --five-whys --seq      # 本番環境の問題を論理的に解決
/task:create "ユーザー認証を追加"            # 複雑な機能の作成と管理
/deploy --env prod --plan --validate        # 安全な本番デプロイ

---

ユニバーサルフラグ（すべてのコマンドで使用可能）

🧠 思考の深さ制御

フラグ	説明	トークン使用量
--think	複数ファイルの分析、拡張コンテキスト	約4Kトークン
--think-hard	アーキテクチャレベルの深い分析	約10Kトークン
--ultrathink	最大深度でのクリティカルなシステム分析	約32Kトークン

📦 トークン最適化

フラグ	エイリアス	説明
--uc	--ultracompressed	UltraCompressedモード（大幅なトークン削減）

🔧 MCPサーバー制御

フラグ	説明
--c7	Context7ドキュメント検索を有効化
--seq	Sequential論理的思考分析を有効化
--magic	Magic UIコンポーネント生成を有効化
--pup	Puppeteerブラウザ自動化を有効化
--all-mcp	すべてのMCPサーバーを有効化
--no-mcp	すべてのMCPサーバーを無効化（ネイティブツールのみ）

🔍 分析と内省

フラグ	説明
--introspect	自己認識分析を有効化（認知の透明性）

📋 計画と実行

フラグ	説明
--plan	実行前に詳細な実行計画を表示
--dry-run	実行せずに変更をプレビュー
--watch	リアルタイムフィードバックで継続的監視
--interactive	ステップバイステップのガイド付きプロセス
--force	安全チェックを上書き（注意して使用）

✅ 品質と検証

フラグ	説明
--validate	実行前の強化された安全チェック
--security	セキュリティ重視の分析と検証
--coverage	包括的なカバレッジ分析を生成
--strict	強化された検証付きゼロトレランスモード

---

9つの認知ペルソナ

すべてのペルソナはフラグとして統合され、どのコマンドでも使用できます：

ペルソナフラグ	専門分野	最適な用途
--persona-architect	システム思考、スケーラビリティ、パターン	アーキテクチャ決定、システム設計
--persona-frontend	UI/UX重視、アクセシビリティ優先	ユーザーインターフェース、コンポーネント設計
--persona-backend	API、データベース、信頼性	サーバーアーキテクチャ、データモデリング
--persona-analyzer	根本原因分析、エビデンスベース	複雑なデバッグ、調査
--persona-security	脅威モデリング、ゼロトラスト、OWASP	セキュリティ監査、脆弱性評価
--persona-mentor	教育、ガイド付き学習、明確性	ドキュメント、知識移転
--persona-refactorer	コード品質、保守性	コードクリーンアップ、技術的負債
--persona-performance	最適化、プロファイリング、効率性	パフォーマンスチューニング、ボトルネック
--persona-qa	テスト、エッジケース、検証	品質保証、テストカバレッジ

---

コマンド詳細リファレンス

🛠️ 開発コマンド（3個）

/build - ユニバーサルプロジェクトビルダー

モダンスタックテンプレートを使用してプロジェクト、機能、コンポーネントを構築します。

コマンド専用フラグ：

• --init - スタックセットアップで新規プロジェクトを初期化
• --feature - 既存パターンを使用して機能を実装
• --tdd - テスト駆動開発ワークフロー
• --react - React（Vite、TypeScript、Router）
• --api - Express.js API（TypeScript）
• --fullstack - 完全なReact + Node.js + Docker
• --mobile - React Native（Expo）
• --cli - Commander.js CLI（テスト付き）

例：

/build --init --react --magic --tdd         # AI機能付き新規Reactアプリ
/build --feature "認証システム" --tdd        # テスト付き機能実装
/build --api --openapi --seq                # ドキュメント付きAPI

/dev-setup - 開発環境

CI/CDとモニタリングを備えたプロフェッショナルな開発環境を構成します。

コマンド専用フラグ：

• --install - 依存関係のインストールと設定
• --ci - CI/CDパイプライン設定
• --monitor - モニタリングと可観測性セットアップ
• --docker - コンテナ化セットアップ
• --testing - テストインフラストラクチャ
• --team - チームコラボレーションツール
• --standards - コード品質基準

例：

/dev-setup --install --ci --monitor         # 完全な環境
/dev-setup --team --standards --docs        # チームセットアップ

/test - 包括的テストフレームワーク

スタック全体でテスト戦略を作成、実行、保守します。

コマンド専用フラグ：

• --e2e - エンドツーエンドテスト
• --integration - 統合テスト
• --unit - ユニットテスト
• --visual - ビジュアル回帰テスト
• --mutation - ミューテーションテスト
• --performance - パフォーマンステスト
• --accessibility - アクセシビリティテスト
• --parallel - 並列テスト実行

例：

/test --coverage --e2e --pup               # フルテストスイート
/test --mutation --strict                  # テスト品質検証

🔍 分析・改善コマンド（5個）

/review - AI駆動コードレビュー

エビデンスベースの推奨事項を含む包括的なコードレビューと品質分析。

コマンド専用フラグ：

• --files - 特定のファイルまたはディレクトリをレビュー
• --commit - 指定されたコミットの変更をレビュー（HEAD、ハッシュ、範囲）
• --pr - プルリクエストの変更をレビュー（git diff main..branch）
• --quality - コード品質の問題に焦点（DRY、SOLID、複雑性）
• --evidence - すべての提案のソースとドキュメントを含む
• --fix - 特定された問題の具体的な修正を提案
• --summary - レビュー結果の要約を生成

例：

/review --files src/auth.ts --persona-security    # セキュリティ重視のファイルレビュー
/review --commit HEAD --quality --evidence        # ソース付き品質レビュー
/review --pr 123 --all --interactive             # 包括的なPRレビュー
/review --files src/ --persona-performance --think # パフォーマンス分析

/analyze - 多次元分析

コード、アーキテクチャ、パフォーマンス、セキュリティの包括的な分析。

コマンド専用フラグ：

• --code - コード品質分析
• --architecture - システム設計評価
• --profile - パフォーマンスプロファイリング
• --deps - 依存関係分析
• --surface - クイック概要
• --deep - 包括的分析
• --forensic - 詳細調査

例：

/analyze --code --architecture --seq       # フル分析
/analyze --profile --deep --persona-performance  # パフォーマンス深掘り

/troubleshoot - プロフェッショナルデバッグ

体系的なデバッグと問題解決。

コマンド専用フラグ：

• --investigate - 体系的な問題分析
• --five-whys - 根本原因分析
• --prod - 本番環境デバッグ
• --perf - パフォーマンス調査
• --fix - 完全な解決
• --hotfix - 緊急修正
• --rollback - 安全なロールバック

例：

/troubleshoot --prod --five-whys --seq    # 本番環境RCA
/troubleshoot --perf --fix --pup          # パフォーマンス修正

/improve - 改善と最適化

測定可能な成果を伴うエビデンスベースの改善。

コマンド専用フラグ：

• --quality - コード構造の改善
• --performance - パフォーマンス最適化
• --accessibility - アクセシビリティ改善
• --iterate - 反復的改善
• --threshold - 品質目標パーセンテージ
• --refactor - 体系的リファクタリング
• --modernize - 技術アップデート

例：

/improve --quality --iterate --threshold 95%    # 品質改善
/improve --performance --cache --pup            # パフォーマンス向上

/explain - 技術文書

包括的な説明とドキュメントを生成。

コマンド専用フラグ：

• --depth - 複雑性レベル（ELI5|beginner|intermediate|expert）
• --visual - 図を含める
• --examples - コード例
• --api - APIドキュメント
• --architecture - システムドキュメント
• --tutorial - 学習チュートリアル
• --reference - リファレンスドキュメント

例：

/explain --depth expert --visual --seq     # エキスパートドキュメント
/explain --api --examples --c7             # 例付きAPIドキュメント

⚙️ 運用コマンド（6個）

/deploy - アプリケーションデプロイ

ロールバック機能付きの安全なデプロイメント。

コマンド専用フラグ：

• --env - ターゲット環境（dev|staging|prod）
• --canary - カナリアデプロイメント
• --blue-green - ブルーグリーンデプロイメント
• --rolling - ローリングデプロイメント
• --checkpoint - チェックポイント作成
• --rollback - 前バージョンへロールバック
• --monitor - デプロイ後モニタリング

例：

/deploy --env prod --canary --monitor      # カナリア本番デプロイ
/deploy --rollback --env prod              # 緊急ロールバック

/migrate - データベース・コード移行

ロールバック機能付きの安全な移行。

コマンド専用フラグ：

• --database - データベース移行
• --code - コード移行
• --config - 設定移行
• --dependencies - 依存関係アップデート
• --backup - 最初にバックアップ作成
• --rollback - 移行をロールバック
• --validate - データ整合性チェック

例：

/migrate --database --backup --validate    # 安全なDB移行
/migrate --code --dry-run                  # コード変更のプレビュー

/scan - セキュリティと検証

包括的なセキュリティ監査とコンプライアンス。

コマンド専用フラグ：

• --owasp - OWASP Top 10コンプライアンス
• --secrets - シークレット検出
• --compliance - 規制コンプライアンス
• --quality - コード品質検証
• --automated - 継続的モニタリング

例：

/scan --security --owasp --deps           # セキュリティ監査
/scan --compliance --gdpr --strict        # コンプライアンスチェック

/estimate - プロジェクト見積もり

リスク評価を含むプロフェッショナルな見積もり。

コマンド専用フラグ：

• --detailed - 包括的な内訳
• --rough - クイック見積もり
• --worst-case - 悲観的見積もり
• --agile - ストーリーポイント見積もり
• --complexity - 技術的評価
• --resources - リソース計画
• --timeline - タイムライン計画
• --risk - リスク評価

例：

/estimate --detailed --complexity --risk   # フル見積もり
/estimate --agile --story-points          # アジャイル計画

/cleanup - プロジェクトメンテナンス

安全性検証付きのプロフェッショナルなクリーンアップ。

コマンド専用フラグ：

• --code - デッドコード削除
• --files - ビルド成果物のクリーン
• --deps - 未使用の依存関係削除
• --git - gitリポジトリクリーン
• --all - 包括的クリーンアップ
• --aggressive - 深いクリーンアップ
• --conservative - 安全なクリーンアップ

例：

/cleanup --all --dry-run                  # クリーンアッププレビュー
/cleanup --code --deps --validate         # コードクリーンアップ

/git - Gitワークフロー管理

安全機能付きのプロフェッショナルなGit操作。

コマンド専用フラグ：

• --status - リポジトリステータス
• --commit - プロフェッショナルコミット
• --branch - ブランチ管理
• --sync - リモート同期
• --checkpoint - チェックポイント作成
• --merge - スマートマージ
• --history - 履歴分析
• --pre-commit - pre-commitフックのセットアップと実行

例：

/git --checkpoint "リファクタリング前"       # 安全チェックポイント
/git --commit --validate --test          # 安全なコミット
/git --pre-commit                        # pre-commitフックセットアップ
/git --commit --pre-commit               # 検証付きコミット

🎨 設計・アーキテクチャコマンド（1個）

/design - システムアーキテクチャ

仕様を含むプロフェッショナルなシステム設計。

コマンド専用フラグ：

• --api - REST/GraphQL設計
• --ddd - ドメイン駆動設計
• --microservices - マイクロサービスアーキテクチャ
• --event-driven - イベントパターン
• --openapi - OpenAPI仕様
• --graphql - GraphQLスキーマ
• --bounded-context - DDDコンテキスト
• --integration - 統合パターン

例：

/design --api --ddd --openapi --seq      # DDD付きAPI
/design --microservices --event-driven   # マイクロサービス設計

🔄 ワークフローコマンド（4個）

/spawn - 専門エージェント

並列タスク用の専門エージェントを生成。

コマンド専用フラグ：

• --task - 特定タスクを定義
• --parallel - 並行実行
• --specialized - ドメイン専門知識
• --collaborative - マルチエージェント作業
• --sync - 結果を同期
• --merge - 出力をマージ

例：

/spawn --task "フロントエンドテスト" --parallel  # 並列テスト
/spawn --collaborative --sync              # チームシミュレーション

/document - ドキュメント作成

複数形式のプロフェッショナルドキュメント。

コマンド専用フラグ：

• --user - ユーザーガイド
• --technical - 開発者向けドキュメント
• --markdown - Markdown形式
• --interactive - インタラクティブドキュメント
• --multilingual - 多言語
• --maintain - メンテナンス計画

例：

/document --api --interactive --examples   # APIドキュメント
/document --user --visual --multilingual   # ユーザーガイド

/load - プロジェクトコンテキスト読み込み

プロジェクトコンテキストの読み込みと分析。

コマンド専用フラグ：

• --depth - 分析深度（shallow|normal|deep）
• --context - コンテキスト保持
• --patterns - パターン認識
• --relationships - 依存関係マッピング
• --structure - プロジェクト構造
• --health - プロジェクトヘルス
• --standards - コーディング標準

例：

/load --depth deep --patterns --seq       # 深い分析
/load --structure --health --standards   # プロジェクト評価

/task - タスク管理

自動分解と復旧機能付きの複雑な機能管理。

コマンド専用操作：

• /task:create [説明] - 自動分解付きで新規タスク作成
• /task:status [task-id] - タスクステータスと進捗確認
• /task:resume [task-id] - 休憩後に作業再開
• /task:update [task-id] [更新内容] - タスク進捗と要件を更新
• /task:complete [task-id] - サマリー付きでタスク完了

主な機能：

• スマート分解: 自動的な複雑性分析とサブタスク作成
• コンテキスト保持: セッション間で作業状態を保存
• 進捗追跡: 自動更新とブロッカー検出
• セッション復旧: 完全なコンテキストでチェックポイントから再開

例：

/task:create "OAuth 2.0認証システムの実装"  # 複雑な機能作成
/task:status oauth-task-id                   # 進捗確認
/task:resume oauth-task-id                   # 休憩後に再開
/task:update oauth-task-id "ライブラリ競合発見"  # 発見事項で更新
/task:complete oauth-task-id                 # サマリー付きで完了

---

実践的なワークフロー

🚀 プロフェッショナルワークフロー

フルスタック開発

/design --api --ddd --persona-architect
/build --fullstack --tdd --magic
/test --coverage --e2e --pup
/deploy --env staging --validate

セキュリティファースト開発

/scan --security --owasp --deps --persona-security
/analyze --security --forensic --seq
/improve --security --validate --strict
/test --security --coverage

パフォーマンス最適化

/analyze --profile --deep --persona-performance
/troubleshoot --perf --investigate --pup
/improve --performance --iterate --threshold 90%
/test --performance --load

品質保証

/review --quality --evidence --persona-qa
/improve --quality --refactor --strict
/scan --validate --quality
/test --coverage --mutation

---

💡 初心者向けのコツ

1. 基本的な使い方

最初に覚えるべきコマンド

/load                    # プロジェクトを理解する
/analyze --code --think  # 現状を分析する
/build --feature         # 機能を実装する
/test --coverage         # テストする
/review --quality        # レビューする

安全に使うために

# リスクの高い操作は必ず検証
/deploy --env prod --validate --plan
/migrate --database --dry-run --backup

# エラーが出たら原因調査
/troubleshoot --introspect

2. フラグの組み合わせ

トークンを節約したいとき

/analyze --architecture --uc              # 圧縮モードで分析
/build --react --no-mcp                  # MCPサーバーなし

深い分析が必要なとき

/troubleshoot --investigate --think       # 拡張思考で調査
/design --microservices --think-hard     # 深い設計分析
/analyze --architecture --ultrathink     # 最大深度の分析

3. ペルソナの活用

専門的な視点が必要なとき

/analyze --architecture --persona-architect   # アーキテクト視点
/scan --security --persona-security          # セキュリティ専門家視点
/improve --performance --persona-performance  # パフォーマンス専門家視点

4. 効率的な開発フロー

朝一番のルーティン

/load                                    # プロジェクトコンテキスト読み込み
/analyze --code --think                  # 現状分析
/task:status                            # タスク確認

新機能開発の流れ

# 1. タスク作成と設計
/task:create "ユーザー認証システムの実装"
/design --api --ddd --persona-architect

# 2. 実装とテスト
/build --feature --tdd
/test --coverage --e2e

# 3. レビューとデプロイ
/review --quality --evidence
/deploy --env staging --validate

5. よくある質問と対処法

Q: どのペルソナを使えばいいか分からない
A: 迷ったら--seq（論理的思考）を追加。タスクに応じて：

• 設計なら--persona-architect
• バグなら--persona-analyzer
• 最適化なら--persona-performance

Q: トークンを使いすぎてしまう
A: --ucフラグで70%削減。さらに：

• --no-mcpでMCPサーバーを無効化
• 必要最小限のフラグだけ使用

Q: エラーが出て何をすればいいか分からない
A: まず/troubleshoot --introspectで原因調査。それでも分からなければ：

• /analyze --code --thinkで問題箇所を特定
• /explain --depth beginnerで理解を深める
• /troubleshoot --investigate --seqで段階的に解決

6. ベストプラクティス

高リスク操作の鉄則

• 必ず--validateか--dry-runを使用
• 本番環境では--planで計画確認
• 重要な変更前は/git --checkpoint

効率的なMCPサーバー使用

• ドキュメント参照が必要 → --c7
• 複雑な推論が必要 → --seq
• UI開発 → --magic
• ブラウザテスト → --pup
• すべて必要 → --all-mcp

トークン節約のクイックリファレンス

• 標準モード: /build --react --magic
• 圧縮モード: /analyze --architecture --uc
• ネイティブのみ: /scan --security --no-mcp

---

トラブルシューティング

よくある問題と解決策

コマンドが動かない

1. スペルミスをチェック

   # ❌ 間違い
   /buid --react
   
   # ✅ 正しい
   /build --react
   

2. 必要な引数を確認

   # ❌ 引数不足
   /deploy --env
   
   # ✅ 正しい
   /deploy --env prod
   

3. MCPサーバーの確認

   # MCPサーバーが必要なフラグを使っている場合
   # Claude CodeのMCP設定でインストールされているか確認
   

パフォーマンスの問題

• --ucフラグを追加してトークン使用量を削減
• 不要なフラグを削除
• --thinkの代わりに通常モードを使用

エラーメッセージの対処

• Permission denied → 権限を確認
• Command not found → SuperClaudeが正しくインストールされているか確認
• Invalid flag → フラグの組み合わせを確認

---

上級者向けTips

複雑なタスクの分解

# 大きなタスクを作成
/task:create "マイクロサービスアーキテクチャへの移行"

# 自動的にサブタスクに分解され、段階的に実行可能
/task:status migration-task-id

カスタムワークフローの作成

# 自分用のワークフローを定義
# 例：朝のコードレビュールーティン
/load --depth deep
/git --status
/review --commit HEAD~5..HEAD --quality --evidence
/test --coverage

パフォーマンスチューニング

# 段階的な最適化アプローチ
/analyze --profile --surface              # まず概要を把握
/analyze --profile --deep --think-hard    # 深い分析
/improve --performance --threshold 80%    # 80%を目標に改善
/test --performance --load               # 負荷テストで確認

---

まとめ

SuperClaudeは強力な開発支援ツールです。このガイドで紹介した内容を実践することで：

1. 効率的な開発 - 適切なコマンドとフラグの組み合わせ
2. 安全な操作 - --validateと--dry-runの活用
3. 専門的な視点 - 9つのペルソナの使い分け
4. トークン節約 - --ucフラグとMCP制御

最初は基本的なコマンドから始めて、徐々に高度な機能を使いこなしていきましょう。

覚えておくべき黄金ルール

• 🔒 高リスク操作には必ず--validateまたは--dry-run
• 📚 ドキュメントタスクには--c7でライブラリ検索
• 🧠 複雑な分析には--seqで論理的推論
• 🎨 UI開発には--magicでAIコンポーネント
• 🧪 テストには--pupでブラウザ自動化
• 💰 トークン節約には--ucで70%削減

頑張ってSuperClaudeを使いこなしてください！🌟

---