Claude Codeを強化。SuperClaudeのインストール完全ガイド

1. はじめに

SuperClaudeは、Claude Codeの機能を約70%拡張するフレームワークです。MCP（Model Context Protocol）サーバーの統合、特殊なAIエージェント、カスタムコマンドなど、開発者の生産性を劇的に向上させる機能を提供します。

Ubuntu 22.04環境でSuperClaudeをゼロからインストールしたので、その手順を記録します。

2. SuperClaudeとは

SuperClaudeは、Claude Codeの機能を拡張するオープンソースのフレームワークです。主な特徴として以下があります。

• MCPサーバー統合 - 公式ドキュメント検索、テスト自動化、コード解析などの専門機能
• AIエージェント - 14種類の特化型AIエージェントによるタスク自動化
• カスタムコマンド - スラッシュコマンドで高度な操作する
• 動作モード - ブレインストーミング、内省、タスク管理など用途別の最適化モード

3. 前提条件

インストールを始める前に、以下の環境が必要です。

• OS - Linux（Ubuntu推奨）、macOS、またはWindows（WSL2）
• Python - 3.8以上
• pipx - Pythonアプリケーションの独立環境管理ツール
• Claude Code - アクティブなサブスクリプション

4. インストール手順

4.1. pipxの準備

まず、pipxがインストールされているか確認します。

pipx --version
1.0.0

pipxがない場合は、以下のようにaptでインストールできます。

sudo apt update
sudo apt install -y pipx
pipx --version

4.2. SuperClaudeのインストール

pipxを使ってSuperClaudeをインストールします。

pipx install SuperClaude

実行結果：

installed package superclaude 4.0.8, installed using Python 3.10.12
These apps are now globally available
  - SuperClaude
  - superclaude。

4.3. PATHの設定

インストール後、PATHの設定が必要なことがあります。私はPATHが通ってなかったので、以下を実施しました。

pipx ensurepath
source ~/.bashrc
hash -r

これにより、SuperClaudeコマンドがシステム全体で利用可能になります。

補足：コマンドの意味

source ~/.bashrc

• 意味：現在のシェル（bash）で、~/.bashrc の内容をその場で実行して読み込み直す（新しいターミナルを開き直さずに設定反映）。
• よくある用途：PATH を追記した直後に反映したいときなど。

hash -r

• 意味：bash が覚えているコマンドのフルパスのキャッシュをリセット（再探索させる）。
• よくある用途：新しくコマンドをインストールした／PATHを変えたのに、古い場所を見に行ってしまうときに実行。

4.4. インストールの確認

正しくインストールされたか確認します。

SuperClaude --version
SuperClaude 4.0.8

5. 初期セットアップ

5.1. SuperClaudeの設定開始

インストールが完了したら、設定を開始します。

SuperClaude install

5.2. Stage 1: MCPサーバーの選択

SuperClaudeは複数のMCPサーバーを提供しています。各サーバーは特定の機能に特化しています。

Select MCP servers to configure:
================================
 1. [ ] context7 - Official library documentation and code examples
 2. [ ] sequential - Multi-step problem solving and systematic analysis
 3. [ ] magic - Modern UI component generation and design systems (requires API key)
 4. [ ] playwright - Cross-browser E2E testing and automation
 5. [ ] serena - Semantic code analysis and intelligent editing
 6. [ ] morphllm - Fast Apply capability for context-aware code modifications (requires API key)

すべてインストールする場合はallと入力します。

5.2.1. MCPサーバーの詳細

5.3. APIキーの設定

一部のサーバーはAPIキーが必要です。後から設定もできます。

[API KEY] magic requires: TWENTYFIRST_API_KEY
Enter TWENTYFIRST_API_KEY: [Enterでスキップ]

[API KEY] morphllm-fast-apply requires: MORPH_API_KEY
Enter MORPH_API_KEY: [Enterでスキップ]

5.4. Stage 2: フレームワークコンポーネントの選択

次に、SuperClaudeの基本コンポーネントを選択します。

Select components (Core is recommended):
========================================
 1. [ ] core - SuperClaude framework documentation and core files
 2. [ ] modes - SuperClaude behavioral modes
 3. [ ] commands - SuperClaude slash command definitions
 4. [ ] agents - 14 specialized AI agents
 5. [ ] mcp_docs - MCP documentation (auto-selected)

