Skip to content
← リリースに戻る · 2.1.265
新機能 / v2.1.265

--plugin-dirのフォルダ一括指定

CHANGELOG 原文（英語）

Added support for pointing --plugin-dir at a folder of plugins: each child folder with a manifest loads, and children added or removed while running are picked up
公式の変更履歴を開く ↗

日本語での補足

--plugin-dirにプラグインをまとめたフォルダを指定できるように追加。manifestを持つ各子フォルダが読み込まれ、実行中に追加・削除された子フォルダも反映される

ドキュメント

プラグインをローカルでテストする 全文を読む（英語原文） →

ドキュメントの抜粋（参考訳）

プラグインをローカルでテストする

開発中にプラグインをテストするには --plugin-dir フラグを使います。インストールせずに、プラグインを直接読み込みます。

claude --plugin-dir ./my-plugin

このフラグは、プラグインディレクトリの .zip アーカイブも受け付けます。

claude --plugin-dir ./my-plugin.zip

--plugin-dir で指定したプラグインが、インストール済みのマーケットプレイスプラグインと同じ名前を持つ場合、そのセッションではローカルのコピーが優先されます。これにより、すでにインストール済みのプラグインへの変更を、いったんアンインストールせずにテストできます。例外は、管理設定が強制的に有効化または無効化しているプラグインで、--plugin-dir はそれらを上書きできません。

プラグインに変更を加えたら、/reload-plugins を実行すると、再起動せずに更新を反映できます。これにより、プラグイン、スキル、エージェント、フック、プラグインの MCP サーバー、プラグインの LSP サーバーが再読み込みされます。対話型ターミナルのないセッションでは、プラグインの MCP サーバーの変更は次回のセッションまで反映されません。プラグインの各コンポーネントは、次の方法でテストします。

  • /plugin-name:skill-name でスキルを試す
  • /context の Custom Agents にエージェントが表示されることを確認する、またはスコープ付きの名前で @ メンションする
  • 各フックが一致するイベントを発生させ（PostToolUse フックであれば、Claude にファイルを編集させるなど）、その効果を確認する。Claude Code は、どのフックが一致したか、その終了コード、出力をデバッグログに記録します

フラグを複数回指定すると、複数のプラグインを一度に読み込めます。

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

依存先のプラグインと合わせてプラグインをテストする方法は、プラグインとその依存先をローカルでテストするを参照してください。

フラグを追加できないセッションでプラグインを読み込むには、代わりに CLAUDE_CODE_PLUGIN_DIRS 環境変数に、絶対パスを列挙してください。Claude Code は、--plugin-dir のパスと同様に、各パスを読み込みます。これらのプラグインは、--plugin-dir で渡したプラグインに追加される形で読み込まれます。プロジェクト設定とローカル設定では、この変数を設定できません。CLAUDE_CODE_PLUGIN_DIRS には Claude Code v2.1.280 以降が必要です。

--plugin-dir でプラグインを試すと、それが機能するかどうかはわかります。Claude が実際にどれくらいの頻度でそのプラグインを使い、正しい結果を得られるかを調べるには、claude plugin eval を使って、一連のテストプロンプトに対して実行します。各プロンプトは、プラグインを読み込んだ状態と読み込んでいない状態でそれぞれ複数回実行されるため、そのプラグインが何をもたらしているかがわかり、変更時や新しいモデルのリリース時の劣化も検出できます。

複数のプラグインを 1 か所から読み込むには、それらをまとめたフォルダを、--plugin-dir ./plugins のように渡します。プラグインのフォルダを読み込むには Claude Code v2.1.265 以降が必要です。Claude Code は、フォルダの最上位を読み取ってどのプラグインを読み込むかを決定し、対話型セッションでは、その後の変更に備えてフォルダを監視し続けます。

  • 読み込まれるもの：フォルダの最上位にマニフェストもプラグインのコンポーネントもない場合、Claude Code はそのフォルダをプラグインの集まりとして扱います。.claude-plugin/plugin.json マニフェストを持つ直下の各サブフォルダが、個別のプラグインとして読み込まれます。Claude Code は、マニフェストのないプラグインを含め、フォルダ内のそれ以外のものはエラーを報告せずにスキップします。
  • 対話型セッション中の変更：追加したサブフォルダは、マニフェストが揃った時点で新しいプラグインとして読み込まれ、サブフォルダを削除すると、そのプラグインは読み込み解除されます。Claude Code は、変更のたびにセッション内に 1 行出力します。会話の途中での変更適用がプロンプトキャッシュを無効化する場合、Claude Code はその変更を保留し、適用するには /reload-plugins を実行するようにその行で伝えます。

CI のビルド成果物のように、すでに .zip アーカイブとしてパッケージ化され、URL で公開されているプラグインをテストするには、代わりに --plugin-url を使います。Claude Code は起動時にそのアーカイブを取得し、そのセッションだけに読み込みます。アーカイブを取得できない場合、またはアーカイブが不正な場合は、そのプラグインなしで起動し、/plugin マネージャーの Errors タブで確認できるプラグイン読み込みエラーを記録します。他のプラグインソースと同じ信頼性に関する注意点が当てはまるため、このフラグの参照先は、自分が管理している、または信頼できるアーカイブに限定してください。

複数のプラグインを読み込むには、URL ごとにフラグを繰り返します。

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

または、スペース区切りの URL を 1 つの引用符付き引数として渡します。

claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

取得日 · 2026-09-23

変更の詳細