SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

Claude Codeプラグインとは?料金と導入方法

Claude Codeプラグインの正体、保存場所、インストール方法を整理します。仕組み自体は無料ですが、コンテキストに追加する内容に応じてtokensを消費します。

Claude Code プラグインとは

Claude Code プラグインは、Claude Code が 1 つの単位として読み込み、管理するコンポーネント一式を含む 1 つのディレクトリです。主なコンポーネントは skills、agents、hooks、MCP servers、LSP servers、background monitors です。プラグインには、commands、output styles、themes、workflows、および実行ファイルを格納する bin/ ディレクトリも含められます。プラグインをインストールすると、すべての構成要素が 1 つの名前で一括して追加されます。無効化すると、同じ方法ですべて削除されます。

プラグインによって、エージェントが本来持っていなかった機能が追加されることは、ほとんどありません。skills、agents、hooks、MCP servers は、すべて .claude/ ディレクトリに手動で作成できます。例外は、コードインテリジェンス用の language servers と mods です。Claude Code は、これらをプラグインからのみ読み込みます。それ以外について、プラグインはパッケージングのためのレイヤーです。各構成要素をバージョン管理し、15 人に渡し、全員にファイルのコピーを依頼せずに後から更新するための仕組みです。これがプラグインの基本的な考え方です。プラグインを新しい種類の機能だと考えると、混乱しやすくなります。

.claude-plugin/plugin.json にあるオプションのマニフェストでプラグイン名を指定します。その名前が名前空間になります。commit-commands というプラグイン内の skill は /commit-commands:commit として呼び出します。そのため、2 つのプラグインがそれぞれ commit という skill を提供しても、一方が他方を隠すことはありません。プラグインの agent も @-mention リスト内では同じ方法でスコープが設定され、plugin-name:agent-name になります。

プラグイン、スキル、MCP server、または rules file

この4つの用語は、互いに競合するものとして扱われがちです。しかし、実際には異なります。ここで境界を一度整理します。

  • スキルは、タスクで必要になったときに Claude が読み込む1単位の指示です。Agent Skill の実体を参照してください。
  • MCP server は、プロトコル経由でエージェントにツールを公開する別プロセスです。自分で運用するネットワークサービスであることもよくあります。
  • CLAUDE.md のような rules file は、セッション開始時に読み込まれ、すべてに適用されるプロジェクトコンテキストです。
  • プラグインは、skills、agents、hooks、MCP servers、その他のコンポーネントをまとめたディレクトリです。Claude Code はこれを1単位としてインストールし、読み込みます。オプションのマニフェストで名前を指定し、バージョン、説明、その他のメタデータを追加できます。配布はプラグインの一部ではありません。marketplace は、プラグインと各プラグインの取得先を一覧にする別のカタログです。

したがって、プラグインが答える問いは「エージェントに何ができるか」ではありません。「チームにどう配布し、来月どう更新するか」です。最初の3つから選ぶ場合は、skills、MCP servers、rules files の比較で判断基準を詳しく説明しています。MCP に関心がある場合は、VPS で独自の MCP servers を運用する方法でホスティングについて説明しています。

プラグインの配置場所と内部構成

Marketplace プラグインの大半は ~/.claude/plugins/cache のローカルキャッシュにコピーされ、インストール済みの各バージョンに個別のディレクトリが割り当てられます。ローカルパスから追加した Marketplace にある相対パスのプラグインは、その場所から読み込まれます。link モードの command-source プラグインは、ソースディレクトリへのリンクを経由して読み込まれます。コピーされたプラグインを更新またはアンインストールすると、旧バージョンのディレクトリは孤立したものとしてマークされ、約 2 週間後に削除されます。そのため、すでに旧バージョンを読み込んだセッションは、タスクの途中で失敗せずに処理を続行できます。クリーンアップは、少なくとも 1 つのプラグインインストールが記録されている間だけ実行されます。最後のプラグインをアンインストールした後は、別のプラグインをインストールするまで孤立したディレクトリが残ります。

