SpyBara
Go Premium

plugins/cli-reference.md 2026-09-24 22:57 UTC to 2026-09-25 23:58 UTC

This page contains 839 additions and 0 deletions.

2026
Fri 25 23:58

プラグインコマンドリファレンス

claude プラグインシェルコマンド、セッション内の /plugin と /reload-plugins、および 1 つのセッションのためにプラグインをロードするフラグの完全なリファレンス。

プラグインコマンドは、シェルまたはスクリプトから claude plugin として実行するか、Claude Code セッション内で /plugin と /reload-plugins として実行します。このリファレンスでは、各コマンドのフラグ、デフォルト、出力、終了コード、および 1 つのセッションのためにプラグインをロードする 2 つのフラグについて説明します。

ビルドで claude plugin --help を実行して、バージョンにどのサブコマンドがあるかを確認してください。

claude plugin コマンド

Claude Code セッション外のシェルまたはスクリプトから claude plugin <subcommand> を実行します。これらのサブコマンドは、/plugin パネルを開かずにプラグインをインストールおよび管理します。

claude plugins は claude plugin のエイリアスです。

すべてのサブコマンドは、これらの終了コード、プラグイン引数、およびスコープ値を共有します：

  • 終了コード: 成功時は 0、失敗時は 1。validate は予期しないエラーに対して終了 2 を追加し、eval はそのセクションにリストされたコードを追加します。
  • プラグイン引数: <plugin> 引数はプラグイン name または name@marketplace です。2 つのマーケットプレイスが同じ名前を提供する場合は、修飾形式を使用してください。
  • スコープ: --scope は user、project、または local を取り、コマンドが書き込む設定ファイルに名前を付けます。update は managed も取ります。

plugin init

~/.claude/skills/<name>/ に新しいプラグインをスキャフォールドします。次のセッションで <name>@skills-dir としてロードされ、インストール手順は不要です。

new は init のエイリアスです。

このコマンドで始まる作成、テスト、編集ワークフローについては、プラグインの作成を参照してください。

claude plugin init <name> [options]

<name> は ~/.claude/skills/ の下のディレクトリ名になり、プラグインのマニフェストの name になります。

このコマンドには別の場所のフラグはありません。代わりにプロジェクト内にスキャフォールドするには、プラグインの作成を参照してください。

フラグ 説明
--description <text> マニフェストの説明
--author <name> 著者名。デフォルトは git config user.name
--author-email <email> 著者メール。デフォルトは git config user.email
--with <components...> skills、agents、hooks、mcp、lsp、output-style、または channel のスターターファイルもスキャフォールドします
-f, --force ターゲットの既存の .claude-plugin/ を上書きします

スキル と hook ファイルのスターターを含むプラグインをスキャフォールドします：

claude plugin init my-helper --with skills hooks

Claude Code は書き込んだ内容を検証し、Created plugin "my-helper" at ~/.claude/skills/my-helper を出力し、その後にロードされる id と、それをオフにする claude plugin disable コマンドを出力します。

Claude Code は安全にスキャフォールドできない場合は 1 で終了し、メッセージは理由を名前付けします。これらは一般的な理由です：

  • 不明な --with 値
  • --force なしのターゲットの既存スキャフォールド
  • スキルディレクトリプラグインをブロックする管理設定

plugin install

追加したマーケットプレイスからプラグインをインストールします。i は install のエイリアスです。

claude plugin install <plugin> [options]

ほとんどのプラグインはプロンプトなしでインストールされます。マーケットプレイスエントリがインストールするコマンドを実行するか、ダウンロード用に headersHelper を設定するプラグインの場合、Claude Code は最初にコマンドを出力し、Run this command now? [y/N] と尋ねます。

フラグ 説明
-s, --scope <scope> インストールスコープ: user、project、または local。デフォルトは user
--config <key=value> プラグインのマニフェストが宣言する userConfig オプションを設定します。各オプションについてフラグを繰り返します。Claude Code v2.1.147 以降が必要です
-y, --yes Run this command now? プロンプトなしで表示されたインストールコマンドを受け入れます。Bash ツールまたはフックからなど、Claude Code セッション内で実行されるコマンドでは無視されます。Claude Code v2.1.229 以降が必要です
--accept-command <sha256> 前の --json 実行が shownCommand で報告した sha256 を持つ表示されたインストールコマンドを受け入れます。-y の代わりに使用します。-y と組み合わせることはできません。表示されたインストールコマンドを受け入れるを参照してください。Claude Code v2.1.271 以降が必要です
--json スクリプトで使用するために、人間が読める形式のメッセージの代わりに、stdout の最後の行に 1 つの JSON オブジェクトとして結果を出力します。JSON 結果形式を参照してください。Claude Code v2.1.268 以降が必要です

自分のターミナルから -y を渡して、プロンプトなしで表示されたコマンドを受け入れます。TTY がない場合と Claude がコマンドを実行する場合の動作は次のとおりです：

  • stdin または stdout が TTY ではなく、-y も --accept-command も渡さない: インストールが拒否されます。出力はコマンドが表示されたのみであることを示し、終了コードは 1 です
  • Claude が Bash ツール経由でコマンドを実行: -y は無視されます。代わりに自分のターミナルからコマンドを実行してください

プロジェクトをクローンするすべての人のためにプラグインをインストールします：

claude plugin install formatter@my-marketplace --scope project

Claude Code は Successfully installed plugin: formatter@my-marketplace (scope: project) を出力します。新しいものがインストールされない場合、出力は理由を説明します：

  • そのスコープで既にインストール: 出力は Plugin "formatter@my-marketplace" is already installed (scope: project) で、終了コードは 0 です
  • コマンドソースプロンプトを拒否: 出力は Aborted. で、終了コードは 1 です
  • headersHelper プロンプトを拒否するか、TTY なしで確認できない: 出力は Aborted — the command was not run. で、終了コードは 1 です

