Claude Code Setup プラグイン 徹底解説 - コードベース分析で MCP / Skills / Hooks / Subagents / Slash Commands を自動レコメンド

Claude Code は非常に強力ですが、MCP サーバー / Skills / Hooks / Subagents / Slash Commands といった拡張機構が増えるにつれ、「自分のプロジェクトでは何を入れるのが最適か」を判断するのが大変になってきました。

Anthropic 公式の Claude Code Setup プラグインは、まさにその判断を肩代わりしてくれる「セットアップアドバイザー」です。コードベースを 読み取り専用で分析し、プロジェクトの技術スタックに合わせて 最も効くであろう自動化を5カテゴリにわたって提案してくれます。

本記事は 2026年5月18日時点の情報をもとに、公式ページ（Claude Code Setup）と Claude Code 公式ドキュメントを参照して整理しています。

Claude Code Setup プラグインとは

ひとことで言うと、

コードベースを分析して、あなたのプロジェクトに合った Claude Code 自動化を提案する Anthropic 公式プラグイン。

主要スペックを表にすると次のとおり。

「コードベースを書き換える」のではなく、「何をインストール・設定すれば良いかを助言する」ことに特化したプラグイン、という位置付けが重要です。導入のハードルが極めて低く、試しに走らせて「合わなければ捨てる」が安全にできます。

まず前提: Claude Code の5つの拡張機構

Claude Code Setup の中身を理解するには、Claude Code 自体が持っている拡張機構を整理しておくと早いです。

公式ドキュメントの整理に沿うと、CLAUDE.md が永続的な記憶、Skills が再利用可能なワークフロー、MCP が外部接続、Subagents がコンテキスト分離、Hooks がイベント自動化、Plugins がそれらをまとめて配る箱、というのが全体像です。

Claude Code Setup プラグインは、このうち Skills / MCP / Subagents / Hooks / Slash Commands の5カテゴリについて、プロジェクトに合った中身を提案します。

5つのレコメンドカテゴリ

公式ページが明示している5カテゴリと、典型的なレコメンドの例を整理します。

1. MCP サーバー（Model Context Protocol）

外部ツールとの接続。プロジェクトの依存関係を見て、よく使われる MCP サーバーを提案します。

「フロントエンドプロジェクトに Playwright MCP を入れておけば、UI 動作確認をエージェントに任せられる」という発想を、自動で気付かせてくれるのがポイント。

2. Skills

再利用可能なワークフローを定義する SKILL.md 形式。プロジェクトの技術スタックに合わせて「これは Skill 化すると便利ですよ」という観点を提案します。

# データベースマイグレーション
 
## 手順
1. 現在のスキーマを `prisma db pull` で取得
2. マイグレーションファイルを生成
3. ステージング DB で適用
4. テスト実行
5. 本番 DB へ適用

このような 「半定型化された手順」が複数あるプロジェクトでは、Skills を切り出すことで Claude の挙動が安定し、新メンバーへの教育コストも下がります。

3. Hooks

SessionStart PreToolUse PostToolUse などのライフサイクルで実行されるスクリプト。

「コード書いた直後に lint と型チェック自動で走らせる」のような地味だが効くフックを発見してくれます。

4. Subagents

複雑なタスクを 分離されたコンテキストで走らせ、要約結果だけ親エージェントに返すスペシャリスト。

Subagent は メインの会話履歴を汚さずに専門タスクを並列実行できるので、大規模プロジェクトでは特に効きます。

5. Slash Commands

/command 形式で呼び出せるカスタムコマンド。プロジェクト固有の繰り返し作業を1コマンド化します。

読み取り専用モードという設計判断

特筆すべきは、Claude Code Setup プラグインが read-only モードで動作すること。

• プロジェクトのファイルを 一切書き換えない
• 提案を出すだけで、実際に MCP / Skills / Hooks を追加するかどうかは ユーザーの意思決定に委ねる
• 「合わない」と思ったら ただ無視するだけで副作用なし

この設計のおかげで、

• 本番運用中の重要プロジェクトでも安全に走らせられる
• 提案を見てから「.claude-plugin/ をどう設計するか」を考えられる
• 仕事中のリポジトリに対しても気軽に試せる

「自動化レコメンダー」と「自動化アプライヤー」が分離されているのは、エージェント系ツールの良い設計パターンです。

インストール方法

Claude Code には 公式マーケットプレイス（claude-plugins-official）が標準で組み込まれており、/plugin コマンドからインストールできます。

マーケットプレイスからインストール

# Claude Code Setup プラグインをインストール
/plugin install claude-code-setup@claude-plugins-official

/plugin を実行すると Discover タブが開き、ブラウザ的にプラグインを探せます（claude.com/plugins でも一覧確認可能）。

マーケットプレイスが見つからない場合

# 公式マーケットプレイスを追加
/plugin marketplace add anthropics/claude-plugins-official
 
# 既に追加済みなら更新
/plugin marketplace update claude-plugins-official

サードパーティのマーケットプレイス

GitHub リポジトリ / Git URL / ローカル JSON など、様々な形で追加できます。

# GitHub リポジトリから追加
/plugin marketplace add owner/repo
 
# Git URL から追加
/plugin marketplace add https://gitlab.com/company/plugins.git
 
# ローカルファイルから追加
/plugin marketplace add ./path/to/marketplace.json

