SpyBara
Go Premium

plugins/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 34 additions and 34 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Wed 14 22:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57

プラグインの概要

Claude Code プラグインとは何か、スタンドアロンスキルまたは MCP サーバーの代わりにプラグインが必要な場合、およびプラグインをインストールまたは作成するために読むべきページについて理解します。

Claude Code プラグインは、Claude Code がインストールして 1 つのユニットとして読み込むスキル、エージェント、hooks、MCP サーバー、またはその他のコンポーネントのディレクトリです。ほとんどのプラグインはマーケットプレイスから提供されます。マーケットプレイスはプラグインをリストアップし、各プラグインをどこから取得するかを示すカタログです。誰かが提供したフォルダからプラグインを読み込むこともできますし、独自に構築することもできます。

[!NOTE]

以下のケースについては、他のページで説明しています：

プラグインを今すぐ試すには、Claude Code ターミナルセッションで /plugin を実行し、Discover タブからプラグインをインストールします。このタブには、マーケットプレイスのプラグインがリストアップされています。そこから：

プラグインとは何かを理解する

プラグインは通常、マニフェストを含むコンポーネントのディレクトリです。マニフェストは .claude-plugin/plugin.json にある JSON ファイルで、プラグインに名前を付け、バージョン、説明、およびその他のメタデータを追加できます。コンポーネントはプラグインが Claude Code に追加するもので、以下のようなものです：

  • Skills：Claude が関連する場合に読み込む SKILL.md 命令。コマンドとして実行することもできます
  • Agents：Claude が委譲できるサブエージェント定義
  • Hooks：編集後など、ライフサイクルのポイントで Claude Code が実行するコマンド
  • A hooks module：JavaScript 関数として記述されたフック。ペインを描画したり、コマンドを追加したりすることもできます。フックモジュールを持つプラグインは mod と呼ばれます。一部の mod は Claude Code に組み込まれています。
  • MCP servers：プラグインが有効な場合に Claude Code が接続するツールサーバー

このダイアグラムは、my-plugin という名前のプラグインを示しており、スキル、エージェント、hooks、および MCP サーバーを保持しており、プラグインが読み込まれた後に各ファイルから何を取得するかを示しています。

Diagram in two columns joined by five straight arrows. Left, the directory of a plugin named my-plugin, holding a manifest at .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json, and other components. Right, what each file gives you in your session: the manifest sets the plugin name, my-plugin; the skill runs as /my-plugin:review; the agent file is a subagent Claude can delegate to; the hooks file holds hooks that run on lifecycle events; and .mcp.json adds an MCP server that gives Claude tools.

プラグインが保持できるすべてのコンポーネントタイプについて、各コンポーネントの例を含めて、プラグインコンポーネントを参照してください。プラグインのディレクトリ内の各部分がどこに配置されているかを確認するには、そのページのプラグインエクスプローラーを使用してください。

プラグインが必要かどうかを判断する

スキル、サブエージェント、hooks、および MCP サーバーはすべて、プラグインなしで単独で機能します。たとえば、~/.claude/skills/ に保存したスキルは、マシン上のすべてのプロジェクトで利用可能です。単独で設定するには、Skills、Subagents、Hooks、または MCP を参照してください。

複数のスキル、サブエージェント、hooks、または MCP サーバーを 1 つのユニットとしてパッケージ化したい場合は、プラグインを使用します。インストールして、他の誰かが構築したセットアップを取得し、1 つのコマンドとマーケットプレイスからの更新を使用します。独自のセットアップをチームメイトに提供したり、多くのプロジェクトにインストールしたり、バージョン付きリリースを公開したりするために作成します。

有効なプラグインがセッションに追加するもの

有効なプラグインは、それを使用するセッションだけでなく、すべてのセッションの一部です。インストール前に知っておく価値のある結果がいくつかあります：

  • コンテキストと使用状況：Claude が独自に呼び出すことができる各スキル、エージェント、およびコマンドについて、名前と説明は Claude のコンテキストにあり、Claude がそれが存在することを知っています。これらのトークンは使用状況にカウントされ、プラグインから何も実行されないセッションでもコンテキストウィンドウの空き容量が減ります。スキルまたはエージェントの完全なテキストは、使用される場合にのみ読み込まれます。プラグインの MCP サーバーがターンごとに追加するものは、MCP ツール検索に従います。
  • プロセス：プラグインが定義する MCP サーバーは、有効な各セッションと並行して実行され、その hooks はイベントで発火します。
  • 権限：プラグインが実行するもの、それはあなたとして実行されます。最初に確認すべきことについては、プラグインのセキュリティと信頼を参照してください。

各段階でプラグインのフットプリントを確認できます：

  • インストール前：/plugin の Marketplaces タブからプラグインを開きます。Anthropic の公式マーケットプレイスのプラグインは、そこに Context cost の推定値を表示します。
  • インストール後：プラグインのコストを測定するは、プラグインのフットプリントを読む方法を示し、Installed タブの Not used recently グループは、オフにできるプラグインをリストアップします。
  • アンインストールせずに停止する：/plugin でプラグインを無効にするか、シェルで claude plugin disable を実行します。インストール済みプラグインの管理を参照してください。

マーケットプレイスからプラグインを取得する

マーケットプレイスは、プラグインをリストアップし、各プラグインをどこから取得するかを示す .claude-plugin/marketplace.json ファイルを持つリポジトリまたはディレクトリです。これはホストされたストアではなく、カタログです。マーケットプレイスを 1 回追加してから、commit-commands@claude-plugins-official などの名前でプラグインをインストールします。