JSON 結果形式

plugin install に --json を渡すと、stdout の最後の行は 1 つの JSON オブジェクトです。Claude Code がそれより前に宣言したコマンドを出力する可能性があるため、その行のみを解析してください。

3 つのフィールドは常に存在します：

  • command: 実行されたサブコマンド（例：install）
  • outcome: ok または failed
  • message: 結果の人間が読める説明

pluginId、scope、failureCode などの他のフィールドは、適用される場合にのみ表示されます。

無効な --scope などの使用エラーは、結果行を出力せず、stderr に理由を付けて 1 で終了します。

表示されたインストールコマンドを受け入れる

--json 実行がマーケットプレイスで宣言されたコマンドを表示し、それを実行しない場合、failed 結果は shownCommand オブジェクトも含みます。そのフィールドには、表示されたコマンド、それが属するプラグイン、およびコマンドの sha256 が含まれます。

正確にそのコマンドを受け入れるには、フラグが Claude Code セッション内で効果がないため、自分のターミナルからその sha256 を --accept-command として再実行してください。Claude Code v2.1.271 以降が必要です。

sha256 は、正確にそのコマンド、プラグイン、およびマーケットプレイスカタログの受け入れとしてカウントされます。実行自体のマーケットプレイス更新が取得する変更を含め、それらのいずれかが変更された場合、Claude Code は sha256 を受け入れず、コマンドを再度表示します。shownCommand.acceptCommandMatched が false の場合、渡した sha256 は現在表示されているコマンドと一致しません。そのコマンドを確認してから、その sha256 で再実行してください。

plugin uninstall

インストール済みプラグインを 1 つのスコープから削除します。remove と rm は uninstall のエイリアスです。

claude plugin uninstall <plugin> [options]
フラグ 説明
-s, --scope <scope> スコープからアンインストール: user、project、または local。デフォルトは user
--keep-data プラグインの永続データディレクトリ ~/.claude/plugins/data/<id>/ を保持します
--prune 残りのプラグインが必要としない自動インストール依存関係も削除します
-y, --yes --prune 確認プロンプトをスキップします。stdin または stdout が TTY でない場合は --prune で必須です
--json stdout の最後の行に 1 つの JSON オブジェクトを出力します。plugin install --json と同じ形式です。--prune と組み合わせることはできません。Claude Code v2.1.268 以降が必要です

プロジェクトスコープからプラグインをアンインストールします：

claude plugin uninstall formatter@my-marketplace --scope project

Claude Code は Successfully uninstalled plugin: formatter (scope: project) を出力します。プラグインがそのスコープにインストールされていない場合、コマンドは Failed to uninstall plugin "formatter@my-marketplace": で始まる行を出力し、1 で終了します。

plugin enable

無効なプラグインを有効にします。claude.ai から同期されたプラグインの場合、プラグインとして <name>@synced を渡します。

claude plugin enable <plugin> [options]
フラグ 説明
-s, --scope <scope> 有効にするスコープ: user、project、または local。省略時は自動検出
--json stdout の最後の行に 1 つの JSON オブジェクトを出力します。plugin install --json と同じ形式です。Claude Code v2.1.268 以降が必要です

--scope なしで、コマンドは設定ファイルをローカル、プロジェクト、ユーザーの順序でチェックし、プラグインを言及する最初のスコープを使用します。

プラグインが宣言されていない --scope を渡す場合、コマンドはオーバーライドを書き込むか失敗します：

  • 宣言するスコープより優先されるスコープ: Claude Code は渡したスコープでオーバーライドを書き込みます。たとえば、claude plugin disable formatter --scope local はプロジェクトで有効なプラグインをあなただけのためにオフにします
  • その他のスコープ: コマンドは Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect. で失敗します

プラグインが解決されたスコープで既に有効な場合、コマンドは Plugin "formatter" is already enabled を出力し、1 で終了します。--json を使用すると、結果は "failureCode": "already_in_goal_state" と "alreadyInGoalState": true を持つため、スクリプトはそのケースを成功として扱うことができます。

プラグインが依存関係を宣言する場合、Claude Code はそれらも有効にします。コマンドはこれらのケースで失敗します：

  • 依存関係がインストールされていない: 有効化が失敗し、各欠落依存関係に対して claude plugin install コマンドを出力します
  • 依存関係が組織のプラグインポリシーによってブロックされている: 有効化が失敗し、ブロックされた依存関係に名前を付けます
  • 依存関係がターゲットスコープより優先度の高いスコープで false に設定されている: 有効化が失敗します。そのスコープで依存関係を有効にするか、--scope を渡してそこに書き込みます

宣言されている場所でプラグインを再度有効にします：

claude plugin enable formatter

Claude Code は Successfully enabled plugin: formatter (scope: project) を出力し、検出されたスコープに名前を付けます。

plugin disable

プラグインをアンインストールせずに無効にします。claude.ai から同期されたプラグインの場合、プラグインとして <name>@synced を渡します。

claude plugin disable [plugin] [options]
フラグ 説明
-a, --all すべての有効なプラグインを無効にします。プラグイン名または --scope と組み合わせることはできません
-s, --scope <scope> 無効にするスコープ: user、project、または local。省略時は自動検出
--json stdout の最後の行に 1 つの JSON オブジェクトを出力します。plugin install --json と同じ形式です。Claude Code v2.1.268 以降が必要です

--scope なしで、スコープは plugin enable と同じローカル、プロジェクト、ユーザーの順序で自動検出されます。

プラグイン名も --all も渡さない場合、Claude Code は Please specify a plugin name or use --all to disable all plugins を出力し、1 で終了します。既に無効なプラグインを無効にすると、Plugin "formatter" is already disabled を出力し、plugin enable が既に有効なプラグインに対して行うのと同様に 1 で終了します。