コピーされたプラグインのパスは更新のたびに変わるため、プラグイン自身の場所をハードコードしてはいけません。プラグイン内の Hooks と MCP 設定では ${CLAUDE_PLUGIN_ROOT} を使用します。これは現在のインストールディレクトリに解決されます。更新後も保持する必要がある状態は ${CLAUDE_PLUGIN_DATA} に保存します。これは ~/.claude/plugins/data/ 配下の安定したディレクトリに解決されます。

コピーされたプラグインでは、同じ Marketplace 内の別の場所にあるシンボリックリンクのリンク先を除き、プラグイン自身のディレクトリだけがキャッシュにコピーされます。../shared-utils のようにプラグインのルート外にあるパスを読み取るスクリプトは、ローカルパスを使って開発している間は動作します。しかし、プラグインをキャッシュにコピーすると、これらのファイルはコピーされていないため動作しなくなります。plugin.json でそのように宣言したコンポーネントパスは、さらに早い段階で失敗します。Claude Code は開発中であっても、プラグインのルートから外れるコンポーネントパスを path escapes plugin directory エラーで拒否します。

レイアウトは次のようになります。

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_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL によってブロックされていない限り、Claude Code を初めて対話的に起動したときに登録されます。その他のマーケットプレイスは自分で追加します。

/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-official

マーケットプレイス名はリポジトリのパスではなく、リポジトリ内のカタログファイルから取得されます。そのため、インストールコマンドを入力する前に、/plugin の Marketplaces タブでマーケットプレイス名を確認してください。anthropics/claude-code にある旧 claude-code-plugins マーケットプレイスは非推奨です。新規インストールには claude-plugins-official を使用してください。旧マーケットプレイスからインストール済みのプラグインは公式リポジトリから更新されるため、マーケットプレイスを変更するだけなら commit-commands を再インストールする必要はありません。

インストール後は概要行を確認してください。Plugin is now active. は、このセッションでコンポーネントが読み込まれたことを示します。Run /reload-plugins to apply. は、インストール中に有効化されなかったことを示します。この場合、パネルが閉じ、Claude Code が再読み込みを実行します。再読み込みによって会話を再読み込みするという警告が表示された場合、プラグインは保留状態になるため、/reload-plugins --force として再実行してください。次に、プラグインが実際に存在することを確認します。/plugin では Installed タブにプラグインが表示され、/ と入力すると、そのスキルが /plugin-name:skill-name として一覧表示されます。読み込みに失敗した項目は、理由とともに Errors タブに表示されます。

インストール時にはスコープを指定します。スコープによって、誰がプラグインを利用できるかが決まります。User スコープでは、すべてのプロジェクトで自分が利用します。Project スコープでは、リポジトリの .claude/settings.json 内の enabledPlugins にプラグインを書き込みます。これにより、そのリポジトリをクローンする全員に対して有効になります。ただし、プラグイン自体が各ユーザーの環境にダウンロードされるわけではありません。各共同作業者は、claude plugin install name@marketplace --scope project などを使って自分のマシンに 1 回インストールする必要があります。ただし、マーケットプレイスのエントリが相対パスである場合や、seed directory にすでに存在する場合は除きます。Local スコープでは、このリポジトリ内で自分だけが利用します。

スクリプト、Dockerfile、または対話的なパネルを利用できないセッションでは、代わりに shell 形式を使用します。--scope を指定しない限り、User スコープにインストールされます。まだ誰も対話的なセッションを開いていないマシンでは、公式マーケットプレイスは登録されていません。そのため、先に追加してください。

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin list

claude plugin install はセッション外で実行されるため、すでに開いているセッションでは、新しいプラグインを /reload-plugins の実行または新しいセッションの開始まで利用できません。

インストール済みの内容を管理する方法は、どちらの場所でも同じです。/plugin list でインストール済みの項目を表示でき、--enabled または --disabled を指定できます。/plugin disable name@marketplace でプラグインを削除せずに無効化し、/plugin enable で再度有効化し、/plugin uninstall で削除します。スラッシュコマンド形式ではプラグインパネルが開いて変更を適用するため、スクリプトでは claude plugin ... の shell 形式を使用します。

マーケットプレイスをチーム全体で利用するには、プロジェクトの .claude/settings.json に追加するか、claude plugin marketplace add your-org/claude-plugins --scope project を 1 回実行して、生成されたファイルを commit します。Claude Code は、各メンバーがリポジトリのフォルダーを信頼した時点で、そのメンバー用にマーケットプレイスを登録します。

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

