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

公開: 2026年8月2日

Claude Codeのプラグインは、スラッシュコマンド(スキル)・サブエージェント・hooks・MCPサーバーをひとつにまとめて配布できる仕組みです。/pluginコマンドでマーケットプレイスを追加し、個別のプラグインをインストール・有効化するだけで、チームやコミュニティが作った機能をすぐに使い始められます。導入手順と代表例、plugin.jsonを使った自作の基本、セキュリティ上の注意点を解説します。

前提・動作環境

この記事はターミナル版のClaude Codeを対象にしています。/pluginが表示されない場合は最新版に更新してください。設定ファイル全体の使い分けは「Claude Code設定完全ガイド」を参照してください。

claude --version

2.1.211 (Claude Code)

プラグインとは何か

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

プラグインのスキルは/プラグイン名:スキル名のように名前空間が付くため、複数入れても衝突しません。スキルの作り方は「Skillsの作り方」、同梱するMCPサーバーの設定方法は「MCP設定方法」で解説しています。プラグインは新機能そのものではなく、既存のスキル・エージェント・MCPサーバーを「配布しやすくまとめる器」と考えるとイメージしやすいです。

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

プラグインはマーケットプレイス(カタログ)経由で配布されます。導入は「マーケットプレイスを追加する」→「個別のプラグインをインストールする」の2段階です。

公式の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できるようにするか、コミュニティマーケットプレイスの審査提出フォームから公開します。

セキュリティ上の注意点

信頼できる配布元だけを導入する: プラグインとマーケットプレイスはユーザー権限で任意のコードを実行できる強い権限を持ちます。Anthropicは配布内容をすべて検証しているわけではないため、出所不明のものは避けてください。
project/managedスコープの中身を確認する: .claude/settings.json経由でチームに配布される設定は、意図しないプラグインを自動インストールする場合があります。導入前に内容を確認しましょう。
不要になったら無効化・削除する: 使わないプラグインはコンテキストコストがかかり続けるため、/plugin disableなどでこまめに整理するのがおすすめです。

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

/pluginコマンドが見つからない: バージョンが古い可能性があります。claude --versionで確認し最新版に更新してください。
Marketplace "xxx" not found: マーケットプレイス未追加です。/plugin marketplace addで先に登録してから/plugin installを実行します。
インストールしたプラグインが見つからない: ローカルのカタログが古い可能性があります。/plugin marketplace update <marketplace-name>で最新化してください。
スキルが反映されない: /reload-pluginsを忘れていないか確認し、改善しなければ~/.claude/plugins/cacheを削除して再インストールします。

よくある質問

プラグインと`.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の作り方」もあわせて参考にしてください。