Claude Codeのプラグインとは：仕組みと使い方を解説

Claude Codeのプラグインは、スキル、エージェント、フック、MCPサーバーなどの部品をClaude Codeに追加するフォルダーです。Claude Codeは、Anthropicのコマンドライン型コーディングエージェントです。プラグインは、マーケットプレイスから入手します。マーケットプレイスとは、GitHubリポジトリ、git URL、ローカルフォルダーのいずれかから追加するカタログです。プラグインのインストールに関するAnthropicのガイドは、インストールの前に、そのプラグインが何を追加するのかを確認するよう求めています。プラグインはフックやMCPサーバーを実行できるからです。

このガイドは、2026年11月2日にリリースされたClaude Code 2.1.317に沿って説明します。プラグインに含められるもの、プラグインをインストール・削除するコマンド、組み込みのバリデーターが確認する内容を取り上げます。いずれもMacで試しています。

Claude Codeのプラグインの仕組み

どのプラグインにも、マニフェストがあります。.claude-plugin/plugin.jsonに置く小さなJSONファイルです。Anthropicのプラグイン概要によると、必須なのはnameフィールドだけです。それ以外はすべて任意で、部品ごとに置き場所が決まっています。

部品	置き場所	役割
スキル	skills/<name>/SKILL.md	タスクの指示。/<plugin>:<name>として実行
エージェント	agents/<name>.md	Claudeが作業を任せられる補助エージェント
フック	hooks/hooks.json	ツールの実行前など、決まったタイミングで動くスクリプト
mod	hooks/hooks.json内のmodulesエントリー	ペインを描画したり、コマンドを追加したりできるJavaScript
MCPサーバー	.mcp.json	Model Context Protocolで接続する外部ツール
LSPサーバー	.lsp.json	コードエディターが使うような言語支援ツール

MCP（Model Context Protocol）は、外部のツールをAIエージェントにつなぐための標準的な方法です。modについて、ドキュメントの説明は簡潔です。フックモジュールを持つプラグインは「modと呼ばれる」としています。

プラグインは、マーケットプレイスを通じて届きます。Anthropic自身のマーケットプレイスはclaude-plugins-officialという名前です。初めて対話型のターミナルセッションを始めたときに、Claude Codeが自動で追加します。コミュニティのカタログであるclaude-communityは、自動では追加されません。Claude Codeは、公式とコミュニティのカタログ名を、github.com/anthropics/配下のリポジトリからしか受け付けません。それ以外の場所でホストされたコピーは読み込まれなくなり、「Marketplace is registered from an untrusted source」（マーケットプレイスが信頼されていないソースから登録されています）というエラーが出ます。

プラグインのインストール、有効化、削除の方法

どの操作にも、2つの形があります。Claude Codeのセッション内で使う/pluginコマンドと、通常のターミナルで使うclaude pluginコマンドです。次の表は、Anthropicのドキュメントとバージョン2.1.317のヘルプテキストをまとめたものです。

操作	セッション内	ターミナル
マーケットプレイスの追加	/plugin marketplace add <source>	claude plugin marketplace add <source>
インストール	/plugin install <plugin>@<marketplace>	claude plugin install <plugin>@<marketplace>
オン・オフの切り替え	「Installed」タブを開き、スペースキーを押す	claude plugin enable <plugin>またはdisable
更新	「Installed」タブを開き、「Update now」を選ぶ	claude plugin update <plugin>
削除	「Installed」タブを開き、「Uninstall」を選ぶ	claude plugin uninstall <plugin>
詳細の確認	「Installed」タブ	claude plugin details <name>

セッション内の/plugin installは、すぐにはインストールしません。詳細パネルが開くので、先にプラグインを確認し、スコープを選べます。ターミナルのコマンドは、すぐにインストールします。--scopeを付けない限り、スコープはユーザーになります。

スコープは、誰がプラグインを使えるかを決めます。

• ユーザー（user）は~/.claude/settings.jsonに書き込み、自分のマシンのすべてのプロジェクトでプラグインを有効にします。
• プロジェクト（project）は.claude/settings.jsonに書き込みます。これは、コミットして共同作業者と共有するファイルです。
• ローカル（local）は.claude/settings.local.jsonに書き込み、1つのリポジトリの中で自分だけに適用されます。

スコープ同士が食い違う場合は、ローカルがプロジェクトより優先され、プロジェクトがユーザーより優先されます。組織が管理する設定は、この3つすべてより優先されます。すべてのプラグインを一度に更新する単一のコマンドはありません。また、/reload-pluginsを使うと、実行中のセッションに変更が反映されます。Anthropicの公式マーケットプレイスでは更新が自動で届きますが、サードパーティのマーケットプレイスでは既定でオフになっています。

プラグインのコマンドを実際に試す

Tech AI WireがmacOS 26.6.2上のClaude Code 2.1.317で行ったテストでは、claude plugin --helpを実行すると、configureからvalidateまで15個のサブコマンドが表示されました。次の3つのコマンドを使うと、プラグインがプロジェクトに手を加える前に、何をするのかが分かります。