1（core）がおすすめされているので、1を選択します。

5.5. インストールの実行

設定内容を確認して、インストールを実行します。

Installation Plan
==================================================
Installation Directory: /home/yamadatt/.claude
Components to install:
  1. core - SuperClaude framework documentation and core files
  2. mcp_docs - MCP server documentation and usage guides
  3. mcp - MCP server configuration management via .claude.json

Estimated size: 45.3 KB

Proceed with installation? [Y/n]
> y

6. インストール完了後の確認

インストールが成功すると、以下のような出力が表示されます。

[✓] Installation completed successfully in 6.8 seconds
[INFO] Installed components: mcp_docs, mcp, core
[INFO] Backup created: /home/yamadatt/.claude/backups/superclaude_backup_20250824_184649.tar.gz
[✓] SuperClaude installation completed successfully!

Next steps:
1. Restart your Claude Code session
2. Framework files are now available in /home/yamadatt/.claude
3. Use SuperClaude commands and features in Claude Code

6.1. ファイル構造

インストール後、~/.claudeディレクトリに以下のような構造が作成されます。

~/.claude/
├── CLAUDE.md           # プロジェクト設定
├── .claude.json        # MCPサーバー設定
├── core/              # コアフレームワーク
├── mcp_docs/          # MCPドキュメント
└── backups/           # バックアップファイル

7. Claude Codeでの使用方法

7.1. Claude Codeの再起動

インストール後、Claude Codeセッションを再起動します。

私の場合、複数のターミナルを全て閉じてから新規ターミナルを起動することで、Super Claudeの起動を確認できました。

7.2. 機能の確認

Claude Codeで以下のコマンドを試してみましょう。

/help              # ヘルプの表示
/list-mcp          # 利用可能なMCPサーバー一覧
/search docs react # ドキュメント検索

7.3. MCPサーバーの活用例

7.3.1. context7でドキュメント検索

「ReactのuseStateについて説明して」と聞くと、
context7が公式ドキュメントから正確な情報を取得

7.3.2. playwrightでE2Eテスト

「このウェブアプリのE2Eテストを書いて」と依頼すると、
playwrightサーバーが自動的にテストコードを生成

8. トラブルシューティング

8.1. コマンドが見つからない場合

# PATHを再読み込み
source ~/.bashrc
hash -r

# 直接実行
~/.local/bin/SuperClaude --version

8.2. APIキーの後からの設定

# 環境変数として設定
$ export TWENTYFIRST_API_KEY="your-api-key"
$ export MORPH_API_KEY="your-api-key"

# または~/.bashrcに追加
$ echo 'export TWENTYFIRST_API_KEY="your-api-key"' >> ~/.bashrc

8.3. アンインストール方法

$ pipx uninstall SuperClaude
$ rm -rf ~/.claude

9. 高度な設定

9.1. カスタムMCPサーバーの追加

~/.claude/.claude.jsonを編集して、独自のMCPサーバーを追加できます。

{
  "mcpServers": {
    "my-custom-server": {
      "command": "node",
      "args": ["/path/to/custom-server.js"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

9.2. モードの切り替え

SuperClaudeは用途に応じて動作モードを切り替えられます。

• Brainstorming Mode - アイデア出しに特化
• Introspection Mode - 深い分析と検討
• Task Management Mode - タスクをレスポンス時間50%短縮で管理
• Token Efficiency Mode - トークン使用量の最適化

10. まとめ

SuperClaudeのインストールにより、Claude Codeの機能が約70%拡張されます。MCPサーバーによる専門機能、AIエージェントによる自動化、カスタムコマンドによる効率化など、開発体験が劇的に向上します。

特に以下のような場面で威力を発揮します。

• 📚 公式ドキュメントを参照しながらのコーディング
• 🧪 自動テストの作成と実行
• 🔍 大規模コードベースの解析とリファクタリング
• 🎨 UIコンポーネントの自動生成
• 🤖 反復作業の自動化

11. 参考リンク

• SuperClaude公式リポジトリ
• Claude Code公式ドキュメント
• MCP (Model Context Protocol)仕様
• pipxドキュメント