[!NOTE]

プラグインマーケットプレイスは Claude Marketplace ではありません。Claude Marketplace は claude.com/marketplace の Web サイトで、プラグイン、コネクタ、パートナー製品、およびサービスパートナーを参照できます。これは /plugin marketplace add で追加するマーケットプレイスではありません。

Claude Code は、管理ポリシーがブロックしない限り、対話型ターミナルセッションを初めて開始するときに Anthropic の公式マーケットプレイスを追加します。Claude Code は、Anthropic のコミュニティおよびデモマーケットプレイスを独自に追加しません。3 つの Anthropic マーケットプレイスを区別するには、Anthropic のマーケットプレイスを読んでください。公式マーケットプレイスがリストアップしているものを確認するには、セッションで /plugin の Discover タブを開くか、Claude Marketplaceを参照してください。

このダイアグラムは、マーケットプレイスからセッションへのパスを示しています。マーケットプレイスはプラグインをリストアップし、そのプラグインをインストールし、Claude Code がそのコンポーネントを読み込みます。

Diagram of the marketplace path in three boxes, left to right. A marketplace, a catalog of plugins, lists a plugin. The plugin is one directory installed as a unit, holding skills, agents, hooks, MCP servers, and other components. You install the plugin into Claude Code, which loads its components.

プラグインのインストールと管理には、Claude Code を実行する各場所のインストール手順があります。プラグインを開発している間は、マーケットプレイスは必要ありません。マーケットプレイスなしで開発するに示すように、--plugin-dir でフォルダから直接読み込みます。

インストール済みプラグインをセッションで利用可能にする

インストール済みプラグインが実行できるスキルを提供する前に、これらの各レイヤーに存在する必要があります：

  • Settings：設定は、追加したマーケットプレイスと有効なプラグインをリストアップします。
  • Disk：~/.claude/plugins/ は、Claude Code がフェッチしてインストールしたものを保持します。
  • Session：プラグインはスタートアップで読み込まれるか、プラグインを再度読み込むときに読み込まれます。

プラグイン読み込みリファレンスを読んで、各レイヤーのルール、どの設定ファイルが優先されるか、およびディスク上のファイルの場所を確認してください。

Anthropic のマーケットプレイスをサードパーティのマーケットプレイスから区別する

マーケットプレイスの名前は、それを 3 つのティアのいずれかに配置します。Claude Code は、github.com/anthropics/ リポジトリから取得したマーケットプレイスの公式およびコミュニティ名のみを受け入れます：

  • Official：Anthropic の公式マーケットプレイス名の 1 つを持つマーケットプレイス。claude-plugins-official とデモマーケットプレイス claude-code-plugins を含みます。
  • Community：claude-community などの Anthropic のコミュニティ名を持つマーケットプレイス。Anthropic のマーケットプレイスを名前で識別するがそれらをリストアップします。
  • Third-party：他のすべてのマーケットプレイス。同僚または組織が公開するマーケットプレイスはサードパーティです。

ティアに関係なく、インストールするプラグインはユーザー権限でコードを実行できます。プラグインをインストール前に確認する方法については、プラグインのセキュリティと信頼を読んでください。

管理設定を通じて、組織はマーケットプレイスをホワイトリストまたはブロックし、プラグインを強制インストールし、セッションのみの読み込みをオフにできます。これらのコントロールについては、組織のプラグインを管理するを読んでください。

インストールスコープを理解する

プラグインをインストールするときは、スコープを選択し、スコープはプラグインが有効な対象を決定します：

  • User scope：このコンピューター上のすべてのプロジェクトで有効
  • Project scope：コミットされた .claude/settings.json を通じて、このリポジトリで作業するすべての人に対して有効。各協力者は依然として自分のマシンにインストールする必要があります
  • Local scope：このリポジトリでのみ有効

ターミナル、デスクトップアプリのローカルセッション、または VS Code 拡張機能でユーザースコープでインストールしたプラグインは、3 つすべてが同じ設定ファイルを読むため、そのコンピューター上の他の 2 つで利用可能です。スコープを選択する方法については、インストールスコープを選択するを参照してください。

claude.ai/code のブラウザーを含むクラウドセッションは、ローカル設定のプラグインを読み込みません。ターミナル、VS Code、デスクトップアプリでのインストール手順、およびクラウドセッションが読み込むものについては、プラグインのインストールを参照してください。

[!NOTE]

同じプラグイン形式は claude.ai および Cowork にもインストールされます。異なるコンポーネントセットが読み込まれます。これらのサーフェスについては、claude.com のclaude.ai および Cowork のプラグインを参照してください。そのコンポーネントサポート表も参照してください。

次のステップ

ほとんどの人は、Claude Code が対話型ターミナルセッションを初めて開始するときに追加する Anthropic の公式マーケットプレイスからプラグインをインストールすることから始めます。ターミナルセッションで /plugin を実行して参照するか、プラグインのインストールと管理に従います。これはデスクトップアプリと VS Code もカバーしています。Claude Code を開く前にそのマーケットプレイスに何があるかを確認するには、Web で Claude Marketplaceを参照してください。

独自に構築するには、プラグインの作成は空のディレクトリから始まり、動作するプラグインで終わります。

プラグインをインストールまたは構築したら、これらのページは次に来るものをカバーしています：