Claude Code のプラグインは、スキル・フック・MCP サーバーなどを 1 つの単位として配る仕組みです。本稿では、カスタムスキルをプラグインにしてチームに配るときに、運用上の手当てが必要になる性質を公式ドキュメントの記述で確認し、それに対する運用指針をまとめます(2026-11-12 検証)。
プラグインは 1 つの単位としてインストール・ロードされる
A Claude Code plugin is a directory of skills, agents, hooks, MCP servers
プラグインは、スキル・エージェント・フック・MCP サーバーなどを入れたディレクトリで、Claude Code はこれを 1 つの単位としてインストール・ロードします。マニフェストはプラグインに名前を与え、版や説明などのメタデータを追加できます。一方で docs は、スキル・サブエージェント・フック・MCP サーバーがプラグインなしでも単体で動くこと、プラグインは複数の要素を 1 つの単位にまとめたいときに使うものであることも明記しています。
有効化したプラグインは全セッションに含まれる
有効化したプラグインは、そのプラグインを使っていないセッションも含めて、すべてのセッションの一部になります。中身の入り方は要素ごとに違います。
the name and description are in Claude's context on every turn
名前と説明は、Claude がその存在を知るために毎ターンコンテキストに入ります。スキルやエージェントの全文は、使われたときにだけロードされます。プラグインが定義する MCP サーバーは有効な各セッションと並行して動き、フックはそれぞれのイベントで発火します。Anthropic の公式マーケットプレイスのプラグインには Context cost の見積もりが表示されます。
アンインストールせずに止めるには、/plugin から、またはシェルで claude plugin disable を使って無効化します。
配布: マーケットプレイスはカタログで、ロードには複数の層がある
It's a catalog, not a hosted store.
マーケットプレイスはカタログであり、ホスト型のストアではありません。Claude Code は、対話型のターミナルセッションを初めて開始したときに Anthropic の公式マーケットプレイスを追加します。コミュニティマーケットプレイスは自動では追加しません。公式名とコミュニティ名を受け付けるのは、特定の取得元から追加したマーケットプレイスに限られます。
開発中のプラグインは、マーケットプレイスを使わずに --plugin-dir でフォルダから直接ロードできます。インストールしたプラグインのスキルを実行できるようにするには、プラグインが複数の層のそれぞれに存在する必要があります。Claude Code が取得・インストールした内容は専用のディレクトリに保持され、プラグインはセッション開始時にロードされます。プロジェクトスコープでインストールしたプラグインは、コミットされた設定を通じて、そのリポジトリで作業する全員に対して有効になります。一方、クラウドセッション(claude.ai/code のブラウザ上のセッションを含む)は、ローカル設定にあるプラグインをロードしません。
信頼境界
マーケットプレイスの区分に関係なく、インストールしたプラグインはユーザー権限でコードを実行できます。組織は、マーケットプレイスの許可リスト化とブロック、プラグインの強制インストール、セッション限定ロードの無効化ができます。
運用指針(筆者の設計上の意見)
- スキルの description は、毎ターンかかる固定費として文字数の上限を決め、CI で測る
- スキルだけのプラグインと、フック・MCP サーバーを持つプラグインを分ける
- 中身を変えたら version を上げることを CI で強制する
- 無効化の手順(個人で止める場合・チーム全体で止める場合)を、配る前に決めておく
- クラウドセッションで使う予定があるなら、クラウド上での見え方を別に確認する