独自のプラグインを作成している間は、マーケットプレイスを使用しないでください。claude --plugin-dir ./my-plugin でディレクトリをそのセッションに読み込み、/reload-plugins で再起動せずに編集内容を反映し、claude plugin validate ./my-plugin で manifest、skill と agent の frontmatter、および hooks/hooks.json を確認してから他のユーザーに公開できます。共有する場合もマーケットプレイスは必須ではありません。フォルダーまたはその .zip を相手に渡し、--plugin-dir で読み込んでもらえます。ただし、新しいコピーを渡すまで更新は反映されません。

Claude Code プラグインの料金はいくらですか?

仕組み自体は無料です。2026 年 11 月時点では、marketplace の追加、プラグインのインストール、有効状態の維持に料金はかかりません。公式およびコミュニティの marketplace は公開 git リポジトリであり、プラグインはテキストファイルのディレクトリです。

プラグインで消費されるのはトークンです。トークンは、実際にはサブスクリプションの使用量または API 請求額で計測されます。どちらに影響するかは、最初にツールの料金をどの方法で支払うかによって異なります。各プランでの Claude Code の料金では、サブスクリプションの段階別料金と、トークン単位の API 料金を並べて説明しています。このコストは 3 つの形で発生し、それぞれ挙動が異なります。

常時発生するコンテキストコスト。 有効にしたプラグインは、Claude が自動的に呼び出せるスキル、エージェント、コマンドの名前と説明をコンテキストに追加します。この部分は、何も実行されなくてもセッションの各ターンで再読み込みされます。すべてのコンポーネントがトークンを消費するわけではありません。hook は harness によって実行され、モデルのコンテキストには何も追加しません。インストール前に、/plugin の詳細ビューには Will install セクションが表示されます。このセクションには、追加しようとしている commands、skills、agents、hooks、MCP および LSP servers が一覧表示されます。Anthropic の公式 marketplace にあるプラグインでは、Every turn と When invoked の見積もりを含む Context cost セクションも表示されます。ただし、プラグインを marketplace name から開くか、Discover リストではなく Marketplaces tab から開く必要があります。両方を確認してください。自分の marketplace またはサードパーティーの marketplace にあるプラグインには Context cost セクションがありません。ただし、手作業で見積もる必要はありません。シェルで claude plugin details name を実行すると、読み込まれたプラグインについて、--plugin-dir で渡したものも含め、Always-on のトークン数とコンポーネント別の内訳が表示されます。そのため、リポジトリを clone して、インストール前に claude --plugin-dir ./that-plugin plugin details that-plugin を実行できます。この数値には MCP servers は含まれません。MCP server を同梱するプラグインは、通常、最も重くなります。tool definitions が大きいためです。ただし、MCP tool search をサポートするモデルでは、ツールが必要になるまで定義の読み込みが遅延されます。プラグインを有効にしたセッションで /context を実行し、MCP tools 行を確認すると、追加された内容を確認できます。

呼び出しコスト。 プラグインの skill を実行すると、その指示が会話に追加されます。そのため、skill 本体の料金が発生するのは使用時だけです。ただし、本体は安価な部分です。skill が agent に指示する処理は、必ずしも安価ではありません。unlazy skill の Depth Tree methodでは、agent がタスク完了を宣言できるまで追加のパスを強制するため、トークンのほとんどがその処理に使われます。インストールしたファイル自体に使われるわけではありません。agent は異なります。subagent は、独自の system prompt と独自の cache を持つ別の会話を実行します。cache hit がない状態から開始するため、agent を起動するワークフローを持つプラグインは、コンテキストの見積もりから想定されるよりも大幅に多くのコストがかかります。

