著者 Claude Code プラグインとは？料金と導入方法
Claude Code プラグインの仕組み、保存場所、インストール方法を解説します。仕組み自体は無料ですが、読み込む内容に応じてトークンを消費します。
Claude Code プラグインとは
Claude Code プラグインは、Claude Code が 1 つの単位として読み込み、管理するコンポーネントのディレクトリです。コンポーネントには、skills、agents、hooks、MCP servers、LSP servers、background monitors があります。プラグインをインストールすると、すべてのコンポーネントが 1 つの名前でまとめて追加されます。無効化すると、同じ単位で削除されます。
プラグインによって、エージェントが本来持っていなかった能力を得るわけではありません。プラグイン内の各コンポーネントは、.claude/ ディレクトリに手動で作成できるものです。プラグインはパッケージング層です。各コンポーネントにバージョンを付け、15 人に配布し、全員にファイルのコピーを依頼せずに後から更新できます。これがプラグインの役割です。プラグインに関する混乱の多くは、プラグインを新しい種類の機能だと考えることから生じます。
.claude-plugin/plugin.json にあるオプションのマニフェストでプラグイン名を指定します。この名前が名前空間になります。commit-commands という名前のプラグインに含まれる skill は、/commit-commands:commit として呼び出します。そのため、2 つのプラグインがそれぞれ commit という名前の skill を提供しても、一方が他方を隠すことはありません。プラグインの agents も同じ方法でスコープが設定され、@-mention リストでは plugin-name:agent-name として表示されます。
プラグイン、スキル、MCP server、またはルールファイル
これら4つの用語は、あたかも互いに競合するものとして使われます。しかし実際には競合せず、その違いを一度整理しておく価値があります。
- スキルは、タスクで必要になったときに Claude が読み込む1単位の指示です。Agent Skill とは何かを参照してください。
- MCP server は、プロトコル経由でエージェントにツールを公開する独立したプロセスです。多くの場合、自分で運用するネットワークサービスです。
CLAUDE.mdなどのルールファイルは、セッション開始時に読み込まれ、すべての処理に適用されるプロジェクトコンテキストです。- プラグインは、スキル、エージェント、フック、MCP server の定義をまとめて格納できるコンテナです。バージョン番号と配布チャネルも含められます。
したがって、プラグインが答える問いは「エージェントに何ができるか」ではありません。「これをチームにどう配布し、来月どのように更新するか」です。最初の3つから選ぶ場合は、スキル、MCP server、ルールファイルの比較で判断の詳細を確認できます。MCP の部分に関心がある場合は、VPS で独自の MCP server を運用する方法でホスティングについて説明しています。
プラグインの配置場所と内部構成
マーケットプレイスからインストールしたプラグインは、クローンした場所から実行されるのではなく、~/.claude/plugins/cache のローカルキャッシュにコピーされます。インストールしたバージョンごとに専用のディレクトリが作成されます。更新またはアンインストールを行うと、古いバージョンのディレクトリは孤立したものとしてマークされ、約 2 週間後に削除されます。そのため、すでに古いバージョンを読み込んだセッションは、タスクの途中で失敗せずに処理を続けられます。
更新のたびにパスが変わるため、プラグインで自身の場所をハードコードしてはいけません。プラグイン内のフックと MCP 設定では ${CLAUDE_PLUGIN_ROOT} を使用します。これは現在のインストールディレクトリに解決されます。更新後も保持する状態は ${CLAUDE_PLUGIN_DATA} に保存します。これは ~/.claude/plugins/data/ の下にある安定したディレクトリに解決されます。
キャッシュにコピーされるのは、プラグイン自身のディレクトリだけです。この点が、後から問題になることがあります。../shared-utils のようにプラグインのルート外を指すパスは、ローカルパスを使って開発している間は動作します。しかし、インストール後は、それらのファイルがコピーされていないため失敗します。
ディレクトリ構成は次のようになります。
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/plugin.json だけが .claude-plugin/ の内部に入ります。それ以外はすべてプラグインのルートに配置します。skills/ または hooks/ を .claude-plugin/ の内部に配置すると、プラグインのインストールは正常に完了するのに、何も動作しなくなることが最も多くあります。Claude Code はこれらのディレクトリをルートで探しますが、見つからないため、コンポーネントのないプラグインを読み込みます。
マニフェスト自体は小規模です。
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}Claude Code プラグインのインストール方法
インストールは 2 つの手順で行います。最初の手順では何もインストールしません。プラグインのカタログであるマーケットプレイスを追加し、そこから個別のプラグインをインストールします。Anthropic の公式マーケットプレイスである claude-plugins-official は、Claude Code を初めて対話的に起動したときに登録されます。その他のマーケットプレイスは自分で追加します。
/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-pluginsリポジトリは anthropics/claude-code ですが、マーケットプレイスの名前は claude-code-plugins です。この名前はリポジトリのパスではなく、リポジトリ内のカタログファイルに由来します。そのため、インストールコマンドを入力する前に、/plugin の Marketplaces タブでマーケットプレイス名を確認してください。
インストール後は、概要行を確認します。Plugin is now active. は、コンポーネントがこのセッションに読み込まれたことを示します。Run /reload-plugins to activate. は読み込まれていないことを示すため、そのコマンドを実行してください。/reload-plugins が会話を再読み込みすると警告する場合は、/reload-plugins --force として再実行します。続いて、プラグインが実際に存在することを確認します。/plugin では Installed タブにプラグインが表示され、/help では Custom commands にそのスキルが一覧表示されます。読み込みに失敗したものは、理由とともに Errors タブに表示されます。
インストール時にはスコープを指定します。スコープによって、誰がプラグインを利用できるかが決まります。User スコープは自分だけが対象で、すべてのプロジェクトで利用できます。Project スコープでは、リポジトリの .claude/settings.json 内にある enabledPlugins へプラグインが書き込まれるため、リポジトリを clone した全員にインストールが提示されます。Local スコープは、自分がこのリポジトリだけで利用する設定です。
スクリプト、Dockerfile、または対話的なパネルを利用できないセッションでは、代わりに shell 形式を使用します。--scope を渡さない限り、User スコープにインストールされます。
claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin listclaude plugin install はセッションの外部で実行されます。そのため、すでに開いているセッションでは、/reload-plugins を実行するか新しいセッションを開始するまで、新しいプラグインは認識されません。
インストール済みのプラグインを管理する方法は、どちらの場合も同じです。/plugin list はインストール済みの項目を表示し、--enabled または --disabled を受け付けます。/plugin disable name@marketplace はプラグインを削除せずに無効化し、/plugin enable は再び有効化します。/plugin uninstall はプラグインを削除します。スラッシュコマンド形式ではプラグインパネルが開いて変更が適用されるため、スクリプトでは claude plugin ... の shell 形式を使用してください。
マーケットプレイスをチーム全体に提供するには、プロジェクトの .claude/settings.json に追加します。メンバーはリポジトリフォルダーを信頼すると、1 回だけインストールを求められます。
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}独自のプラグインを開発している間は、マーケットプレイスを使用しないでください。claude --plugin-dir ./my-plugin はそのセッション用にディレクトリを読み込み、/reload-plugins は再起動せずに編集内容を反映し、claude plugin validate ./my-plugin はマニフェスト、skill と agent の frontmatter、および hooks/hooks.json を他のユーザーが利用する前に検証します。
Claude Code プラグインの費用はいくらですか？
仕組み自体は無料です。2026 年 8 月現在、marketplace の追加、プラグインのインストール、有効な状態での維持に料金はかかりません。公式およびコミュニティの marketplace は公開 git リポジトリであり、プラグインはテキストファイルのディレクトリです。
プラグインで発生するコストはトークンです。トークンは、実際にサブスクリプションの使用量や API 請求額として計測されます。このコストは 3 つの形で発生し、それぞれ挙動が異なります。
常時発生するコンテキストコスト。 プラグインが追加する内容はコンテキストに入り、セッションの各ターンで再読み込みされます。インストール前に、/plugin の詳細ビューで Context cost のトークン見積もりを確認できます。追加されるコマンド、スキル、エージェント、フック、MCP サーバー、LSP サーバーを示す Will install セクションも表示されます。両方を確認してください。ローカルまたはカスタム marketplace のプラグインでは、この情報が提供されないことがあるため、その場合は手作業で見積もります。MCP サーバーを含むプラグインは、通常、最も負荷が大きくなります。ツール定義が大きいためです。ただし、MCP tool search に対応するモデルでは、ツールが必要になるまで定義の読み込みが延期されます。
呼び出しコスト。 プラグインのスキルを実行すると、その指示が会話に追加されるため、スキル本体のコストは使用時にだけ発生します。エージェントは異なります。サブエージェントは、独自のシステムプロンプトと独自のキャッシュを持つ別の会話を実行し、キャッシュヒットがない状態で開始します。そのため、ワークフローがエージェントを起動するプラグインは、コンテキストの見積もりから想定されるよりも大幅にコストが高くなります。
キャッシュコスト。 セッション途中でプラグインを有効化または無効化すると、次のリクエストで会話全体の再処理が必要になることがあります。スキル、コマンド、エージェント、フック、LSP サーバー、モニター、テーマではこの動作は発生しません。追加内容は既存の履歴の後に追加されるため、次のリクエストでは新しい内容のコストだけが発生し、それ以前の内容はすべてキャッシュから読み込まれます。例外は、MCP サーバーを提供するプラグインです。tool search によってツールの読み込みが延期される場合、キャッシュは維持されます。ツールが prompt prefix に読み込まれる場合、次のリクエストでは会話全体がキャッシュされていない入力として再読み込みされます。そのため、/reload-plugins は警告を表示し、--force を渡すまでその場合の操作を拒否します。
推測せずに、実際の値を確認できます。すべての API レスポンスには cache_read_input_tokens と cache_creation_input_tokens が含まれます。また、トークン使用量をリアルタイムで表示するカスタムステータスラインを使えば、両方の値を常に確認できます。健全なセッションでは、生成するトークンよりもはるかに多くのトークンを読み込みます。ターンごとに生成量が高いままなら、prefix の何かが毎ターン変化しています。コンテキストウィンドウを埋めている要素全体については、Claude Code のコンテキストウィンドウを管理する方法と これらのトークン数が実際に意味することを参照してください。
1 つの整理作業だけでも効果があります。Installed タブでは、少なくとも 2 週間使用していないプラグインが Not used recently ヘッダーの下にまとめられ、詳細ビューには Last used 行が表示されます。これらのプラグインは、すべてのセッションで起動時間とコンテキストを消費します。無効化またはアンインストールしてください。
プラグインはユーザー権限で実行されます
Anthropic の公式ドキュメントにも明記されているとおり、プラグインとマーケットプレイスは、ユーザー権限でマシン上の任意のコードを実行できる、非常に信頼性の高いコンポーネントです。これは仮定の話ではありません。プラグインのフックは、ツール呼び出しの前後を含むセッションイベントで shell コマンドを実行します。プラグインが有効な間は、その bin/ ディレクトリが Bash tool の PATH に追加されます。プラグインの MCP servers は、プラグインが起動するプロセスです。これらはユーザーアカウントから隔離された sandbox 内で実行されるわけではありません。
ラップトップでは、そのリスクはデスクトップユーザーがアクセスできる範囲に限定されます。サーバーでは、通常そうなりません。agent を実行するアカウントは、SSH keys、deploy tokens、cloud CLI session、Docker socket へのアクセス権を持っていることが多いため、「ユーザーとして任意のコードを実行できる」ということは、実質的にマシン全体を操作できることを意味します。Claude Code を VPS で実行する場合は、何かをインストールする前に VPS で Claude Code を安全に実行する方法 を確認してください。また、外部サービスと通信するプラグインをインストールする前に、認証情報を agent の手の届かない場所に保管する方法 を確認してください。
いくつかのガードレールは存在するため、それぞれの範囲を把握しておくと役立ちます。project-scope plugin はユーザー自身ではなく repository に由来するため、workspace を信頼した後にのみロードされます。その MCP servers には server ごとの承認が必要で、LSP servers もその信頼が得られるまで待機します。一方、background monitors はまったくロードされません。プラグインに付属する agents は、hooks、MCP servers、permission mode を宣言できません。Marketplace plugins は cache にコピーされますが、marketplace の外部を指す symlinks はスキップされるため、プラグインがホスト上の任意のファイルを取り込むことはできません。
ただし、これらによってインストールするものを読む必要がなくなるわけではありません。Will install の一覧を確認し、ソースを開いて読めるプラグインを優先してください。チームのプラグインは、自分で管理する marketplace repository に保管してください。また、自分で作成したものには claude plugin validate を実行してください。
FAQ
Claude Code プラグインには追加料金がかかりますか？
いいえ。プラグインシステム、マーケットプレイスの追加、プラグインのインストールに料金はかかりません。費用が発生するのはトークン使用量です。他のコンテキストと同様に、契約プランまたは API の利用額として請求されます。プラグインは毎ターン常駐コンテキストを追加し、そのスキルまたはエージェントが呼び出されるとさらにコンテキストを追加します。また、MCP server を提供する場合は、そのツールがプロンプトプレフィックスに読み込まれるため、キャッシュされない高額なターンが 1 回発生することがあります。インストール前に、/plugin の詳細ビューで Context cost の見積もりを確認できます。
プラグインとスキルの違いは何ですか？
スキルは、単一の指示単位です。プラグインは、スキル、エージェント、hooks、MCP servers、LSP servers、monitors を含められるパッケージです。名前とバージョンを持ち、マーケットプレイスからインストールできます。自分とこのプロジェクトだけで使う場合は、.claude/ にスタンドアロンのスキルを記述します。動作する最小限の変更へエージェントを導く Ponytail のような単一目的のスキルが、その最も明確な例です。1 つのファイルに 1 つのルールだけを記述し、チームでも必要になった時点でプラグインに変換します。他の人も必要とし、時間とともに更新する必要がある場合は、プラグインにします。プラグインのスキルには名前空間が付くため、プラグイン内のスキルは /plugin-name:skill-name ではなく /skill-name として呼び出します。
プラグインはインストールされましたが、スキルが表示されません。何が問題ですか？
まず、インストール概要を確認してください。Run /reload-plugins to activate. と表示された場合、コンポーネントはまだ読み込まれていません。再読み込み時に会話を再読み込みすると警告された場合は、/reload-plugins --force として再実行してください。読み込み済みなのに何も表示されない場合は、/plugin を開き、Errors タブを確認してください。最も多い構造上の誤りは、skills/、agents/、または hooks/ を .claude-plugin/ の中に配置することです。Claude Code はそこを検索しません。プラグインのスキルには名前空間が付くため、/help の Custom commands タブで /plugin-name:skill-name を探してください。最後の手段として rm -rf ~/.claude/plugins/cache を実行し、再起動してから再インストールします。
インタラクティブパネルを使わずにプラグインをインストールできますか？
はい。シェルコマンド claude plugin install name@marketplace を使用してください。--scope project または --scope local を指定しない限り、ユーザースコープにインストールされます。/plugin パネルを利用できないスクリプト、イメージ、非インタラクティブ環境でも動作します。セッションの外部で実行されるため、すでに開いているセッションでは、プラグインを有効にする前に /reload-plugins が必要です。
GitHub で見つけたマーケットプレイスのプラグインをインストールしても安全ですか？
そのリポジトリのインストールスクリプトを自分のユーザー権限で実行する場合と同じように扱ってください。実際、それに近い動作をするためです。プラグインは hooks を通じてシェルコマンドを実行し、Bash tool の PATH に実行ファイルを追加し、MCP servers を起動できます。これらはすべてユーザー権限で実行されます。Anthropic はサードパーティ製プラグインの内容を管理または検証していません。内容を確認できるソースからインストールし、確認前に Will install リストを確認してください。サーバーではラップトップよりも厳格に扱う必要があります。サーバー上のアカウントには通常、盗まれる価値のあるキーやトークンが保存されているためです。