plugins (プラグイン)

Claude Code はこれを一つの単位としてインストールし、読み込みます。他の人が作った設定一式を 1 つのコマンドで導入し、マーケットプレイスから更新を受け取る用途に使います。複数のスキルやサブエージェント、フック、MCP サーバーをまとめて扱いたい場面に関わる機能です。

プラグインのマニフェストは .claude-plugin/plugin.json にある JSON ファイルで、プラグインの名前を定め、バージョンや説明などのメタデータを加えられます。

プラグインに含められる主な構成要素は次のとおりです。

• スキル：関連するときに Claude が読み込む SKILL.md の指示で、コマンドとしても実行できます。
• フック：編集のたびなど、Claude Code のライフサイクルの所定の時点で実行されるコマンドです。
• MCP サーバー：プラグインが有効な間、Claude Code が接続するツールサーバーです。
• hooks モジュール：JavaScript の関数として書いたフックで、ペインの描画やコマンドの追加もできます。これを持つプラグインは mod と呼ばれます。

インストールしたプラグインは ~/.claude/plugins/ に保存され、起動時またはプラグインの再読み込み時に読み込まれます。開発中のプラグインは、マーケットプレイスを使わずに --plugin-dir でフォルダーから直接読み込めます。

インストール時にはスコープ (user・project・local) を選び、スコープによってプラグインが誰に対して有効になるかが決まります。ターミナル、デスクトップアプリのローカルセッション、VS Code 拡張のいずれかで user スコープにインストールしたプラグインは、同じコンピューター上の他の 2 つでも使えます。一方、claude.ai/code を含むクラウドセッションは、ローカル設定にあるプラグインを読み込みません。

マーケットプレイスは、.claude-plugin/marketplace.json ファイルを持つリポジトリまたはディレクトリで、プラグインの一覧と各プラグインの取得先を示します。ホスト型のストアではなく、カタログです。

• Claude Code は、初めて対話型のターミナルセッションを起動したときに Anthropic の公式マーケットプレイスを追加します (管理ポリシーでブロックされている場合を除く)。Anthropic のコミュニティマーケットプレイスは自動では追加しません。
• 公式およびコミュニティのマーケットプレイス名は、github.com/anthropics/ のリポジトリを取得元とするマーケットプレイスにだけ認められます。
• gitlab.com のリポジトリ URL (入れ子のサブグループを含む) も、github.com の URL と同様にクローンできます。
• archive プラグインソースを使うと、git や npm を使わずに HTTPS 経由の zip からプラグインをインストールでき、SHA-256 による固定も任意で指定できます。
• url マーケットプレイスやカタログエントリの headersHelper で、カタログや同一オリジンのアーカイブ取得に使う HTTP ヘッダー (短期間のトークンなど) を生成するコマンドを実行できます。
• コマンドソースでは、ローカルのコマンド (IDE など) がプラグインディレクトリを出力し、セッションごとに解決し直されて再起動なしで適用されます。

有効にしたプラグインは、それを使うセッションだけでなく、すべてのセッションに含まれます。スキルやエージェントの全文は使われるときにだけ読み込まれますが、自動で呼び出される項目の名前と説明は毎ターンのコンテキストに入ります。また、プラグインが実行するものは、利用者自身として実行されます。

導入前後の確認には、次の手段があります。

• /plugin の Marketplaces (マーケットプレイス) タブからプラグインを開くと、Anthropic の公式マーケットプレイスのプラグインについて Context cost (コンテキストのコスト) の見積もりが表示されます。
• claude plugin details <name> で、プラグインの構成要素と、セッション当たりの推定トークンコストを表示できます。
• Installed (インストール済み) タブの Not used recently (最近使っていない) グループに、無効にしてよいプラグインが並びます。
• アンインストールせずに止めたい場合は、/plugin またはシェルで claude plugin disable を使って無効にします。

• 管理設定の blockedMarketplaces と strictKnownMarketplaces は、プラグインのインストール・更新・リフレッシュ・自動更新の各時点で適用されます。
• 管理設定 pluginSuggestionMarketplaces で、文脈に応じたヒントとしてプラグインを提案してよい組織のマーケットプレイスを許可リストに登録できます。
• プラグインのオプション値 (pluginConfigs) は、プロジェクトレベルの .claude/settings.json からは読まれません。有効なのは user、--settings、管理設定だけです。
• npm ソースからインストールするプラグインは npm pack --ignore-scripts で取得され、整合性が検証されます。パッケージのインストールスクリプトは実行されません。
• プラグインのフック・モニター・MCP headersHelper では、シェル形式のコマンド内の ${user_config.*} が拒否されます (シェルインジェクション対策)。制御文字や不可視文字を含むマーケットプレイス名も拒否されます。
• claude.ai アカウントで有効なスキルとプラグインは、そのアカウントでサインインしたターミナルセッションに同期されます。スキルの同期は syncClaudeAiSkills: false、プラグインの同期は syncClaudeAiPlugins: false で無効にできます。

対象プランについては、公式のリリースノートには記載がありません。

1. Claude Code のターミナルセッションで /plugin を実行します。
2. Discover (発見) タブを開きます。追加済みのマーケットプレイスにあるプラグインが一覧で表示され、インストール前にプラグインのコマンド・エージェント・スキル・フック・MCP/LSP サーバーを確認できます。
3. 一覧からプラグインをインストールします。インストール・有効化・無効化はメニューを閉じた時点で反映され、その後に /reload-plugins を実行する必要はありません。