Claude Code プラグインとは？自作・導入・配布の完全手順2026

「便利なスキルとフックをいくつも作ったけど、別マシンに移ったら全部設定し直し」——Claude Code を本格運用している個人開発者ほど、この再現性の壁にぶつかります。

結論から言うと、Claude Code の「プラグイン」は、スキル・MCP サーバー・スラッシュコマンド・フック・サブエージェントを 1 つの単位に束ねて、git 経由で配布・再利用できる仕組みです。バラバラに ~/.claude/ へ置いていた設定を、/plugin コマンドひとつで入れ替えられるようになります。

この記事では、プラグインの構成要素から、マーケットプレイス（配布カタログ）の作り方、/plugin での導入、そして最小プラグインを自作する手順までを、複数の Claude エージェントを常時運用している筆者の視点で解説します。読み終える頃には「自分の Claude Code 設定を、チームや別プロジェクトでも 1 コマンドで再現できる」状態の作り方がわかります。

この記事でわかること:

• プラグインが束ねる 5 つの構成要素（スキル / MCP / コマンド / フック / エージェント）
• マーケットプレイス（marketplace.json）と単体プラグイン（plugin.json）の違い
• /plugin marketplace add から導入までの最短手順
• 最小プラグインを自作するディレクトリ構成
• プラグインを使うべき人・使わなくていい人の判断基準

Claude Code プラグインとは？30 秒でわかる概要

プラグインは、Claude Code の機能拡張を 再配布可能なパッケージにまとめたものです。これまで個別に管理していた次の 5 種類を、1 つのディレクトリに同梱できます。

構成要素	役割	単体での置き場所
スキル（skills）	Claude が自動で呼び出す手順書	~/.claude/skills/
MCP サーバー	外部サービス連携（DB・API など）	.mcp.json
スラッシュコマンド	/コマンド名 で起動する定型処理	~/.claude/commands/
フック（hooks）	イベント発火時の自動処理・ガード	settings.json
サブエージェント	専門タスク用の別エージェント定義	~/.claude/agents/

ポイントは、これらを「プラグイン」という 1 パッケージにまとめ、git リポジトリで配布できること。チームメンバーや自分の別マシンは /plugin で入れるだけで、同じスキル・コマンド・フックが一括で揃います。Anthropic 公式も anthropics/claude-plugins-official という管理ディレクトリを公開しており、配布のエコシステムが整いつつあります。

プラグインの構成：plugin.json と marketplace.json

混乱しやすいのが「プラグイン本体」と「マーケットプレイス」の関係です。役割が違います。

• プラグイン本体＝機能のパッケージ。マニフェスト plugin.json を持つ
• マーケットプレイス＝複数プラグインを一覧化した配布カタログ。marketplace.json を持つ

単体プラグインのディレクトリ構成

my-plugin/
├── .claude-plugin/
│   └── plugin.json        # マニフェスト（必須・名前/説明/バージョン）
├── .mcp.json              # MCP サーバー設定（任意）
├── commands/              # スラッシュコマンド（任意）
├── agents/                # サブエージェント定義（任意）
├── skills/                # スキル（任意・skills/<name>/SKILL.md）
└── README.md

重要なルールは、マニフェストだけが .claude-plugin/ の中に入り、commands/ や skills/ などの実体はプラグインのルート直下に置くこと。ここを間違えると Claude Code がスキルやコマンドを認識しません。

マーケットプレイスのカタログ

配布側のリポジトリには、ルートに .claude-plugin/marketplace.json を置きます。これが「どのプラグインがどこにあるか」を示すカタログです。git リポジトリ・ローカルパスなど複数のソースタイプを束ねられます。

プラグインの導入手順（最短ルート）

既存のマーケットプレイスからプラグインを入れる流れはシンプルです。

# 1. マーケットプレイスを登録（git リポジトリやローカルパスを指定）
/plugin marketplace add <owner/repo もしくは URL>

# 2. 一覧から選んでインストール（対話メニュー）
/plugin

# 3. カタログを最新化したいとき
/plugin marketplace update

