プラグイン
信頼できるセットアップは、チーム全体で使うようになって初めて本当の価値を発揮します。問題はそれをどう持ち運ぶかです。Skills、サブエージェント、フックを備えた優れた .claude ディレクトリを作ったとして、その後どうするでしょうか。みんながファイルをコピー&ペーストしてマシン間でやり取りし、同期が保たれていることを願うことになります。プラグインはそれを解決します。プラグインとは、Claude Codeがセットアップをパッケージ化し、ある人から次の人へと移動させる仕組みです。
これには2つの側面があり、両方を扱います。まず、他の人が公開しているプラグインを使う側。次に、共有する価値のあるものを作った後に、自分のものをパッケージ化する側です。
プラグインとは
プラグインは1つのインストール可能な単位です。本来であれば手作業で共有するものすべて、つまりSkills、サブエージェント、フック、MCPサーバー設定に加えて、言語サーバープロトコルサーバー、バックグラウンドモニター、テーマといった、さらに長いリストの項目をひとまとめにしています。バージョンは1つ、インストールも1つです。
プラグインがどこにあるかによって、インストール方法が決まります。セッション内からなら、名前を指定して直接インストールできます。
/plugin install github@claude-plugins-officialこのコマンドはまずプラグインの詳細を開くので、内容を確認してスコープを選択できます。その後Claude Codeがインストールを行い、簡単なサマリーを表示します。表示内容は、プラグインがこのセッションですでに有効になっていると伝えるか、あるいは /reload-plugins に言及し、Claude Codeがそのリロードを代わりに実行するかのいずれかです。リロードが「次のメッセージで会話全体を再読み込みすることになる」と警告してきた場合にのみ、自分で /reload-plugins --force を実行してプラグインを有効化する必要があります。
チーム用のマーケットプレイスを追加する
チームの場合、より良い方法はプライベートマーケットプレイスを一度だけ追加することです。マーケットプレイスとは、プラグインが解決先とする共有ソースのことです。
/plugin marketplace add your-org/claude-plugins名前は好きに付けて構いません。一度追加すれば、それ以降のすべてのインストールはそこを通じて解決されます。これにより、全員のノートパソコンに散らばる代わりに、一元化されたディスカバリー、バージョン管理、アップデートが1か所に集約されます。
利用可能なプラグインはDiscoverタブから閲覧できます。そこには自分のマーケットプレイス上のプラグインが一覧表示されるので、検索して選ぶことができます。
インストール前に読む
ここが最も重要な部分です。プラグインは自分のマシン上で、自分の権限でコードを実行します。そのフックは、条件に一致するすべてのツール呼び出しで発火します。つまり、あるプラグインをSkills目的でインストールすると、読んだかどうかにかかわらず、そのPreToolUseフックとStopフックも一緒に手に入れることになります。
これが何を意味するか考えてみてください。コミュニティ製のプラグインが、毎回ネットワークエンドポイントを呼び出すStopフックを組み込んでいる可能性があり、自分の設定の中にはそれについて警告してくれるものは何もありません。だからといってプラグインを避ける理由にはなりません。先に中身を確認すべき理由になるだけです。
インストールする前に、プラグインの詳細を確認してください。Claude Codeは何がインストールされるかを表示し、コンテキストコストを見積もり、さらにAnthropicはサードパーティ製プラグインの中身を管理していないという明確な警告も表示します。
プラグインの出所について知っておくべきことが2つあります。
- プラグインがコミュニティマーケットプレイスに載るのは、それを書いた人がAnthropicに送ったからです。
- 公式マーケットプレイスは、それとは別の独自の審査プロセスでキュレーションされています。
しかし、掲載されていることと信頼できることは同じではありません。したがって、原則は変わりません。プラグインのインストールやマーケットプレイスの追加は、本当に信頼できるソースからのみ行い、有効化する前にそのプラグインが実際に何をするのかを確認してください。
コンポーネントは自分のものと並行して動作する
プラグインは自分の設定を上書きしません。そのコンポーネントは自分自身のものと並行して動作します。これはおおむね良いことですが、理解しておくべき影響もあります。
フックは積み重なります。プラグインのPreToolUseフックと自分のPreToolUseフックは、どちらもすべてのツール呼び出しで発火します。どちらかがもう一方を置き換えることはありません。だからこそ、まず詳細を読むことが重要なのです。
Skills、エージェント、コマンドはプラグイン名の下に名前空間化されるため、自分のものと衝突することはありません。
プラグインをインストールすると、追加されたものすべてを確認し、管理し、プラグインパネルからアンインストールできます。
自分のプラグインをパッケージ化する
では、もう一方の側面です。動作する .claude ディレクトリを構築したら、チームにマシン間でそれをコピー&ペーストさせてはいけません。代わりにパッケージ化しましょう。
良いニュースは、何も書き直す必要がないことです。.claude ディレクトリの各パーツを、プラグイン専用のフォルダにコピーするだけです。
svg-splitter-review/
├── .claude-plugin/plugin.json
├── skills/<skill-name>/SKILL.md
├── agents/<agent-name>.md
├── hooks/hooks.json
└── .mcp.jsonフックは settings.json から外れる唯一の要素です。hooks オブジェクトを hooks/hooks.json にコピーしてください。残りはClaude Codeが規約に従って自動的に見つけます。共有する前にプラグインを試すには、そのフォルダを指定してセッションを開始します。
claude --plugin-dir ./svg-splitter-review動作を確認できたら、.claude 内の元のファイルを削除し、settings.json から hooks オブジェクトを取り除いてください。それをするまでは、各フックが2回ずつ実行されてしまいます。
マニフェスト
それに加えて、任意のマニフェストがあります。これは .claude-plugin/plugin.json に置かれ、名前、バージョン、説明、作者を保持します。
{
"name": "svg-splitter-review",
"version": "0.1.0",
"description": "Reviews the SVG Splitter repo",
"author": {
"name": "Lewis Menelaws"
}
}マニフェストは任意です。省略しても、Claude Codeはディレクトリの規約に従って自分のコンポーネントを検出し続けます。ただし、いくつか知っておくべき点があります。
- 名前だけが必須フィールドです。 これによってSkillsが
/plugin-name:skill-nameという形で名前空間化されるため、このプラグイン内のSkillは/svg-splitter-review:<skill-name>として実行されます。これにより、自分のSkillsが他の誰かのものと衝突することがなくなります。 - 他の依存関係と同じようにバージョン管理してください。 そうすることで、チーム全体でのアップデートとバージョン追跡が機能するようになります。
まとめ
ここまでの内容は、2つのシンプルなルールに集約できます。
- プラグインを使う側になったら、インストールする前に読むこと。プラグインは自分の権限でコードを実行するので、まずそのフック、エージェント、MCPサーバーを確認してください。
- プラグインを作る側になったら、動作した瞬間に
.claudeをパッケージ化すること。1つのマニフェスト、1つのインストールです。
それがすべての要点です。1つのインストール可能な単位があれば、信頼できるセットアップはチーム全体に行き渡ります。