SuperClaudeエコシステムの完全インストールガイド。フレームワーク、Chrome拡張機能、GitHubワークフローツール、VS Code統合まで、全プラットフォーム対応で詳細解説

SuperClaudeは、AI駆動の開発ツールの包括的なエコシステムを提供し、専門コマンド、ブラウザ拡張機能、GitHubワークフロー自動化、IDE統合によってClaude Codeを拡張します。このガイドでは、Windows、macOS、LinuxプラットフォームでのすべてのSuperClaudeツールのインストール方法と、一般的な問題の詳細なトラブルシューティングについて説明します。

前提条件とシステム要件

SuperClaudeツールをインストールする前に、システムが以下のコア要件を満たしていることを確認してください：

必須の依存関係

• Claude Code CLI（すべてのツールに必要） – すべてのSuperClaudeツールが拡張する基盤
• Node.js 18+ とnpm 10.x+ – パッケージ管理とツール実行用
• Python 3.8+ – MCPサーバー統合と高度な機能用
• Git – ユーザー認証情報で設定済み（リポジトリ操作用）

オペレーティングシステムサポート

• Linux: Ubuntu 20.04+、Debian 10+（ネイティブサポート、最もクリーンなインストール）
• macOS: 10.15+（Catalinaとそれ以降、一部のHomebrewの考慮事項）
• Windows: Windows 10+ WSL 1またはWSL 2経由（追加設定が必要）

SuperClaudeフレームワークのインストール

SuperClaudeフレームワークは、Claude Codeを16の専門コマンド、9つの認知ペルソナ、MCPサーバー統合で拡張するコアツールです。

Claude Code設定（最初に必要）

SuperClaudeツールの前にClaude Codeをインストールします：

# npmでインストール（Node.jsが必要）
npm install -g @anthropic-ai/claude-code

# 代替方法：直接インストーラー（Linux/macOS）
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
& ([scriptblock]::Create((irm https://claude.ai/install.ps1)))

# サブスクリプションでClaude Codeを認証
claude login

# インストールを確認
claude --version
claude doctor  # 包括的なシステムチェック

フレームワークインストール方法

方法1：PyPIインストール（推奨）

# SuperClaudeをインストール
pip install SuperClaude

# インタラクティブセットアップでインストーラーを実行
python3 -m SuperClaude install --interactive

# ほとんどのユーザー向けクイックセットアップ
python3 -m SuperClaude install

方法2：開発者向けソースインストール

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

# uvでインストール（高速）
curl -Ls https://astral.sh/uv/install.sh | sh
uv sync

# またはpipでインストール
pip install -e .

# インストーラーを実行
python3 -m SuperClaude install --profile developer

Chrome拡張機能のインストール

SuperClaudeは、Claude.aiとの拡張ブラウザ統合のための複数のChrome拡張機能を提供しています。

公式Chrome Web Store拡張機能

Super Claude（メイン拡張機能）

1. Chrome Web Storeにアクセス：Super Claude拡張機能ページに移動
2. 拡張機能をインストール：「Chromeに追加」→「拡張機能を追加」をクリック
3. Claude.aiにサインイン：ブラウザでサインイン
4. 機能にアクセス：Claude.aiページで拡張機能アイコンをクリック

CG – Claude on Google

1. Chrome Web Storeからインストール：「CG – Claude on Google」を検索
2. Chromeに追加：標準インストールプロセス
3. 自動統合：Googleの検索ページで直接動作

開発者モードインストール

最先端機能を求める上級ユーザー向けに、いくつかのGitHubベース拡張機能は手動インストールが必要です：

一般的な開発者モードプロセス

1. 拡張機能ページにアクセス：アドレスバーにchrome://extensionsと入力
2. 開発者モードを有効化：右上角のトグルスイッチ
3. 拡張機能ファイルをダウンロード：リポジトリをクローンまたはZIPをダウンロード
4. 解凍した拡張機能を読み込み：manifest.jsonを含むフォルダを選択

GitHubワークフローツールのインストール

gwendallのSuperClaudeは、AI駆動のコミットメッセージ、変更履歴、ドキュメント生成でGitHubワークフローを強化するCLIツールです。

インストールとセットアップ

# SuperClaude CLIをインストール
npm install -g superclaude

# インストールを確認
superclaude --version

# システム検証（24時間キャッシュ）
cd your-project
superclaude --verify

GitHub認証設定

オプション1：GitHub CLI（推奨）

# GitHub CLIをインストール
brew install gh  # macOS
sudo apt install gh  # Ubuntu

# 認証
gh auth login

オプション2：SSH鍵認証

# SSH鍵を生成
ssh-keygen -t ed25519 -C "your@email.com"

# 公開鍵をGitHubに追加
cat ~/.ssh/id_ed25519.pub
# 出力をhttps://github.com/settings/keysにコピー

# 接続をテスト
ssh -T git@github.com

プラットフォーム固有のインストール違い

Windowsインストール（WSL経由）

WindowsはClaude CodeのLinux依存性のためWindows Subsystem for Linuxが必要です：

macOSインストール考慮事項

Homebrew固有の問題：Homebrew経由のNode.jsは、グローバルnpmパッケージでシンボリックリンクの問題を引き起こす場合があります。

Linuxインストール（最もクリーンなプロセス）

Linuxは最も簡単なインストールエクスペリエンスを提供します。