社内専用プラグインを配布したいケースでは、社内 Git に marketplace.json を置いて配るのが定番パターン。

使い方 — プロンプト例

インストール後の使い方はとてもシンプル。Claude Code のチャットに 自然言語でリクエストするだけです。

全カテゴリの提案を得る

このプロジェクトの自動化をおすすめして

Claude Code のセットアップを手伝って

このリポジトリに合ったプラグイン構成を教えて

→ 5カテゴリそれぞれから 最も価値が高い1〜2件ずつを提示します。「広く浅く全体像」を見たいフェーズ向け。

特定カテゴリだけ深掘り

このプロジェクトで使うべき MCP サーバーを教えて

どんな Hook を入れるのがよさそう？

おすすめの Subagent を3つ挙げて

→ 該当カテゴリの提案を 3〜5件に拡張して返します。「MCP だけ詰めたい」のような深掘りフェーズ向け。

プロジェクト検出ロジック

Claude Code Setup は次のような情報を見てプロジェクトタイプを判別しています。

「package.json を見て Next.js だと判明 → Playwright MCP と accessibility-reviewer Subagent を提案」のように、判別から提案までが論理的に繋がっています。

関連プラグイン（Anthropic 公式マーケットプレイス）

Claude Code Setup と並んで公式マーケットプレイスで人気のプラグインを紹介します。

「Claude Code Setup でレコメンドを得る → 必要なプラグインを Marketplace から個別インストール」というのが、現状の最も効率的な導入フロー。Context7 や Code Review はほぼ全プロジェクトで効くので、Setup が提案するまでもなく入れて良いです。

典型的な導入フロー（ハンズオン）

新規プロジェクトに導入する場合、以下が最短経路です。

1. Claude Code をプロジェクトルートで起動
2. /plugin install claude-code-setup@claude-plugins-official でインストール
3. プロジェクトを軽く読ませる: このリポジトリを一度俯瞰して
4. 全カテゴリの提案を取得: このプロジェクトの自動化をおすすめして
5. 各カテゴリで深掘り: 提案された MCP の中で、最初に入れるべきはどれ？ のように対話的に決める
6. 実際のインストール:
   • MCP は /mcp add または ~/.config/claude-code/mcp.json
   • Skills は .claude/skills/ 配下に SKILL.md を配置
   • Hooks は .claude/hooks/hooks.json
   • Subagents は .claude/agents/
   • Slash Commands は .claude/commands/
7. CLAUDE.md にプロジェクト固有の指示・規約を書き足す
8. もう一度 このプロジェクトの自動化をおすすめして を走らせて、追加で取りこぼしを拾う

ポイントは、Setup プラグインは何度走らせてもタダだということ。プロジェクトの成長段階に応じて、半年に1度くらい走らせ直すと新しいレコメンドが出てきます。

自前プラグインを作りたくなったら

Setup の提案にハマるものがない場合、自前のプラグインを作って配ることもできます。最小構成は次のディレクトリ。

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # name / description / version / author
├── skills/
│   └── deploy/
│       └── SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/
│   └── hooks.json
└── commands/
    └── deploy-preview.md

plugin.json には以下のような中身を入れます。

{
  "name": "my-plugin",
  "description": "社内プロジェクト共通のCC自動化セット",
  "version": "0.1.0",
  "author": "Internal Tools Team"
}

これを GitHub リポジトリに置いて、

/plugin marketplace add my-org/my-plugin-marketplace
/plugin install my-plugin@my-org-marketplace

で社内配布完了。.claude/ 配下に直書きする「スタンドアロン構成」と違って、プラグインなら名前空間付き（/my-plugin:deploy-preview）で他人と衝突しません。

まとめ

• Claude Code Setup は、コードベースを 読み取り専用で分析して、Claude Code 自動化を5カテゴリ（MCP / Skills / Hooks / Subagents / Slash Commands）にわたり提案してくれる Anthropic 公式プラグイン
• 「全カテゴリざっくり」も「特定カテゴリ深掘り」も自然言語で要求できる
• ファイルを書き換えないので、本番運用中のリポジトリでも安全に走らせられる
• package.json / 言語ファイル / ディレクトリ構造 / コードパターンから判定して、具体的な提案（React なら Playwright MCP、認証コードあるなら security-reviewer Subagent）を返す
• 公式マーケットプレイス（claude-plugins-official）から /plugin install claude-code-setup@claude-plugins-official で導入
• Frontend Design / Superpowers / Context7 / Code Review といった人気プラグインと組み合わせると、Claude Code が「あなたのプロジェクト専用のIDE」に育つ
• 自前プラグインを作って社内マーケットプレイスで配るのも、Git リポジトリ1個で完結

「Claude Code を入れてはみたが、何から手をつければよいか分からない」——その状態にハマっているなら、まず Setup プラグインを入れて このプロジェクトの自動化をおすすめして と打ってみるのが、最も投資対効果が高い一歩です。

参考リンク

• Claude Code Setup（公式プラグインページ）
• Claude Code 公式ドキュメント: Extend Claude Code
• Claude Code 公式: Plugins reference
• Claude Code 公式: Create plugins
• Claude Code 公式: Discover and install prebuilt plugins through marketplaces
• Claude Code 公式: Hooks reference
• Claude Code プラグイン一覧（claude.com/plugins）