HOME / ブログ / AIサービス

AIサービス

Claude Codeの「プラグイン」とは?機能をまとめて追加・共有するしくみ

Claude Codeの機能を調べていると、「プラグイン」という言葉が出てきます。スキルやフック、MCPとは何が違うのか、入れて大丈夫なのか、気になる方も多いと思います。

この記事では、公式ドキュメントの内容にもとづいて、プラグインのしくみを整理します。一言でいうと、プラグインは「スキル・サブエージェント・フック・MCPサーバーなどを、1つにまとめて入れられる入れ物」です。

プラグインとは、機能をひとまとめにしたもの

公式ドキュメントでは、プラグインを「スキル、サブエージェント、フック、MCPサーバーなどのディレクトリ(フォルダ)を、1つの単位としてインストールして読み込むもの」と説明しています。

プラグインがスキル・サブエージェント・フック・MCPサーバーをひとまとめにする入れ物であることを示した図

大事なのは、スキルやフックなどは、プラグインなしでも単独で使えることです。たとえば自分用のスキルを置いておけば、どのプロジェクトでも使えます。公式ドキュメントでは、複数の機能をひとまとめにして配りたいときにプラグインを使う、という位置づけです。

それぞれの機能については、次の記事で整理しています。

プラグインの中身

プラグインの中には、次のようなものを入れられます。

入れられるもの役割
スキル必要なときに読み込まれる指示書(`SKILL.md`)。コマンドとして呼び出すこともできる
サブエージェントClaude Codeが作業を任せられる助手の定義
フック決まった場面で実行される処理
MCPサーバープラグインが有効な間、つながる外部ツールの窓口

このほか、公式のリファレンスには、出力スタイルやLSPサーバーなどの項目も載っています。

フォルダの構成は、プラグインの目印となる `.claude-plugin/plugin.json`(名前などを書くファイル)のほか、`skills/` や `agents/`、`hooks/hooks.json`、`.mcp.json` といった決まった場所に置きます。リファレンスによると、`plugin.json` は省略もでき、必須の項目は `name`(名前)だけです。ただし、`plugin.json` 以外のファイルは `.claude-plugin/` の中ではなく、プラグインの一番上の階層に置くとされています。

入れ方:マーケットプレイスと /plugin

プラグインの多くは「マーケットプレイス」から入れます。公式ドキュメントによると、マーケットプレイスは「どのプラグインがあるか、どこから取ってくるかを並べたカタログ」で、商品が置かれた店のようなものではありません。

Anthropicの公式マーケットプレイス(`claude-plugins-official`)は、対話で使う画面を初めて起動したときに自動で追加されます。ただし、組織の管理設定で止められている場合は除きます。

操作は、Claude Codeの中で `/plugin` と入力するのが基本です。

  • `/plugin` を入力すると、プラグインを探す画面(Discoverタブ)が開く
  • `/plugin install 名前@マーケットプレイス名` で導入する(実行すると、その場で入るのではなく、詳細画面が開いて範囲を選べる)
  • 有効化・無効化・削除は `/plugin enable`、`/plugin disable`、`/plugin uninstall`
  • 入れたあとに反映されないときは `/reload-plugins`

入れたプラグインのスキルは、プラグイン名が頭に付いた形(例:`/commit-commands:commit`)で呼び出します。名前がぶつからないようにするためのしくみです。

「誰に効くか」は3つの範囲から選ぶ

プラグインを入れるときは、効かせる範囲(スコープ)を選びます。

範囲効く人・場所保存先
ユーザー自分。このパソコンのすべてのプロジェクト`~/.claude/settings.json`
プロジェクトそのリポジトリで作業する全員`.claude/settings.json`
ローカル自分だけ。そのリポジトリのみ`.claude/settings.local.json`

複数の範囲で設定した場合は、ローカルがプロジェクトより、プロジェクトがユーザーより優先されます。なお、プロジェクトの範囲で入れても、一緒に作業する人は自分でインストール(`claude plugin install` に `–scope project` を付ける)する必要があるとされています。

設定ファイルそのものの優先順位は、次の記事で整理しています。

使う前に知っておきたい注意点

1. プラグインは、自分の権限でプログラムを動かせる

公式ドキュメントには、「入れたプラグインは、ユーザーの権限でコードを実行できる」と書かれています。プラグインはフックやMCPサーバーを動かせるため、インストール前に画面に出る内容を読むよう案内されています。マーケットプレイスは、公式、コミュニティ、それ以外(サードパーティ)に分かれており、出どころの分からないものを何となく入れるのは避けたいところです。

2. 有効にしているだけで、毎回の会話の分を使う

有効なプラグインは、使っていないセッションでも読み込まれます。Claudeが自動で呼べるスキルなどは、名前と説明が毎回の会話の文脈に入り、その分の利用量(トークン)を消費して、使える余裕を少し減らします。スキルの全文は、使われたときだけ読み込まれます。

入れたあとは、`claude plugin details プラグイン名` で、常に読み込まれる分の量を確認できます。使っていないプラグインは、無効化や削除で整理しておくと安心です。

3. 似た名前の別のものと混同しない

公式ドキュメントでは、VS Codeの拡張機能やJetBrainsのプラグイン、claude.aiのプラグインは、Claude Codeのこのプラグインとは別のものだと説明されています。調べるときは、どのプラグインの話なのかを確認してください。

自分で作って試すこともできる

自分で作ったプラグインは、`–plugin-dir` を付けてClaude Codeを起動すると、インストールせずにそのセッションだけ読み込めます。作ったものの形式チェックには `claude plugin validate ./フォルダ名` が使えます。チームや社内で配りたい場合は、マーケットプレイス用のファイルを用意して配布する方法が紹介されています。

作り方の詳細は、この記事では扱いません。必要になったときに、公式ドキュメントの「Plugins」の章をご覧ください。

よくある疑問

スキルやフックを個別に使うのと、どちらがいい?

自分1人で、1つ2つの機能を使うだけなら、個別に置くだけで足ります。複数の機能を1セットにして、別のプロジェクトや他の人にも同じ形で渡したいときに、プラグインが向いています。

プラグインは必ず入れないといけない?

入れなくても、Claude Codeは使えます。必要になったときに追加すれば十分です。

導入や設定が不安な場合は?

当社では、Claude Codeの説明から導入までをサポートしています。やりたいことを伝えていただければ、設定は当社で行います。見積りはヒアリングのうえ、個別に対応します。

まとめ

Claude Codeのプラグインは、スキル・サブエージェント・フック・MCPサーバーなどを、1つにまとめて入れたり配ったりできる入れ物です。単独でも使える機能を、セットにして使い回すためのしくみといえます。

便利な反面、プラグインは自分の権限でプログラムを動かせること、有効にしているだけで毎回の会話の分を使うことには注意が必要です。出どころを確認し、使うものだけを入れるのが基本です。

無料で相談する