コマンドは依然として必要なプラグインに対して失敗します：

  • 別の有効なプラグインがそれに依存している: コマンドが失敗し、最初に無効にする依存関係に名前を付けます
  • 組織がそれを同期プラグインとして要求している: コマンドが失敗し、何も保存されません

1 つのプラグインを無効にします：

claude plugin disable formatter

Claude Code は Successfully disabled plugin: formatter (scope: project) を出力します。

plugin update

プラグインをマーケットプレイスが提供する最新バージョンに更新します。新しいバージョンは次のセッションでロードされるか、実行中のセッションで /reload-plugins を実行した後にロードされます。

claude plugin update <plugin> [options]
フラグ 説明
-s, --scope <scope> 更新するスコープ: user、project、local、または managed。デフォルトはプラグインがインストールされているスコープ
-y, --yes コマンドソースプラグインから変更されたインストールコマンドをプロンプトなしで受け入れます。stdin または stdout が TTY でない場合は必須です。--accept-command を渡さない限り。Claude Code v2.1.229 以降が必要です
--accept-command <sha256> 前の --json 実行が shownCommand で報告した sha256 を持つマーケットプレイスで宣言されたコマンドを受け入れます。-y の代わりに使用します。-y と組み合わせることはできません。Claude Code v2.1.271 以降が必要です
--json stdout の最後の行に 1 つの JSON オブジェクトを出力します。plugin install --json と同じ形式です。Claude Code v2.1.268 以降が必要です

managed は更新できるが、インストールできない唯一のスコープです。管理者がインストールしたプラグインについては、組織のプラグインを管理するを参照してください。

プラグインを更新します：

claude plugin update formatter@my-marketplace

Claude Code は Checking for updates for plugin "formatter@my-marketplace"… を出力し、その後に結果を出力します。新しいものがない場合、formatter is already at the latest version (1.0.0). を出力し、0 で終了します。

ベアプラグイン名を渡すことができます。コマンドはインストール済みプラグインと照合します。異なるマーケットプレイスからインストール済みプラグインが名前を共有する場合、コマンドは更新を拒否し、実行する修飾 plugin-name@marketplace-name コマンドをリストします。ベア名による更新には Claude Code v2.1.246 以降が必要です。

plugin list

インストール済みプラグインをバージョン、スコープ、ステータスと共にリストします。

claude plugin list [options]
フラグ 説明
--json リストを JSON として出力
--available マーケットプレイスが提供するがインストールしていないプラグインもリストします。--json なしでは効果がありません

