インストールガイド: プラグインマーケット vs マニュアルインストール

このチュートリアルで学べること

このチュートリアルを完了すると、以下ができるようになります：

• プラグインマーケットからワンクリックで Everything Claude Code をインストールする
• 必要なコンポーネントを手動で選択して詳細な設定を行う
• MCP サーバーと Hooks を正しく設定する
• インストールが成功したかどうかを検証する

あなたが直面している問題

Everything Claude Code をすぐに始めたいのに、以下の点が分かりません：

• プラグインマーケットでワンクリックインストールすべきか、各コンポーネントを手動で制御すべきか？
• 設定ミスによる機能不全をどう防ぐか？
• マニュアルインストール時にどのファイルをどこにコピーする必要があるか？

この方法を使うべき場面

シナリオ	推奨方法	理由
初めて使う	プラグインマーケットインストール	最も簡単で5分で完了
特定の機能を試したい	プラグインマーケットインストール	完全に体験してから決定できる
特定の要件がある	マニュアルインストール	各コンポーネントを正確に制御できる
既存のカスタム設定がある	マニュアルインストール	既存の設定を上書きすることを避けられる

基本的な考え方

Everything Claude Code では2つのインストール方法を提供しています：

1. プラグインマーケットインストール（推奨）

   • ほとんどのユーザーに適している
   • すべての依存関係を自動で処理
   • 1つのコマンドでインストール完了

2. マニュアルインストール

   • 特定の要件を持つユーザーに適している
   • インストールするコンポーネントを正確に制御できる
   • 手動での設定が必要

どちらの方法を選んでも、最終的には設定ファイルが ~/.claude/ ディレクトリにコピーされ、Claude Code がこれらのコンポーネントを認識して使用できるようになります。

🎒 始める前の準備

前提条件

始める前に以下を確認してください：

• [ ] Claude Code がインストールされている
• [ ] GitHub にアクセスできるネットワーク接続がある
• [ ] 基本的なコマンドライン操作を理解している（マニュアルインストールを選択する場合）

---

実際にやってみよう

方法1：プラグインマーケットインストール（推奨）

これは最も簡単な方法で、初めて使う方やすぐに体験したい方に適しています。

ステップ1：プラグインマーケットを追加する

なぜ必要か Claude Code のプラグインマーケットとして GitHub リポジトリを登録することで、その中のプラグインをインストールできるようになります。

Claude Code に以下を入力してください：

/plugin marketplace add affaan-m/everything-claude-code

表示されるはず：

Successfully added marketplace affaan-m/everything-claude-code

ステップ2：プラグインをインストールする

なぜ必要か 先ほど追加したマーケットから Everything Claude Code プラグインをインストールします。

Claude Code に以下を入力してください：

/plugin install everything-claude-code@everything-claude-code

表示されるはず：

Successfully installed everything-claude-code@everything-claude-code

チェックポイント ✅

プラグインがインストールされたか確認します：

/plugin list

出力に everything-claude-code@everything-claude-code が表示されるはずです。

ステップ3（オプション）：settings.json を直接設定する

なぜ必要か コマンドラインをスキップして直接設定ファイルを変更したい場合に使用します。

~/.claude/settings.json を開き、以下を追加してください：

{
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}

表示されるはず：

• 設定ファイルが更新されると、Claude Code が自動的にプラグインを読み込みます
• すべての agents、skills、commands、hooks がすぐに利用可能になります

---

方法2：マニュアルインストール

どのコンポーネントをインストールするかを正確に制御したい方に適しています。

ステップ1：リポジトリをクローンする

なぜ必要か Everything Claude Code のすべてのソースファイルを取得します。

git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

表示されるはず：

Cloning into 'everything-claude-code'...
remote: Enumerating objects...

ステップ2：agents をコピーする

なぜ必要か 専門化されたサブエージェントを Claude Code の agents ディレクトリにコピーします。

