ハブネコのAIラボ

Claude Code

Claude Codeプラグイン導入ガイド｜おすすめと自作方法解説

公開: / 更新: ・読了目安6分

#プラグイン #設定

Claude Codeプラグイン導入ガイド｜おすすめと自作方法解説

先に結論: Claude Codeのプラグインは、スキル・サブエージェント・hooks・MCPサーバーをまとめて配布できる仕組みです。/plugin marketplace addでマーケットプレイスを追加し、/plugin installでインストール・有効化すれば使えます。

Claude Codeのプラグインは、スラッシュコマンド(スキル)・サブエージェント・hooks・MCPサーバーをひとつにまとめて配布できる仕組みです。

/pluginコマンドでマーケットプレイスを追加し、個別のプラグインをインストール・有効化するだけで、チームやコミュニティが作った機能をすぐに使い始められます。導入手順と代表例、plugin.jsonを使った自作の基本、セキュリティ上の注意点を解説します。

この記事の要点

  • プラグインはスキル・サブエージェント・hooks・MCPサーバーをまとめて配布できる仕組みです。
  • 公式マーケットプレイスclaude-plugins-officialは起動時に自動追加されます。
  • 導入は/plugin marketplace addでマーケットプレイスを追加した後、/plugin installでインストールします。
  • 自作プラグインは.claude-plugin/plugin.jsonをマニフェストとして持つディレクトリ構成で作成します。
  • プラグインは任意コードを実行できる強い権限を持つため、信頼できる配布元のものだけを導入すべきです。

前提・動作環境

この記事はターミナル版のClaude Codeを対象にしています。/pluginが表示されない場合は最新版に更新してください。

設定ファイル全体の使い分けは「Claude Code設定完全ガイド」を参照してください。

claude --version
2.1.211 (Claude Code)

プラグインとは何か

プラグインは、スキル(スラッシュコマンド)・サブエージェント・hooks・MCPサーバー・LSPサーバーなどをまとめたパッケージです。個人用の.claude/直下への設定でも十分ですが、チーム共有やコミュニティ配布を考えるならプラグイン化が向いています。

プラグインのスキルは/プラグイン名:スキル名のように名前空間が付くため、複数入れても衝突しません。

スキルの作り方は「Skillsの作り方」、同梱するMCPサーバーの設定方法は「MCP設定方法」で解説しています。

プラグインは新機能そのものではなく、既存のスキル・エージェント・MCPサーバーを「配布しやすくまとめる器」と考えるとイメージしやすいです。

マーケットプレイスの追加方法

プラグインはマーケットプレイス(カタログ)経由で配布されます。導入は「マーケットプレイスを追加する」→「個別のプラグインをインストールする」→「有効化・反映」の3段階です(2026年8月時点)。

プラグイン導入の流れ: マーケットプレイス追加→インストール→有効化の3ステップと、インストール時に選べるUser/Project/Localの3スコープを示す図解

公式のclaude-plugins-officialは起動時に自動追加されます。

コミュニティ審査を経たプラグインが並ぶclaude-communityや、社内向けの独自マーケットプレイスは、GitHubリポジトリ・Git URL・ローカルパスを指定して同じコマンドで追加します。

/plugin marketplace add anthropics/claude-plugins-community
/plugin marketplace add your-org/claude-plugins

代表例には公式のGitHub・GitLab連携プラグイン、コミット作業を自動化するcommit-commands、PRレビュー用のpr-review-toolkitなどがあります。まず/pluginのDiscoverタブを眺めるとイメージがつかみやすいです。

プラグインのインストール・有効化・無効化

マーケットプレイスを追加したら、名前を指定してインストールします。実行すると詳細画面が開き、インストール範囲(スコープ)を選べます。

自分だけに適用する「User」、共同作業者全員に適用する「Project」、自分だけがこのリポジトリで使う「Local」の3種類です。

/plugin install github@claude-plugins-official

一覧確認・有効化・無効化・削除は次のコマンドで行い、変更をセッションに反映させるには/reload-pluginsを実行します。

/plugin list
/plugin disable github@claude-plugins-official
/plugin enable github@claude-plugins-official
/reload-plugins

自作の基本:plugin.jsonとディレクトリ構成

自作プラグインは、.claude-plugin/plugin.jsonというマニフェストファイルを持つディレクトリとして作成します。

plugin.jsonにはプラグイン名・説明・バージョンを記述し、スキルやhooksなどのディレクトリはルート直下に置きます(.claude-plugin/の中に入れてしまうのはよくある間違いです)。

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── hello/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
└── .mcp.json
{
  "name": "my-plugin",
  "description": "チーム共通のワークフローをまとめたプラグイン",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

動作確認はマーケットプレイス登録なしで--plugin-dirフラグを使えます。

claude --plugin-dir ./my-plugin

問題なければmarketplace.jsonをGitリポジトリでホストして/plugin marketplace addできるようにするか、コミュニティマーケットプレイスの審査提出フォームから公開します。

セキュリティ上の注意点

プラグイン導入を判断する分岐図。配布元が信頼できる場合は公式マーケットプレイスや審査済みコミュニティ配布として導入してよいが、出所不明・検証されていない配布元やproject/managedスコープの中身を未確認の場合は導入を避けるべきことを示す図解

つまずきポイント/よくあるエラー

バグイヌバグイヌ

インストールしようとしたらMarketplace "xxx" not foundと出るんですが、何を先にやり忘れているんでしょう?

ハブネコハブネコ

マーケットプレイス自体をまだ登録していない状態です。/plugin marketplace addで先に追加してから/plugin installを実行してください。

よくある質問

プラグインと.claude/ディレクトリへの直接設定はどう違いますか?

どちらもスキルやhooksを追加できますが、.claude/への直接設定は基本的にそのプロジェクト内だけの個人設定です。プラグインはマーケットプレイス経由で共有でき、バージョン管理や一括更新がしやすい違いがあります。

プラグインの利用に料金はかかりますか?

プラグイン自体のインストールは無料ですが、同梱されるMCPサーバーが外部サービスの有料プランやAPIキーを必要とする場合があります。料金体系は変わりやすいため公式サイトで最新情報を確認してください。

自作したプラグインを社内だけに配布できますか?

できます。マーケットプレイスをプライベートなGitリポジトリでホストし、チームメンバーだけが/plugin marketplace addできる状態にすれば社内限定で配布できます。

ハブネコ

ハブネコのひとこと

プラグインは配布が手軽な分、任意のコードを実行できる強い権限を持つ点は忘れずにいたいです。出所不明のものより、まず公式や審査済みの配布元から試すのが無難だと感じます。

まとめ

Claude Codeのプラグインは、スキル・エージェント・hooks・MCPサーバーをまとめて配布する仕組みです。

/plugin marketplace addでマーケットプレイスを追加し、/plugin installで導入・有効化する流れを押さえれば、公式やコミュニティの機能をすぐに使い始められます。

自作する場合はplugin.jsonを中心とした構成を守り、--plugin-dirでローカル検証してから配布しましょう。信頼できる配布元かどうかは必ず確認し、不要なプラグインはこまめに無効化してください。

関連情報は「Claude Code設定完全ガイド」「MCP設定方法」「Skillsの作り方」もあわせて参考にしてください。