claude plugin details cc-plugin-you-should-know@builtin
claude plugin validate ./hello-check
claude plugin validate ./broken-check

1つ目のコマンドでは、Claude Code 2.1.287で登場した、任意で有効にするサイドエージェント「You should know」を調べました。スキル、エージェント、フック、MCPサーバー、LSPサーバーは、いずれも0件でした。常時かかる見込みのコストは「~0 tok added to every session」（すべてのセッションに約0トークンを追加）と表示されました。

2つ目のコマンドでは、最小限のテスト用プラグインを確認しました。名前、バージョン、説明を書いたマニフェストに、スキルを1つ加えたものです。結果は合格で、警告は作者の情報がないという1件だけでした。一方で、Anthropicのプラグインディレクトリへの申請を妨げる問題も2つ挙がりました。40語以上のREADME.mdがないことと、LICENSEファイルもlicenseフィールドもないことです。アイコンがないことは、警告にとどまりました。アイコンは正方形のPNGかJPEGで、1辺が512〜2,048ピクセル、サイズが2MB未満である必要があります。

3つ目のコマンドでは、同じプラグインからnameフィールドを削除して試しました。検証は終了コード1で失敗し、「name: Invalid input: expected string, received undefined」（name：入力が無効です。文字列が必要ですが、undefinedを受け取りました）というメッセージが出ました。ディレクトリ向けのチェックで結果が変わるのは、--profile directoryを付けたときだけです。ツールは、ディレクトリでは「runs a safety scan and a policy review that this command does not」（このコマンドが行わない安全性スキャンとポリシー審査を実施する）とも注記しています。

何がいつ変わったか

プラグインの機能は、9月以降、途切れることなく続くリリースで追加されてきました。以下の日付は、各バージョンがJavaScriptのパッケージレジストリであるnpmに公開された日です。

バージョン	公開日	プラグインに関する変更
2.1.273	2026年9月15日	claude.aiでホストされたマーケットプレイスを追加できるように
2.1.275	2026年9月17日	マーケットプレイスの追加とインストールを、セッション内の1つのコマンドで
2.1.287	2026年10月1日	Claude Modsとサイドエージェント「You should know」
2.1.292	2026年10月6日	同じ1ステップのインストールを、ターミナルからも
2.1.302	2026年10月16日	リフレッシュのたびにマーケットプレイスが再クローンされる問題を修正
2.1.317	2026年11月2日	plugin-authoringスキルが、動作するmodの共有を手伝うと申し出るように

マーケットプレイスは、攻撃の標的にもなります。10月29日には、改ざんされたClaude Code拡張機能のビルドがCursorのマーケットプレイスに約11時間置かれ、SSH鍵を追加しました。これはエディターの拡張機能で、Claude Codeのプラグインではありません。それでも、カタログを信頼することについての教訓は同じです。

開発者にとっての意味

プラグインは、ダウンロードするほかのコードと同じように扱いましょう。Anthropicのプラグインのセキュリティに関するページによると、プラグインは「あなたのマシン上で、あなたのユーザー権限を使って任意のコードを実行できる」とされています。さらに同じページは、権限ルールとサンドボックスが「Claudeが行うツール呼び出しを対象とするもので、プラグインが自ら実行するコードは対象外」だと付け加えています。詳細ペインにある「Will install」（インストールされるもの）の一覧を読みましょう。そのうえで、インストールする前に、hooks/hooks.jsonと.mcp.json、それにbin/フォルダーがあればその中身を確認してください。

コストも確認しましょう。claude plugin detailsは、プラグインがすべてのセッションに追加するトークン数を表示します。そのため、重いプラグインは、有効にする前に簡単に見つけられます。

チームで使う場合は、リポジトリの.claude/settings.jsonにextraKnownMarketplacesとenabledPluginsを書き、コミットしてください。これらの項目が適用されるのは、Claude Codeが信頼しているフォルダーの中だけです。外部のソースから入れるプラグインについては、それでもチームメンバーがインストールコマンドを一度実行する必要があります。

企業は、管理対象の設定を使って、さらに踏み込めます。strictKnownMarketplacesの許可リストで、読み込むカタログを制限できます。リストを空にすると、Anthropic自身のものも含め、すべてのソースがブロックされます。管理対象のenabledPluginsでプラグインをfalseに設定すると、そのプラグインはすべてのスコープでブロックされます。

社内用のカタログは、GitHubに置かなくてもかまいません。LiteLLMのドキュメントは、LiteLLMのAIゲートウェイがカタログを配信する例を示しています。管理者がプラグインを選び、エンジニアはclaude plugin marketplace addコマンドを1回実行するだけでカタログを追加できます。同じページは、カタログのアクセスキーをプロジェクトの.claude/settings.jsonに入れないよう警告しています。このファイルは、リポジトリにコミットされることが多いからです。

プラグインの作者は、申請する前にclaude plugin validate --profile directoryを実行しましょう。Tech AI Wireのテストでは、READMEがないこととライセンスがないことが、ディレクトリに拒否される2つの問題でした。