Claude Code は、各プラグインがどのようにロードされるかでグループ化された人間が読める出力を出力します：

  • Installed plugins:: マーケットプレイスからインストールしたプラグイン
  • Session-only plugins (--plugin-dir / --plugin-url):: 同じコマンドでこれらのフラグによってロードされたプラグイン（例：claude --plugin-dir ./my-plugin plugin list）
  • Skills-directory plugins (.claude/skills/*):: Claude Code がスキルディレクトリで見つけたプラグイン
  • Synced from claude.ai: claude.ai アカウントから同期されたプラグイン

どのグループにも何もない場合、Claude Code は No plugins installed. Use `claude plugin install` to install a plugin. を出力します。

JSON 出力

--json を使用すると、Claude Code はインストールごとに 1 つのオブジェクトを持つ配列を出力します。各オブジェクトは以下のフィールドを含みます。id、version、scope、enabled、および installPath は常に存在し、その他は適用される場合にのみ表示されます。

フィールド 型 説明
id 文字列 インストールの場合は name@marketplace、セッションのみのプラグインの場合は name@inline、スキルディレクトリプラグインの場合は name@skills-dir、claude.ai から同期されたプラグインの場合は name@synced
version 文字列 マーケットプレイスインストールの場合、Claude Code が計算したインストール時のバージョン。セッションのみ、スキルディレクトリ、または同期プラグインの場合、マニフェストの version、または宣言されていない場合は unknown
scope 文字列 インストールの場合は user、project、local、または managed。スキルディレクトリプラグインの場合は user または project。セッションのみのプラグインの場合は session。claude.ai から同期されたプラグインの場合は synced
enabled ブール値 マージされた設定でプラグインが有効かどうか
installPath 文字列 プラグインがロードされるディレクトリ
installedAt 文字列 インストールの ISO タイムスタンプ。マーケットプレイスインストールのみ
lastUpdated 文字列 最後の更新の ISO タイムスタンプ。マーケットプレイスインストールのみ
projectPath 文字列 インストールが属するプロジェクト。project および local スコープのみ
mcpServers オブジェクト マーケットプレイスがインストールしたプラグインが持つ場合、プラグインの MCP サーバー定義
errors 文字列の配列 プラグインがロードに失敗した場合のロードエラー
notes 文字列の配列 ロードして機能するプラグインのオーサリング警告
errorDetails オブジェクトの配列 各 errors エントリごとに 1 つのオブジェクト。診断 type と、プラグイン、マーケットプレイス、サーバー、またはファイルなど、それが参照する名前を提供します。Claude Code v2.1.268 以降が必要です
noteDetails オブジェクトの配列 各 notes エントリの同じ詳細オブジェクト。Claude Code v2.1.268 以降が必要です

--json --available を使用すると、Claude Code は配列の代わりに 1 つのオブジェクトを出力します。その installed フィールドはインストール済みプラグインオブジェクトの配列を保持し、その available フィールドはインストールされていない各マーケットプレイスプラグインを以下のフィールドを持つオブジェクトとして保持します。

フィールド 型 説明
pluginId 文字列 name@marketplace
name 文字列 マーケットプレイスのプラグイン名
marketplaceName 文字列 それを提供するマーケットプレイス
source 文字列またはオブジェクト マーケットプレイスエントリのソース：相対パスの場合は文字列、それ以外の場合はオブジェクト
description 文字列 エントリの説明（ある場合）
version 文字列 エントリのバージョン（宣言されている場合）
installCount 数値 インストール数（Claude Code がプラグインに対して持っている場合）

plugin details

プラグインのコンポーネントインベントリと予想トークンコストを表示します。

プラグインはロードされている必要があります：インストール済み、スキルディレクトリで見つかった、または同じコマンドで --plugin-dir または --plugin-url で渡されました。<name> はプラグイン name または name@marketplace です。

claude plugin details <name>

コマンドは --help を超えるフラグを取りません。

インストール済みプラグインが何を提供するかを表示します：

claude plugin details formatter

Claude Code はプラグインの名前、バージョン、説明、ソースを出力し、その後これらのセクションを出力します：

  • Component inventory: プラグインのスキル、エージェント、フック、MCP サーバー、および LSP サーバー
  • Projected token cost: プラグインがすべてのセッションに追加する常時オンのトークン
  • Per-component (rounded): 各スキル、エージェント、およびコマンドの常時オンおよびオンインボーク推定。プラグインが何も持たない場合は省略

2 つのコスト数値が何を意味するかについては、プラグインコストと使用量を測定するを参照してください。

ロードされていないプラグインの場合、Claude Code は Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk. を出力し、1 で終了します。

plugin prune

インストール済みプラグインが必要としなくなった自動インストール依存関係を削除します。コマンドは自分でインストールしたプラグインを削除することはありません。autoremove は prune のエイリアスです。

claude plugin prune [options]
フラグ 説明
-s, --scope <scope> スコープで削除: user、project、または local。デフォルトは user
--dry-run 削除せずに削除されるものをリストします
-y, --yes 確認プロンプトをスキップします。stdin または stdout が TTY でない場合は必須です

削除が削除するものをプレビューします：

claude plugin prune --dry-run

Claude Code は孤立した依存関係をリストし、(dry run — nothing removed) で終了します。削除するものがない場合、Nothing to prune で始まる行を出力します。

--dry-run なしで、コマンドは確認プロンプトで確認するか -y を渡した後にのみ孤立した依存関係を削除します。

プロンプトでどのように答えても、終了コードは 0 です。

prune が何をするかは、ターミナルが接続されているかどうか、および -y を渡すかどうかによって異なります：

ターミナルとフラグ 何が起こるか
インタラクティブターミナル、-y なし 孤立した依存関係をリストし、Remove? [y/N] と尋ねます
任意のターミナル、-y それらを削除し、Removed N auto-installed plugins: <names> を出力します
非 TTY stdin または stdout、-y なし リストを出力し、Not a TTY — run `claude plugin prune -y` to remove. を出力し、何も削除しません

plugin eval

プラグインのeval ケースを実行し、スコア付き結果を報告します。Claude Code v2.1.269 以降が必要です。

各ケースはプロンプトとグレーダーです。Claude Code はターゲットプラグインのみがロードされた分離セッションで複数回実行し、デフォルトではプラグインなしでも実行するため、レポートは違いを示します。

ケース形式、グレーダー、結果、および CI 使用については、eval でプラグインをテストするを参照してください。

claude plugin eval [target] [options]

オプションの target はデフォルトで現在のディレクトリになり、これらの形式のいずれかを取ります：

  • プラグインディレクトリ
  • 単一の prompt.md または case.yaml ファイル
  • name または name@marketplace としてインストール済みプラグイン
  • name@skills-dir

ターゲットを --tag、--allow-tools、および --json の前に配置します。これらの各オプションは、それに続く単語をその値として取るため、これらのいずれかの後に書かれたターゲットはタグ、ツール名、または JSON 出力パスの代わりにターゲットとして読み取られます。

この表は、ほとんどの実行が使用するオプションをリストします。--case、--tag、--output-dir、--report、--allow-real-servers、--keep-temp、および --verbose を含む完全なセットについては、claude plugin eval --help を実行してください。

オプション 説明 デフォルト
--runs <n> 各アームのケースごとの実行 各ケースの runs、それ以外は 3
-j, --concurrency <n> 一度に実行するエージェントセッション、1 から 8。レート制限を共有します 1
--model <model> テスト中のエージェントのモデル 各ケースの model、それ以外は ANTHROPIC_MODEL が設定されている場合、それ以外は Claude Code のデフォルト
--judge-model <model> llm および baseline グレーダーのモデル 小さく高速なモデル
--ablation <mode> none または with-without。プラグインなしベースラインと比較するを参照してください プラグインが解決される場合は with-without、それ以外は none
--threshold <0..1> ケースがこれ以下でスコアされた場合は終了 1 1.0
--max-cost-usd <usd> 支出がこれに達すると次の実行の前に停止し、終了 2、および部分的な結果を報告します 制限なし
--allow-tools <tools...> Bash、Write、Edit、または "mcp__plugin_<plugin>_<server>__*" などの読み取り専用セット以外のツールを付与します。ツールを付与するを参照してください
--scaffold 各ケースの scaffold_script を実行 オフ
--trust-plugin 最初の実行信頼プロンプトをスキップします。CI の場合。実行がアクセスできるものを参照してください オフ
--mocks <mode> record または off。MCP サーバーをモックを参照してください record
--eval-dir <dir> ケースを保持するプラグイン下のディレクトリ マニフェストの experimental.evals、それ以外は evals
--json [path] 結果ドキュメントを stdout に出力するか、.json パスに書き込みます
--no-publish HTML レポートをローカルに保つ

終了コードは実行がどのように終了したかを報告します。パイプラインで機能させるには、CI で eval を実行するを参照してください。

終了コード 意味
0 すべてのケースがしきい値を満たしている
1 失敗するケース、ロードエラー、または信頼されていないプラグインディレクトリ
2 部分的な実行
130 中断
143 終了

plugin eval init

現在のディレクトリのプラグイン用の eval スイートを作成します。Claude Code v2.1.269 以降が必要です。最初の eval スイートを作成するを参照してください。

claude plugin eval init [name] [options]

ターミナルでは、コマンドはオーサリングインタビューのためのインタラクティブな Claude Code セッションを開きます。インタビューでは、Claude は以下を実行します：

  1. プラグインを読む
  2. それが何をうまくすべきかを尋ねる
  3. ケースとグレーダーを提案する
  4. ケースファイルを書く
  5. ケースを実行し、グレーダーがあなたがするのと同じ方法でスコアするかどうかを確認するために、あなたと一緒に成績を確認します

--bare を使用するか、ターミナルなしで、コマンドは代わりに空白の単一ケーステンプレートを書き込みます。Claude がコマンドを Claude Code セッション内から実行する場合、コマンドはそのセッションが従うべきインタビュー指示を出力します。

オプションの name はケース名です。--bare を使用するか、ターミナルなしで必須です。コマンドはそのケースの空白テンプレートを書き込むためです。インタビューは 1 つを必要としません。

コマンドはこれらのオプションを受け入れます：

オプション 説明 デフォルト
--bare インタビューを実行する代わりに、<name> の空白 prompt.md と graders/criteria.md を書き込みます
-i, --interactive インタビューを要求します。ターミナルなしではテンプレートを書き込む代わりに失敗します
--eval-dir <dir> ケースを書き込む現在のディレクトリ下のディレクトリ マニフェストの experimental.evals、それ以外は evals

plugin tag

プラグインリリース用に <name>--v<version> という名前の注釈付き git タグを作成します。タグ付けする前に、コマンドはプラグインの plugin.json とそれをリストするマーケットプレイスエントリがバージョンに同意することを確認します。

リリースをタグ付けするタイミングについては、プラグインを公開するを参照してください。

claude plugin tag [path] [options]

[path] はプラグインディレクトリで、デフォルトは現在のディレクトリです。コマンドは、そのディレクトリから上へ歩いて、プラグインをリストする .claude-plugin/marketplace.json を見つけることで、マーケットプレイスエントリを見つけます。

フラグ 説明
--push タグを作成した後、--remote にプッシュします
--dry-run タグを作成せずに計画を出力します
-f, --force ダーティワーキングツリーとタグ既存チェックをスキップします
-m, --message <msg> タグ注釈メッセージ。%s はバージョンを表します。デフォルトは <name> <version>
--remote <name> --push でプッシュするリモート。デフォルトは origin

マーケットプレイスチェックアウトのプラグインのタグをプレビューします：

claude plugin tag plugins/formatter --dry-run

Claude Code は計画を出力します：

  • プラグイン名
  • バージョンとそれがどのファイルから来たか
  • マーケットプレイスエントリがある場合、一致するマーケットプレイスエントリ
  • タグ名
  • 実行する git tag および git push コマンド

--dry-run なしで、Claude Code は Created tag formatter--v1.0.0 を出力し、Pushed to origin または自分で実行するプッシュコマンドを出力します。プッシュが失敗した場合、タグはまだローカルで作成され、コマンドはエラーで終了します。

コマンドは 1 で終了し、安全にタグ付けできない場合は理由を出力します。一般的な理由は：

  • plugin.json またはマーケットプレイスエントリに version がない
  • タグが既に存在する
  • ワーキングツリーがダーティ

plugin validate

プラグインマニフェスト、マーケットプレイスマニフェスト、またはディレクトリ内のスキル、エージェント、およびコマンドを検証し、CI ジョブが機能できるコードで終了します。作成、テスト、編集ワークフローについては、プラグインの作成を参照してください。バリデーターが各マニフェストで何をチェックするかについては、プラグインマニフェストリファレンスおよびマーケットプレイスリファレンスを参照してください。

claude plugin validate <path> [options]
フラグ 説明
--strict 警告をエラーとして扱うため、ランタイムが許容する認識されないフィールドと欠落メタデータが実行に失敗します。Claude Code v2.1.145 以降が必要です
--json 検証レポートを同じ終了コードを持つ 1 つの JSON オブジェクトとして出力します。Claude Code v2.1.259 以降が必要です

コミット前にプラグインを検証します：

claude plugin validate ./my-plugin --strict

ディレクトリを検証する

<path> はマニフェストファイルまたはディレクトリです。ディレクトリが与えられた場合、Claude Code はそこで見つけたものによって何を検証するかを選択します：

  • .claude-plugin/marketplace.json（存在する場合）
  • それ以外の場合は .claude-plugin/plugin.json
  • それ以外の場合はコンポーネントファイル。ディレクトリの名前で選択されます。マニフェストなしでコンポーネントファイルを検証するには Claude Code v2.1.233 以降が必要です：
    • skills、agents、または commands という名前のディレクトリ：その中のファイル
    • .claude という名前のディレクトリ：その中の skills、agents、および commands ディレクトリ
    • その他のディレクトリ：その .claude の下のこれら 3 つのディレクトリ

Claude Code はディレクトリ内のシンボリックリンクをたどりません。リンクがどこにあるかによって異なります：

  • プラグインまたは .claude ルートの下にリンクされた skills、agents、または commands ディレクトリ: Claude Code は何も読み込まれなかったことを警告します。
  • skills、agents、または commands ディレクトリ内のリンクされたエントリ: Claude Code はそれをスキップし、ディレクトリごとにスキップしたエントリの数を警告します。セッションはロードします。
  • 名前を付けた skills、agents、または commands ディレクトリ自体がシンボリックリンク、またはその親 .claude ディレクトリ: Claude Code はエラーを報告し、その中の何もチェックしません。代わりに実際のディレクトリに名前を付けてください。

いくつかのファイルは検証実行では読み込まれません：

  • プラグインルートの SKILL.md: プラグインディレクトリに対して claude plugin validate を実行する場合、Claude Code はプラグインルートの SKILL.md をチェックしません
  • プラグインルートの CLAUDE.md: プラグイン実行では、Claude Code はプラグインルートの CLAUDE.md についても警告します
  • マーケットプレイス実行のプラグインファイル: マーケットプレイスディレクトリから、Claude Code はプラグインのスキル、エージェント、コマンド、またはフックファイルを開きません。これらのファイルのエラーを見つけるには、各プラグインディレクトリを検証してください

出力と終了コード

Claude Code は検証したファイル、エラーと警告とそのパス、および判定行を出力します。終了コードは判定に従います：

終了コード 判定行 意味
0 Validation passed または Validation passed with warnings マニフェストがロードされます。--strict を使用すると、警告もありません
1 Validation failed または Validation failed (--strict treats warnings as errors) エラー、または --strict の下での警告
2 Unexpected error during validation: <reason> バリデーター自体が失敗しました。読み取り不可能なパスなど

--json を使用すると、Claude Code はレポートを stdout に 1 つの JSON オブジェクトとして書き込みます。これらのトップレベルフィールドを持ちます：

  • success: 終了コードが与える同じ判定
  • strict: 実行が警告をエラーとして扱ったかどうか
  • target: Claude Code が検証した解決されたパス
  • manifest: マニフェスト自体の結果、またはマニフェストなしの実行の場合は null
  • contents: ファイルごとの結果。各結果は file に名前を付け、errors、warnings、および notes 配列を含みます

終了 2 では、コマンドは stdout に何も書き込みません。エラーメッセージは stderr に移動します。

claude plugin marketplace コマンド

シェルから claude plugin marketplace <subcommand> を実行して、プラグインをインストールするマーケットプレイスを追加、リスト、更新、および削除します。

  • 終了コード: これらのサブコマンドはプラグインコマンドの終了コード規約に従います
  • スコープ: それらの --scope フラグには -s 短形式がありません

マーケットプレイスが何であり、Claude Code がそれをキャッシュする方法については、プラグイン読み込みリファレンスを参照してください。

plugin marketplace add

GitHub リポジトリ、git URL、ホストされた marketplace.json、またはローカルパスからマーケットプレイスを追加し、設定ファイルで宣言します。

追加した後、Claude Code はインストール済みプラグインが欠落していた依存関係をインストールします。

claude plugin marketplace add <source> [options]
フラグ 説明
--scope <scope> マーケットプレイスを宣言する設定ファイル: user、project、または local。デフォルトは user
--sparse <paths...> git チェックアウトをこれらのディレクトリに制限します。モノレポの場合。github および git ソースのみ
--claudeai 引数を claude.ai でホストされたマーケットプレイスの名前として読み取ります。Claude Code v2.1.273 以降が必要です

<source> は以下の表の形式のいずれかを取り、その形式はソースタイプを決定し、Claude Code がマーケットプレイスをどのようにフェッチするかを決定します。結果のソースオブジェクトについては、マーケットプレイスリファレンスを参照してください。

入力 ソースタイプ Claude Code がそれをフェッチする方法
owner/repo、owner/repo#ref、または owner/repo@ref github GitHub リポジトリをクローンし、与えられた場合は ref にピン留めします。所有者とリポは GitHub 命名規則に従う必要があります
user@host:path[.git][#ref] git SSH 経由でクローン
https://example.com/repo.git[#ref]、または /_git/ を含む URL git Azure DevOps URL を含む HTTPS 経由でクローン
https://github.com/owner/repo または https://gitlab.com/namespace/project git .git を追加した後、HTTPS 経由でクローン
その他の http:// または https:// URL（.git なしの自己ホストされた git ホストを含む） url URL を marketplace.json としてフェッチします。代わりにリポジトリをクローンするには、.git を追加します
./path、../path、/path、または ~/path をディレクトリに directory ディレクトリを所定の位置で読み込みます。Windows では、.\、..\、および C:\ 形式も機能します
同じパス形式を .json ファイルに file ファイルを所定の位置で読み込みます

.git サフィックスを含まないクローン URL を持つホスト（AWS CodeCommit など）の場合、代わりに extraKnownMarketplaces にマーケットプレイスを git エントリとして追加してください。Claude Code は URL が .git で終わるかどうかに関係なく git エントリをクローンします。

Claude Code はネストされたサブグループを持つ gitlab.com URL もクローンします（例：https://gitlab.com/group/subgroup/project）。

マーケットプレイスを追加してプロジェクトと共有します：

claude plugin marketplace add your-org/your-marketplace --scope project

Claude Code は Successfully added marketplace: your-marketplace (declared in project settings) を出力し、マーケットプレイス自体のマニフェストから name を使用します。繰り返し追加または無効なソースは、代わりにこれらの結果のいずれかを出力します：

  • マーケットプレイスが既にディスク上にある: 出力は Marketplace 'your-marketplace' already on disk — declared in project settings で、終了コードは 0 です
  • 認識されないソース: 出力は Invalid marketplace source format. Try: owner/repo, https://..., or ./path で、終了コードは 1 です
  • gitlab.example.com/team/plugins などのベアホスト: 追加は無効な owner/repo 短縮形として失敗し、メッセージは https:// を追加するか、ローカルパスを使用するよう指示します

claude.ai でホストされたマーケットプレイスを claude plugin marketplace list の From claude.ai: セクションで出力された名前で追加します：

claude plugin marketplace add --claudeai claudeai-organization-library

--claudeai を使用すると、コマンドは --scope と --sparse を拒否します。マーケットプレイスはアカウント用にホストされ、設定ファイルで宣言されていないため、プロジェクトの .claude/settings.json を通じて共有することはできません。

plugin marketplace list

追加したすべてのマーケットプレイスをそのソースと共にリストします。

claude plugin marketplace list [options]
フラグ 説明
--json リストを JSON として出力

Claude Code は Configured marketplaces: を出力し、マーケットプレイスごとに 1 つの Source: 行を出力するか、No marketplaces configured を出力します。

--json を使用すると、Claude Code はマーケットプレイスごとに 1 つのオブジェクトを持つ配列を出力し、以下のフィールドを含みます。すべてのフィールドは文字列です。

フィールド 説明
name マーケットプレイスの名前
source github、git、url、directory、file、または claudeai
repo owner/repo。github ソースのみ
url クローンまたはフェッチ URL。git および url ソースのみ
path ローカルパス。directory および file ソースのみ
ref ピン留めされたブランチまたはタグ。github および git ソース、ピン留めされた場合のみ
installLocation Claude Code がマーケットプレイスをキャッシュした場所

追加された claude.ai マーケットプレイスにはローカルクローンがないため、そのエントリは installLocation の代わりに claude.ai 識別子 marketplaceId と organizationUuid を含みます。また、記録されている場合は scope と status も含みます。

ターミナルセッションが claude.ai アカウントからプラグインを同期する場合、テキストリストは From claude.ai: セクションで終了します。そのセクションは、claude.ai が追加していないアカウント用にリストするマーケットプレイスに名前を付けます。git ベースとホストされたの両方です。Claude Code v2.1.273 以降が必要です。

そのセクションからマーケットプレイスを追加するには、claude.ai からマーケットプレイスを追加するを参照してください。

--json 出力は設定されたマーケットプレイスのみをカバーし、セクションを除外します。

plugin marketplace remove

マーケットプレイスの宣言を設定から削除します。rm は remove のエイリアスです。

claude plugin marketplace remove <name> [options]

<name> は plugin marketplace list が表示するマーケットプレイス名で、add に渡したソースではありません。

フラグ 説明
--scope <scope> 1 つの設定スコープから宣言を削除します: user、project、または local。なしで、Claude Code はすべてのスコープから削除します

すべてのスコープからマーケットプレイスを削除します：

claude plugin marketplace remove your-marketplace

Claude Code は Successfully removed marketplace: your-marketplace を出力し、スコープを設定した場合は (from project settings) を追加します。マーケットプレイスを宣言しない設定ファイルにスコープを設定した場合、コマンドは Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes. で失敗します

plugin marketplace update

1 つのマーケットプレイス、またはすべてのマーケットプレイスをそのソースから更新して、新しいプラグインとバージョンをフェッチします。ブランチまたはタグ ref で追加されたマーケットプレイスは、リポジトリのデフォルトブランチではなく、その ref の最新コミットに更新されます。

claude plugin marketplace update [name]

コマンドは --help を超えるフラグを取りません。

1 つのマーケットプレイスを更新します：

claude plugin marketplace update your-marketplace

Claude Code は Successfully updated marketplace: your-marketplace を出力します。名前を省略すると、Successfully updated 2 marketplaces などのカウントを出力します。マーケットプレイスが追加されていない場合、No marketplaces configured を出力し、0 で終了します。

セッション内の /plugin

インタラクティブセッション内では、/plugin はプラグインパネルを開きます。各サブコマンドはパネルをタブで開いたり、そこでアクションを実行したり、結果をインラインで出力したりします。/plugins と /marketplace は /plugin のエイリアスです。

これらのコマンドはインタラクティブターミナルセッションでのみ実行できます。claude -p などの非インタラクティブ実行では、Claude Code は /plugin がこの環境では利用できないと返答します。

どのサーフェスが /plugin を持つか、それなしでインストールする方法、および各パネルタブが何を表示するかについては、プラグインのインストールと管理を参照してください。

<plugin> はプラグイン name または name@marketplace です。

以下の表は、すべてのセッション形式を一覧表示しています。シェルサブコマンド init、update、details、prune、eval、および eval init にはセッション形式がありません。

コマンド エイリアス 機能
/plugin Discover タブでパネルを開きます。/plugin の後の認識されない最初の単語も同じことを行います
/plugin help /plugin --help、/plugin -h /plugin サブコマンドの使用方法リストを表示します
/plugin list [--enabled|--disabled] ls マーケットプレイスにインストールされたプラグインをインラインで出力します。バージョン、スコープ、ステータスが表示されます。フィルターフラグはその状態のみを表示します。有効化状態がまだ適用されていないプラグインは — /reload-plugins を実行して適用してください とマークされます。Claude Code v2.1.163 以降が必要です
/plugin install i Discover タブを開きます
/plugin install <plugin> i Discover タブでプラグインの詳細を開きます。name@marketplace の場合、そのマーケットプレイスのリストで開きます
/plugin install <plugin> --marketplace <source> i <source> のマーケットプレイスをまだ追加していない場合は追加し、最初に確認を求めてから、プラグインの詳細を開きます。マーケットプレイスを追加して 1 つのコマンドでインストールを参照してください。Claude Code v2.1.275 以降が必要です
/plugin manage Installed タブを開きます
/plugin stats /skill-doctor が利用可能なセッションで Stats タブを開きます。その他の場所では Discover タブでパネルを開きます
/plugin enable <plugin> Installed タブでプラグインを開いて有効化します
/plugin disable <plugin> Installed タブでプラグインを開いて無効化します
/plugin uninstall <plugin> Installed タブでプラグインを開いてアンインストールします
/plugin configure <plugin> config プラグインの userConfig ダイアログを開くか、プラグインが宣言していないことを報告します。Claude Code v2.1.147 以降が必要です
/plugin validate <path> claude plugin validate と同じレポートをインラインで出力します
/plugin tag [path] [--push] [--dry-run] [--force] claude plugin tag が行うようにリリースタグを作成します。--push、--dry-run、--force または -f を受け入れます。その他のフラグまたは追加の引数がある場合、Claude Code は代わりに使用方法を出力します
/plugin marketplace market 目に見える動作はしません。add、list、update、または remove を渡してください
/plugin marketplace add [source] market add ソースを指定すると、それを追加して結果を報告します。指定しない場合は、マーケットプレイスを追加 入力を開きます
/plugin marketplace list market list マーケットプレイス名をインラインで出力します
/plugin marketplace update [name] market update Marketplaces タブを開きます。名前を指定すると、そこでそのマーケットプレイスを更新します
/plugin marketplace remove [name] market remove、market rm、marketplace rm Marketplaces タブを開きます。名前を指定すると、そこでそのマーケットプレイスを削除します

/plugin enable、disable、uninstall、または configure で現在のプロジェクトにインストールされていないプラグインを指定した場合、Claude Code はアクションを実行する代わりに Plugin "<plugin>" is not installed in this project を出力します。

/reload-plugins

実行中のセッションを再起動せずに、保留中のプラグイン変更をセッションに適用します。保留中の変更は、セッション開始以降にディスク上でインストール、更新、有効化、無効化、または編集したプラグインです。

保留中の変更を加えて /plugin パネルを閉じると、Claude Code は自動的に /reload-plugins を実行します。パネル外で発生するプラグイン変更（別のターミナルで実行した claude plugin コマンドなど）の後に自分で実行してください。

/reload-plugins [--force]
フラグ 説明
--force プロンプトキャッシュを無効にする場合でも、リロードを適用します。ダッシュなしの force も機能します

リロード概要

Claude Code はすべてのアクティブなプラグインをリロードし、1 つの概要行 Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers を出力します。インタラクティブターミナルのないセッションではプラグイン MCP サーバーカウントを省略します。プラグインが失敗した場合、概要は N errors during load. Run /plugin for details. を追加します

スキルカウントは、プラグインが提供するすべてのスキル（commands/ エントリとその SKILL.md スキルの両方）をカバーします。エージェントカウントはセッションにロードされたエージェントの数で、プラグインから来ていないものを含みます。

リロードされたプラグインの依存関係が欠落している場合、Claude Code はそれらをインストールし、再度リロードし、概要に (+ N dependencies: <names>) resolved を追加します。

MCP ツールを変更するリロード

リロードがプラグイン MCP サーバーまたは LSP ツールを追加または削除し、その変更がプロンプトキャッシュを無効にする場合、Claude Code はリロードを適用しません。This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply. などの行を出力します。--force を渡して、とにかく適用してください。

インタラクティブターミナルのないセッション

/reload-plugins はデスクトップアプリ、Agent SDK、および 非インタラクティブモード（-p 付き）などのインタラクティブターミナルのないセッションでも実行されます。Claude Code v2.1.260 以降が必要です。

これらのセッションでは、コマンドは -p プロンプトまたはデスクトップアプリのプロンプトボックスなど、セッション自体に入力する場合にのみ実行されます。Remote Control またはSlack から中継されたメッセージなど、別の方法で到着した場合、コマンドは /reload-plugins isn't available over a remote connection in this session. と返信し、何もリロードしません。

これらのセッションのリロードはプラグイン MCP サーバーを接続または切断しません。これらの変更は次のセッションで有効になります。

1 つのセッションのためにプラグインをロードするフラグ

2 つの claude フラグは、インストールせずに 1 つのセッションのためだけにプラグインをロードします。両方とも繰り返し可能です。

プラグイン作成者はそれらを使用して、公開する前にプラグインをテストします。ロード編集リロードワークフローについては、マーケットプレイスなしで開発するを参照してください。

フラグ 説明 例
--plugin-dir <path> ディレクトリまたはそのディレクトリの .zip アーカイブからプラグインをロードします。プラグインのフォルダは、.claude-plugin/plugin.json を保持する各子フォルダをロードします。各フラグは 1 つのパスを取ります claude --plugin-dir ./my-plugin --plugin-dir ./other.zip
--plugin-url <url> URL からプラグイン .zip アーカイブをフェッチします。フラグを繰り返すか、1 つの引用符で囲まれた値で複数の URL をスペース区切りで渡します claude --plugin-url "https://example.com/a.zip https://example.com/b.zip"

どちらかのフラグがロードするプラグインはセッションのみのプラグインです。claude plugin list はそれを <name>@inline としてスコープ session で表示しますが、同じフラグがサブコマンドの前にある場合のみです。たとえば、claude --plugin-dir ./my-plugin plugin list を実行してください。

セッションのみのプラグインがインストール済みプラグインと名前を共有する場合、Claude Code はそのセッションのセッションのみのコピーをロードし、インストール済みのコピーをスキップします。インストール済みのコピーは、claude plugin disable <name>@inline でセッションのみのコピーを無効にした場合、または管理設定がそのプラグイン名をロックする場合にロードされます。優先度については、プラグイン読み込みリファレンスを参照してください。

管理者は、CLAUDE_CODE_PLUGIN_DIRS 変数で名前が付けられたフォルダを含む両方のフラグを拒否できます。管理設定 disableSideloadFlags。Claude Code はその後、フラグが組織の管理設定によって無効化されていることを出力し、起動せずに 1 で終了します。

Agent SDK から、plugins オプションは --plugin-dir と同等です。

次のステップ