/plugin を実行すると登録済みマーケットプレイスのプラグインが一覧表示され、その場で導入・有効化できます。プロジェクト単位で固定したい場合は、.claude/settings.json にマーケットプレイスとプラグインを記述しておけば、リポジトリを clone したメンバー全員に同じ拡張が行き渡ります。これが「設定の再現性」を生む核心です。

最小プラグインを自作する 4 ステップ

「まず動くものを作る」なら、スキル 1 つだけのプラグインから始めるのが最短です。

1. ディレクトリを切る：my-plugin/.claude-plugin/ を作成
2. マニフェストを書く：plugin.json に名前・説明・バージョンを記述

{
  "name": "my-plugin",
  "description": "個人開発用の共通スキル束",
  "version": "0.1.0",
  "author": "your-name"
}

3. 機能を足す：skills/release-note/SKILL.md のように、ルート直下へスキルやコマンドを配置
4. 配布する：git にプッシュし、ルートに .claude-plugin/marketplace.json を置けば、他の人が /plugin marketplace add あなたのリポジトリ で導入可能

スキルは <プラグイン名>:<スキル名> の形で登録されるため、命名の衝突を避けながら複数プラグインを共存させられます。

スキル・MCP・プラグインはどう違う？

「結局どれを使えばいいの？」という疑問には、粒度の違いで答えるのが分かりやすいです。

概念	粒度	主な用途	配布
スキル	最小	Claude に手順を教える	単体ファイル
MCP サーバー	中	外部サービスと接続する	サーバー単位
プラグイン	大	スキル＋MCP＋コマンド等を束ねる	git で一括配布

スキルや MCP の中身そのものを深掘りしたい場合は、個別記事のほうが向いています。プラグインは「それらをどう束ねて配るか」という一段上のレイヤーだと捉えてください。

Claude Code スキル vs MCP どっちを使う？2026

スキルとMCPサーバーの使い分けを、用途とコストの両面から判断する基準を解説

→

Claude Code スキル徹底解説2026

SKILL.mdの書き方と自動発火の仕組みを実例ベースで深掘り

→

【第1回】Claude Code スキル入門

Labシリーズの起点。スキルの基本から実装まで段階的に学ぶ

→

こんな人におすすめ / おすすめしない人

おすすめな人

• 複数プロジェクトや複数マシンで Claude Code を使い、設定を毎回コピーしている
• チームや SNS で自分の Claude 運用ノウハウを配布・共有したい
• スキル・コマンド・フックが 5 個以上に増えて管理が破綻しかけている

今は不要な人

• Claude Code を 1 マシン・1 プロジェクトでしか使っていない
• スキルやコマンドがまだ数個で、~/.claude/ 直置きで困っていない

プラグインは「拡張が増えてから効いてくる」仕組みです。導入自体が目的化すると過剰投資になるので、散らかってきた実感が出たタイミングで束ねるのが費用対効果の高い使い方です。

で、どうやって稼ぐ？——プラグインを収益につなげる視点

プラグインは便利ですが、それ自体は 1 円も生みません。個人開発で月 ¥5 万を目指す立場なら、「再現性が上がった開発速度」を販売可能なアウトプットに変換するところまでがセットです。

たとえば、自作プラグインで初期セットアップが速くなった分を、技術記事・テンプレート・小さな SaaS のリリース頻度に回す。AI 開発ツールの月額費（Claude Pro / Max など）をどう回収するかという全体設計と組み合わせて初めて、ツール投資が事業投資に変わります。Claude Code 運用の効率化と収益化をひと続きで設計したい人は、まず費用回収の収益モデルから固めるのが近道です。

まとめ

Claude Code のプラグインは、スキル・MCP・コマンド・フック・サブエージェントを 1 パッケージに束ねて git で配布・再利用する仕組みです。plugin.json を持つ単体プラグインと、marketplace.json を持つ配布カタログの 2 層構造を押さえれば、/plugin marketplace add から導入まで一気通貫で扱えます。

設定が散らかってきた個人開発者ほど効果が大きい機能ですが、導入そのものを目的にせず、**「再現性 → 開発速度 → 販売できる成果物」**の流れまで設計してこそ、月 ¥5 万への投資が回収できます。まずは手元のスキル 1 つをプラグイン化するところから始めてみてください。

---