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

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

これらのケースは他のページで説明されています：

ステップのインストールと管理、および /plugin が実行される場所: プラグインのインストールと管理を参照してください
コマンドがディスク上で何を変更し、どのスコープが優先されるか: プラグイン読み込みリファレンスを参照してください
エラーメッセージの意味: プラグインのトラブルシューティングを参照してください

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 は以下を実行します：

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

--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 Code はそのキャッシュも削除し、そこからインストールしたすべてのプラグインをアンインストールします。--scope なしで、コマンドはすべてのスコープから宣言を削除します。マーケットプレイスをプラグインを失わずに更新するには、代わりに plugin marketplace update を実行してください。

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 と同等です。

次のステップ

プラグインのインストールと管理: ステップと同じ操作。各ステップで表示される内容
プラグイン読み込みリファレンス: 各コマンドがディスク上で何を変更し、どのスコープが有効になるか
プラグインのトラブルシューティング: インストール、マーケットプレイス、ロード、および検証エラーメッセージとその修正
プラグインマニフェストリファレンス: claude plugin validate がチェックするフィールド