マルチエージェントClaude Codeのプラグインとは？入れ方と作り方の基本
この記事の要点
- プラグインは、スキル・サブエージェント・フック・MCPサーバーをひとまとめにして入れたり配ったりする仕組み
- 入れるときは /plugin のDiscoverから選び、自分だけ・このリポジトリの全員・このリポジトリの自分だけ、の3つの範囲から選ぶ
- 有効なプラグインは使わない会話でも名前と説明が載る。入れすぎず、使っていないものはオフにする
スキルを何本か作り、フックやMCPの設定も増えてくると、「同じ設定をチームの人にも使ってほしい」「別のプロジェクトでも同じものを使いたい」と思う場面が出てきます。そのときに使うのが プラグイン です。
この記事では、Claude Code のプラグインについて、公式ドキュメント（2026年10月23日確認）にもとづいて、仕組み・入れ方・作り方・注意点を順に整理します。
結論：プラグインは「いくつかの仕組みを1つの箱にまとめたもの」
プラグインは、スキル・サブエージェント・フック・MCPサーバーなどを1つのフォルダにまとめ、まとめて入れたり配ったりできる仕組み です。新しい機能というより、すでにある仕組みの「梱包の形」と考えると分かりやすくなります。
公式ドキュメントでも、スキルやフックは単体でも動くので、自分だけ・1つのプロジェクトだけで使うならプラグインにしなくてよい とされています。プラグインにする価値があるのは、次のようなときです。
- チームの人に同じ設定を配りたい
- いくつものプロジェクトに同じものを入れたい
- 版を決めて、更新を配りたい
プラグインの中身
プラグインは、.claude-plugin/plugin.json（マニフェスト）で名前を決め、その横に部品を置いたフォルダです。入れられる主な部品は次のとおりです。
| 部品 | 置き場所の例 | プラグインに入れると |
|---|---|---|
| スキル | skills/<名前>/SKILL.md | /プラグイン名:スキル名 で呼べる |
| サブエージェント | agents/<名前>.md | Claude が仕事を任せられる係になる |
| フック | hooks/hooks.json | 決まった出来事のたびに動く |
| MCPサーバー | .mcp.json | 有効な間、外部ツールにつながる |
スキル名の前に プラグイン名が付く のがポイントです。2つのプラグインがどちらも review というスキルを持っていても、/a:review と /b:review で区別できます。スキルの書き方そのものは Claude Codeのスキルとは？ で、フックは Claude Codeのフック入門、MCPは Claude CodeにMCPを追加する手順 で解説しています。
入れ方：/plugin から選び、範囲を決める
プラグインを入れるいちばん簡単な方法は、ターミナルの Claude Code で /plugin を開き、Discover タブから選ぶことです。公式のマーケットプレイス（プラグインの一覧）は、最初に対話モードで起動したときに自動で追加されます。
名前が分かっているなら、次のように打つと、そのプラグインの詳細画面が開きます。会話の中ではすぐには入らず、中身を確かめて範囲を選んでから入ります。
/plugin install commit-commands@claude-plugins-official入れるときに選ぶ 範囲（スコープ） は3つです。
| 範囲 | 使える人 | 向いている場面 |
|---|---|---|
| ユーザー | このパソコンの自分。どのプロジェクトでも | 自分の作業を楽にする道具 |
| プロジェクト | このリポジトリで作業する全員（.claude/settings.json に書かれてコミットされる） | チームでそろえたい手順・確認 |
| ローカル | このリポジトリの自分だけ | 試しに入れてみるとき |
プロジェクトの範囲にしても、設定がコミットされるだけで、各メンバーのパソコンにはそれぞれ入れる必要がある 点に注意します。
シェルから入れることもできます。セットアップ用のスクリプトに書いておくときは、こちらが便利です。
claude plugin install <名前>@<マーケットプレイス名> --scope project作り方：空のフォルダから3ステップ
自分のスキルをプラグインにする最小の手順は、公式ドキュメントでは次の流れです。
- フォルダとマニフェストを作る：
my-first-plugin/.claude-plugin/plugin.jsonに、名前（必須・空白なし）と説明、版、作者を書きます。 - 部品を置く：
my-first-plugin/skills/hello/SKILL.mdのように、.claude-plugin/の外に部品を置きます。.claude-plugin/の中に入れるのは plugin.json だけです。 - 確かめて、読み込んで試す：
claude plugin validate ./my-first-plugin
claude --plugin-dir ./my-first-plugin--plugin-dir は、マーケットプレイスに載せずに その会話だけプラグインを読み込む オプションです。作っている途中の確認はこれで足ります。配るときは、.claude-plugin/marketplace.json を置いたリポジトリを用意し、相手に /plugin marketplace add <owner/repo> で追加してもらいます。
入れる前に確かめたい3つのこと
プラグインは便利ですが、入れると 常にその会話の一部になる ことを公式ドキュメントは強調しています。
- 会話の場所をとる：Claude が自分で呼べるスキルやエージェントは、使わない会話でも名前と説明が毎回載ります。入れすぎると、そのぶん使える量が減ります。使っていないものは
/pluginの Installed タブやclaude plugin disableでオフにできます。 - 自分の権限で動く：プラグインのフックやMCPサーバーは、あなたの権限で動きます。公式のものも含め、入れる前に中身を確かめるのが前提です。
- 出どころを見分ける：名前で公式・コミュニティ・それ以外（第三者）の3つに分かれます。同僚や自社が作ったものも「第三者」に入ります。
会社で使うなら、どのマーケットプレイスを許すかを管理者の設定で決めることもできます。権限まわりの考え方は Claude Codeの権限設定入門 もあわせて読むと整理しやすくなります。
よくある質問
スキルとプラグイン、どちらから始めればいいですか？
まずは 単体のスキル から始めるのがおすすめです。自分だけで使ううちはスキルで十分で、チームに配りたくなった時点でプラグインにまとめれば間に合います。
claude -p（非対話モード）でもプラグインは使えますか？
すでに入れたプラグインは読み込まれます。ただし /plugin の画面は使えないので、入れる・外すは claude plugin コマンドで行います。非対話モードの使い方は claude -pの使い方 で解説しています。
入れたのにスキルが出てきません
プラグインは起動時に読み込まれます。設定に有効と書かれていること、パソコンに入っていること、会話に読み込まれていること、の3段階を順に確かめます。プロジェクトの範囲で有効になっていても、自分のパソコンに入れていなければ使えません。
まとめ
- プラグインは、スキル・サブエージェント・フック・MCPを 1つの箱にまとめて配る 仕組み
- 入れるときは
/pluginから選び、ユーザー・プロジェクト・ローカル の範囲を決める - 作るときは plugin.json と部品を置き、
--plugin-dirで試してから配る - 有効なものは会話の場所をとるので、使わないものはオフ にする
出典
- Claude Code 公式ドキュメント「Plugins overview」
- Claude Code 公式ドキュメント「Install and manage plugins」
- Claude Code 公式ドキュメント「Create a Claude Code plugin」
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。