cp everything-claude-code/agents/*.md ~/.claude/agents/

表示されるはず：

• ~/.claude/agents/ ディレクトリに 9 個の agent ファイルが追加されます

チェックポイント ✅

agents がコピーされたか確認します：

ls ~/.claude/agents/

以下のような表示がされるはずです：

planner.md architect.md tdd-guide.md code-reviewer.md ...

ステップ3：rules をコピーする

なぜ必要か 強制的なルールを Claude Code の rules ディレクトリにコピーします。

cp everything-claude-code/rules/*.md ~/.claude/rules/

表示されるはず：

• ~/.claude/rules/ ディレクトリに 8 個のルールファイルが追加されます

ステップ4：commands をコピーする

なぜ必要か スラッシュコマンドを Claude Code の commands ディレクトリにコピーします。

cp everything-claude-code/commands/*.md ~/.claude/commands/

表示されるはず：

• ~/.claude/commands/ ディレクトリに 14 個のコマンドファイルが追加されます

ステップ5：skills をコピーする

なぜ必要か ワークフロー定義とドメイン知識を Claude Code の skills ディレクトリにコピーします。

cp -r everything-claude-code/skills/* ~/.claude/skills/

表示されるはず：

• ~/.claude/skills/ ディレクトリに 11 個の skill ディレクトリが追加されます

ステップ6：hooks を設定する

なぜ必要か Claude Code の settings.json に自動化フック設定を追加します。

hooks/hooks.json の内容を ~/.claude/settings.json にコピーします：

cat everything-claude-code/hooks/hooks.json

出力を ~/.claude/settings.json に以下の形式で追加します：

{
  "hooks": [
    {
      "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
      "hooks": [
        {
          "type": "command",
          "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
        }
      ]
    }
  ]
}

表示されるはず：

• TypeScript/JavaScript ファイルを編集すると、console.log があれば警告が表示されます

重要な注意事項

~/.claude/settings.json に既存の設定がある場合は、既存の hooks を上書きせずにマージする必要があります。

ステップ7：MCP サーバーを設定する

なぜ必要か Claude Code の外部サービス連携機能を拡張します。

mcp-configs/mcp-servers.json から必要な MCP サーバーを ~/.claude.json に追加します：

cat everything-claude-code/mcp-configs/mcp-servers.json

必要な設定を ~/.claude.json にコピーします。例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "YOUR_GITHUB_TOKEN_HERE"
      }
    }
  }
}

重要：プレースホルダーを置換する

YOUR_*_HERE プレースホルダーを実際の API Key に置き換えないと、MCP サーバーは動作しません。

MCP 使用の推奨事項

すべての MCP を有効にしないでください！ MCP が多すぎると、コンテキストウィンドウを大量に消費します。

• 20〜30個の MCP サーバーを設定することを推奨
• プロジェクトごとに10個以下を有効にすることを推奨
• 80個以下のツールをアクティブに保つことを推奨

disabledMcpServers を使用してプロジェクト設定で不要な MCP を無効にします：

{
  "disabledMcpServers": ["firecrawl", "supabase"]
}

---

チェックポイント ✅

プラグインマーケットインストールの検証

/plugin list

everything-claude-code@everything-claude-code が有効になっているはずです。

マニュアルインストールの検証

# agents の確認
ls ~/.claude/agents/ | head -5

# rules の確認
ls ~/.claude/rules/ | head -5

# commands の確認
ls ~/.claude/commands/ | head -5

# skills の確認
ls ~/.claude/skills/ | head -5

以下が表示されるはずです：

• agents ディレクトリに planner.md、tdd-guide.md など
• rules ディレクトリに security.md、coding-style.md など
• commands ディレクトリに tdd.md、plan.md など
• skills ディレクトリに coding-standards、backend-patterns など

機能の可用性を検証

Claude Code に以下を入力してください：

/tdd

TDD Guide agent が動作し始めるはずです。

---

よくある落とし穴

よくあるエラー 1：プラグインインストール後に機能しない

症状：プラグインをインストールしても、コマンドが使用できない。

原因：プラグインが正しく読み込まれていない。

解決策：

# プラグインリストを確認
/plugin list

# 有効になっていない場合は手動で有効化
/plugin enable everything-claude-code@everything-claude-code

よくあるエラー 2：MCP サーバー接続失敗

症状：MCP 機能が使用できず、接続失敗のエラーが表示される。

原因：API Key が置換されていないか、形式が間違っている。

解決策：

• ~/.claude.json 内のすべての YOUR_*_HERE プレースホルダーが置換されているか確認
• API Key が有効か確認
• MCP サーバーが正しいパスで実行されているか確認

よくあるエラー 3：hooks がトリガーされない

症状：ファイルを編集しても hooks の表示が見られない。

原因：~/.claude/settings.json の hooks 設定の形式が間違っている。

解決策：

• hooks 配列の形式が正しいか確認
• matcher 式の構文が正しいか確認
• hook コマンドのパスが実行可能か確認

よくあるエラー 4：ファイル権限の問題（マニュアルインストール）

症状：ファイルをコピーする際に "Permission denied" エラーが表示される。

原因：~/.claude/ ディレクトリの権限が不十分。

解決策：

# .claude ディレクトリが存在し、権限があることを確認
mkdir -p ~/.claude/{agents,rules,commands,skills}

# 必要に応じて sudo を使用
sudo cp -r everything-claude-code/agents/*.md ~/.claude/agents/

---

本レッスンのまとめ

2つのインストール方法の比較：

特性	プラグインマーケットインストール	マニュアルインストール
速度	⚡ 高速	🐌 低速
難易度	🟢 簡単	🟡 中程度
柔軟性	🔒 固定	🔓 カスタマイズ可能
推奨シナリオ	初心者、クイック体験	上級ユーザー、特定のニーズ

重要なポイント：

• プラグインマーケットインストールは最も簡単で、1つのコマンドで完了します
• マニュアルインストールはコンポーネントを正確に制御したいユーザーに適しています
• MCP 設定時はプレースホルダーを置換すること、多すぎるMCPは有効にしないことを忘れないでください
• インストールを検証する際はディレクトリ構造とコマンドの可用性を確認してください

---

次のレッスンの予告

次のレッスンでは パッケージマネージャー設定: 自動検出とカスタマイズ を学びます。

学べること：

• Everything Claude Code がパッケージマネージャーをどのように自動検出するか
• 6種類の検出優先度の仕組み
• プロジェクトレベルとユーザーレベルのパッケージマネージャー設定をどうカスタマイズするか
• /setup-pm コマンドを使用して迅速に設定する方法

---

付録: ソースコードリファレンス

クリックしてソースコードの場所を表示

更新日: 2026-01-25

機能	ファイルパス	行番号
プラグイン メタデータ	source/affaan-m/everything-claude-code/.claude-plugin/plugin.json	1-28
マーケット リスト	source/affaan-m/everything-claude-code/.claude-plugin/marketplace.json	1-45
インストールガイド	source/affaan-m/everything-claude-code/README.md	175-242
Hooks 設定	source/affaan-m/everything-claude-code/hooks/hooks.json	1-146
MCP 設定	source/affaan-m/everything-claude-code/mcp-configs/mcp-servers.json	1-95

重要な設定：

• プラグイン名: everything-claude-code
• リポジトリ: affaan-m/everything-claude-code
• ライセンス: MIT
• 9 agents、14 commands、8 rules、11 skills をサポート

インストール方法：

1. プラグインマーケットインストール: /plugin marketplace add + /plugin install
2. マニュアルインストール: agents、rules、commands、skills を ~/.claude/ にコピー