キャッシュコスト。 セッション途中でプラグインを有効または無効にすると、次のリクエストで会話全体の再処理が必要になる場合があります。skills、commands、agents、hooks、monitors、themes がこの処理を発生させることはありません。これらが追加する内容は既存の履歴の後に追加されるため、次のリクエストでは新しい内容の料金だけが発生し、それ以前の内容は cache から読み取られます。例外は、MCP server を提供するプラグインと、Claude に LSP tool を提供する language server を持つ code intelligence plugin です。MCP では tool search の設定によって異なります。ツールの読み込みが遅延される場合は cache が維持されます。ツールが prompt prefix に読み込まれる場合は、次のリクエストで会話全体が uncached input として再読み込みされます。そのため、/reload-plugins は MCP tools または LSP tool の変更によって cache が壊れる場合に警告し、--force を渡すまで処理を拒否します。

推測せずに、この状況を監視できます。すべての API response には cache_read_input_tokens と cache_creation_input_tokens が含まれます。ライブのトークン使用量を表示する custom statuslineを設定すると、両方を画面上で確認できます。正常なセッションでは、生成する量よりもはるかに多くの内容を読み取ります。ターンごとに生成量が高いままなら、prefix のどこかが毎回変化しています。コンテキストウィンドウを埋めている内容の全体像については、Claude Code のコンテキストウィンドウを管理する方法と、そのトークン数が実際に意味することを参照してください。

メンテナンスを 1 つ行うだけで、コストを回収できます。Installed tab では、少なくとも 14 日間かつ 10 セッション使用していない marketplace-installed plugins が、Not used recently header の下にまとめられます。詳細ビューには Last used 行も表示されます。この header は、managed plugins と seed-directory plugins、および theme、output style、monitor、workflow を持つプラグインを除外します。LSP server は、diagnostics を提供するか、code navigation request に応答した時点で使用済みとして扱われます。strictKnownMarketplaces が設定されている場合、header も Last used: 行も表示されません。これらのプラグインは、それでも各セッションの startup time と context を消費します。無効化またはアンインストールしてください。より安価なのは、インストール前に選別する習慣です。Matt Pocock の skills のうちインストールする価値があるものでは、27 個の skill collection を検討し、個人開発者に必要な少数の skill と、チームで初めて効果を発揮する skill を分けています。

プラグインはユーザーの権限で実行されます

Anthropic の公式ドキュメントは、この点を明確に説明しています。インストールしたプラグインは、ユーザー権限でマシン上の任意のコードを実行できます。これは仮定上のリスクではありません。プラグインのフックは、ツール呼び出しの前後を含むセッションイベントで shell コマンドを実行します。プラグインが有効な間は、その bin/ directory が Bash tool の PATH に追加されます。stdio MCP servers はプラグインが起動するプロセスであり、mod は Claude Code 自体の内部で JavaScript を実行します。フック、モニター、server processes、mod processes は Claude Code の sandbox 外部で実行されます。ただし、Claude が行うツール呼び出しには、Claude Code の権限ルールが引き続き適用されます。

ノート PC では、このリスクはデスクトップユーザーがアクセスできる範囲に制限されます。サーバーでは、通常そうなりません。agent を実行するアカウントは、SSH keys、deploy tokens、cloud CLI session、Docker socket へのアクセス権を持っていることが多いため、「ユーザー権限で任意のコードを実行できる」とは、実質的にマシン全体を操作できるという意味です。VPS で Claude Code を実行する場合は、何かをインストールする前に VPS で Claude Code を安全に実行する方法を読み、外部サービスと通信するプラグインをインストールする前に 認証情報を agent の手の届かない場所に置く方法を読んでください。同じ借用サーバー上で動く他の harnesses も同じ制約を受けます。そのため、インストールする価値のある DeepSeek Harness plugins の大半は、新しい機能ではなく、支出上限、ツール権限ルール、injection scanning を提供します。

いくつかのガードレールは存在します。どのようなものかを把握しておくと役立ちます。project-scope plugin はユーザーではなく repository から提供されるため、workspace を信頼した後にのみ読み込まれます。ただし、その MCP servers には server ごとの承認が必要で、background monitors はまったく読み込まれません。plugin-shipped agents は、hooks、MCP servers、permission mode を宣言できません。marketplace plugins を cache にコピーする際、marketplace 外部を指す symlinks はスキップされます。そのため、コピーされた plugin がそれらのリンク経由で任意の host files を取り込むことはできません。

