Claude Code Plugins & Marketplace完全ガイド — プラグインの仕組みと活用パターン

Claude Code PluginsはSkills / Sub-agents / MCP / Hooksをパッケージ化して配布する仕組みです。本サイトの記事生成Skill + 採点Sub-agent + 自動Hooksの組合せのように、複数要素をひとまとめにして他プロジェクトで再利用できます。

本記事ではMarketplaceの使い方、プラグイン構造、自作手順、人気プラグイン、よくあるつまずきまでを完全網羅します。

Pluginsとは

Claude Code Pluginsは次の4種類の拡張要素を1パッケージにまとめる仕組みです。

プラグインはnpmパッケージとして配布され、/plugin install <name> のような形でインストールできます。チーム / コミュニティで横展開する用途と、自分用に複数プロジェクトで使い回す用途の両方で使えます。

Marketplaceとは

Claude Code MarketplaceはAnthropic公式のPlugin配布プラットフォームです。次のようなPluginが見つかります。

• 言語 / フレームワーク特化(React / Next.js / Python / Rust等の専用Skill + Sub-agentパッケージ)
• 業界特化(SaaS運営 / マーケティング / コードレビュー / 採点)
• ワークフロー特化(CI/CD連携 / GitHub操作 / Slack通知)
• MCP統合(Notion / Slack / Linear等の組合せ)

Marketplaceから /plugin search <keyword> でプラグインを検索、/plugin install <name> でインストール、/plugin list で管理状況を確認できます。

プラグインの構造

最小のPluginパッケージは次のような構造です。

my-plugin/
├── package.json                  # npm パッケージ定義
├── plugin.json                   # Plugin メタデータ
├── skills/
│   ├── commit-writer/SKILL.md
│   └── pr-reviewer/SKILL.md
├── agents/
│   ├── code-reviewer.md
│   └── test-writer.md
├── mcp/
│   └── server.js                 # オプション、MCP サーバー実装
└── README.md

plugin.json の主要キー:

インストール時にClaude Codeは plugin.json を読み、Skills / Agentsを所定の配置場所に展開します。requires.permissions で宣言された権限は、初回起動時にユーザーに確認されます。

プラグインの作り方(最小手順)

1. plugin.jsonとREADME.mdを書く:メタデータと使い方を明示
2. skills/ agents/ ディレクトリに既存のSkill / Sub-agentを配置:単一プロジェクトで動いている資産を持ち込む
3. npmパッケージとして公開:npm publish --access public(または社内registry)
4. Marketplaceに登録:Anthropic公式reviewを経て掲載される(自己ホストする選択肢もあり)

詳細な実装手順は公式docs(code.claude.com/docs/en/plugins)を参照してください。

人気プラグインの例

Marketplaceで広く使われているPluginの代表例(2026年5月時点):

実際のラインナップはMarketplaceで常に変動するため、最新は /plugin search で確認してください。

いつPluginを使う / 作るか

「Plugin化すべきか、プロジェクト固有のSkill / Sub-agentで済ますか」の判断軸を以下の表にまとめます。

選び方の原則:

1. 再利用範囲が「自分の1プロジェクト」→ プロジェクト固有 .claude/
2. 「自分の複数プロジェクト」→ 個人グローバル ~/.claude/
3. 「他人と共有」→ Plugin(社内 / コミュニティ)

Pluginと他レイヤの関係

PluginはSkills / Sub-agents / MCP / Hooksを束ねる「配布レイヤー」です。各構成要素自体の役割は変わらず、配布方法だけが異なります。

よくあるつまずきと回避策

Plugin運用で踏みやすい落とし穴を6件集めました。

つまずき1:Pluginの依存関係衝突

複数Pluginが同名のSkill / Sub-agentを提供すると、衝突します。Plugin側で固有prefix(<plugin-name>:commit-writer 等)を使うか、ユーザー側で /plugin disable で片方を無効化します。

つまずき2:Pluginが要求する権限が広すぎる

permissions で Bash(*) のような全許可を要求するPluginは危険信号です。インストール前に plugin.json のpermissionsを確認し、最小権限の原則に反するPluginは採用を見送ります。

つまずき3:Plugin内のSkill descriptionが抽象的で自動起動しない

Skillのdescriptionが抽象的だとClaudeが文脈から自動選択できず、ユーザーが毎回 /<skill-name> で明示起動する運用になります。Pluginの作者はdescriptionを1文で具体的に書きます。

つまずき4:Plugin更新で既存運用が壊れる

npm update のような全Plugin一括更新は危険です。Pluginごとにsemverでpin留めし、メジャー更新はCHANGELOGを読んでから適用します。

つまずき5:プロジェクト固有設定とPluginの優先順位

<project>/.claude/skills/foo と Plugin から展開された skills/foo が同名の場合、プロジェクト固有が勝ちます。Pluginの動作を確かめたいときは、プロジェクト固有を一時的にリネームして衝突を回避します。

つまずき6:自作Pluginのversion管理

semverを守らずbreaking changeをminor / patchで出すと、ユーザー側の自動更新で壊れます。Plugin公開時はCHANGELOG.mdとsemver厳守を徹底します。

まとめ

Claude Code PluginsはSkills / Sub-agents / MCP / Hooksを束ねて配布する「再利用と共有のレイヤー」です。判断の軸は次の3つです。

1. 1プロジェクト → プロジェクト固有 .claude/
2. 複数プロジェクト → 個人グローバル ~/.claude/
3. 他人と共有 → Plugin(Marketplace / 社内npm)

Pluginは配布の仕組みであり、本質はSkills / Sub-agents / MCP / Hooksの組合せです。まず単体のSkill / Sub-agentをプロジェクトで動かしてから、複数プロジェクトで使い回す段階でPlugin化を検討する流れが現実的です。

各構成要素の詳細はClaude Code Skills完全ガイド / Claude Code Sub-agents完全ガイド / Claude Code MCPサーバー完全ガイド / Claude Code Hooks完全ガイドを参照してください。