これらの対策が、インストールするものを読む必要性に取って代わることはありません。Will install list を確認し、source を開いて読める plugins を優先し、チームの plugins は自分たちが管理する marketplace repository に置き、## claude plugin validate を自分で作成したものに対して実行してください。確認した内容も後から変わる可能性があります。Anthropic の公式 marketplaces では、knowledge-work-plugins と first-party-plugins を除き、auto-update がデフォルトで有効です。一方、source から追加した third-party marketplaces では無効です。有効な場合、Claude Code はバックグラウンドで plugin の files を更新します。

FAQ

Claude Code の plugin には追加料金がかかりますか?

いいえ。plugin system の利用、marketplace の追加、plugin のインストールに料金はかかりません。費用は token usage で、他の context と同様に、プランまたは API の利用額に対して請求されます。plugin は毎回の turn に常駐 context を追加し、その skill または agent が呼び出されるとさらに追加します。また、特定の MCP server が提供され、その tool が prompt prefix に読み込まれる場合は、コストの高いキャッシュされない turn が 1 回発生することがあります。Anthropic の公式 marketplace にある plugin では、インストール前に /plugin の詳細画面で Context cost の見積もりを確認できます。それ以外の plugin では、インストールまたは --plugin-dir で読み込んだ後に、claude plugin details name が常時発生する token cost を表示します。

plugin と skill の違いは何ですか?

skill は単一の指示単位です。plugin は skill、agent、hook、MCP server、LSP server、monitor を含めることができるパッケージで、名前、通常は version、通常はインストール元の marketplace を持ちます。ただし、フォルダーまたは .zip として共有し、--plugin-dir で読み込むこともできます。自分とこのプロジェクトのための standalone skill は .claude/ に記述します。動作する最小限の変更へ agent を導く Ponytail のような単一目的の skill は、その典型です。1 つのファイルに 1 つのルールだけを記述し、チームでも必要になった時点で plugin に変換します。他の人も必要とし、時間の経過とともに更新する必要がある場合は、plugin にします。plugin の skill には namespace が付くため、plugin 内の skill は /plugin-name:skill-name として呼び出し、/skill-name では呼び出しません。

plugin をインストールしましたが、skill が表示されません。何が問題ですか?

最初にインストール概要を確認します。Run /reload-plugins to apply. と表示されていた場合、Claude Code はパネルを閉じたときに reload を実行します。その reload で会話を再読み込みすると警告された場合は、/reload-plugins --force として再実行します。読み込み済みなのに何も表示されない場合は、/plugin を開き、Errors tab を確認します。最も多い構造上の誤りは、skills/、agents/、または hooks/ を .claude-plugin/ の中に配置することです。Claude Code はそこを検索しません。plugin の skill には namespace が付くため、/ と入力したときに探すのは /plugin-name:skill-name です。他者の plugin で、エラーなしに読み込まれる場合は、Installed tab の詳細ペインを開きます。そこに skill が 1 つも表示されない plugin には、提供できる skill がありません。Errors tab に plugin がキャッシュされていないと表示された場合は、インストールディレクトリがありません。shell から claude plugin install name@marketplace で再インストールし、/reload-plugins を実行します。

interactive panel なしで plugin をインストールできますか?

はい。shell command の claude plugin install name@marketplace を使用します。--scope project または --scope local を指定しない限り、user scope にインストールされます。/plugin panel を利用できない script、image、non-interactive environment でも動作します。session の外部で実行されるため、すでに開いている session では、plugin を有効にする前に /reload-plugins が必要です。interactive terminal のない session では、plugin MCP server の変更は次の session で有効になります。

GitHub で見つけた marketplace から plugin をインストールしても安全ですか?

その plugin のインストールを、自分の user としてその repository の install script を実行するのと同じように扱ってください。実際に近い動作だからです。plugin は hook を通じて shell command を実行し、Bash tool の PATH に executable を追加し、MCP server を起動できます。これらはすべて user の権限で実行されます。Anthropic は third-party plugin の内容を管理も検証もしていません。内容を確認できる source からインストールし、確定前に Will install list を確認してください。server では laptop より厳格に判断してください。通常、server の account には盗まれると危険な key や token が保存されているためです。

この記事は役に立ちましたか?