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

重複名プラグインのhook除外を通知

CHANGELOG 原文(英語)

Added a note in /plugin on a plugin whose hooks are left out because another enabled plugin has the same name
公式の変更履歴を開く ↗

日本語での補足

別の有効なプラグインと名前が重複しているためhookが除外されているプラグインについて、/pluginに注記を追加。

ドキュメント

ドキュメントの抜粋(参考訳)

名前の競合

異なる出どころの有効なプラグインが同じマニフェスト名を共有している場合、次の順序で、どちらを読み込むかが優先度の高い順に決まります。

  1. 管理設定の enabledPlugins に、その id が true または false として現れるプラグイン。id の名前部分とマニフェスト名が一致する --plugin-dir のコピーは読み込まれず、--plugin-dir copy of "<name>" ignored: plugin is locked by managed settings と表示されます
  2. 有効な --plugin-dir、--plugin-url、または CLAUDE_CODE_PLUGIN_DIRS のプラグイン。これは、同じ名前のインストール済みマーケットプレイスプラグインまたはスキルディレクトリのプラグインを置き換えます。
    • インストール済みマーケットプレイスプラグイン:何も表示せずに置き換えられます。claude plugin list では、その行が設定を反映しているため、マーケットプレイス側の行は依然として有効と表示されます。--debug で起動したときに Claude Code が ~/.claude/debug/ 配下に書き込むログだけが、Plugin "<name>" from --plugin-dir overrides installed version を記録します
    • スキルディレクトリのプラグイン:/plugin の Errors タブに、Not loaded — the name "<name>" is already taken by a session-only plugin (--plugin-dir / --plugin-url), which takes precedence という行が表示され、置き換えられます
  3. インストール済みマーケットプレイスプラグイン。同じ名前のスキルディレクトリのプラグインには、インストール済みプラグインの名前を挙げた、同じ Not loaded 行が表示されます
  4. スキルディレクトリのプラグイン。この種類が 2 つある場合は、~/.claude/skills/ 配下のコピーが読み込まれ、プロジェクトの .claude/skills/ のコピーは、どちらのパスが優先したかを示す行とともに取り下げられます
  5. claude.ai から同期されたプラグイン。他のいずれかの出どころの有効なプラグインが同じ名前と一致する場合、Claude Code はその有効なプラグインを読み込み、同期されたコピーは読み込まれなかったものとして報告します。代わりに claude.ai 側のコピーを使うには、自分のコピーを無効にしてください

この順序はマニフェスト名を比較するため、hello-plugin という名前の --plugin-dir プラグインは、hello@example-marketplace のマニフェストも "name": "hello-plugin" となっていれば、それを置き換えます。

有効な 2 つのプラグインが同じ名前を持つ場合のフック

異なるマーケットプレイスから同じマニフェスト名を持つ 2 つのプラグインをインストールして有効にすると、/plugin ではどちらも有効と表示されますが、一方のフックは除外されます。hooks/hooks.json のフックを登録するのは名前ごとに 1 つのプラグインだけで、フックモジュールを読み込むのも名前ごとに 1 つのプラグインだけです。組織の管理設定が一方のコピーを有効にしている場合は、そのコピーが名前を保持します。それ以外の場合は、Claude Code が最初に読み込んだコピーが名前を保持します。

どちらのコピーが名前を保持しているかを確認するには、セッションで /plugin を実行し、Errors タブを開きます。フックが除外されたコピーについての注記がそこに表示され、名前を保持しているコピーが示されます。除外されたコピーの詳細にも同じ注記が表示されます。hooks/hooks.json のフックの場合、注記は Its hooks.json hooks do not run で始まり、フックモジュールの場合は Its hooks module does not load で始まります。この注記には Claude Code v2.1.296 以降が必要です。

代わりに除外されたコピーのフックを実行するには、名前を保持しているコピーを無効化またはアンインストールしてから、セッションで /reload-plugins を実行します。再読み込みによって残ったコピーのフックが登録され、注記は消えます。名前を保持しているコピーが管理設定によって有効にされている場合、そのコピーは無効にできず、両方がインストールされている間は、もう一方のコピーのフックはオフのままになります。

セッション限定のプラグインを読み込ませないようにする

--plugin-dir のプラグインが何かを覆い隠さないようにしたい場合、または親プロセスが代わりにそのフラグを渡してくる場合にそれを無効にしたい場合は、任意の設定ファイルでその id を false に設定します。マニフェスト名が hello-plugin であるプラグインの場合、エントリは "enabledPlugins": {"hello-plugin@inline": false} になります。無効化されたセッション限定のプラグインは何も覆い隠さないため、代わりにマーケットプレイスまたはスキルディレクトリのコピーが読み込まれます。

取得日 · 2026-11-20

変更の詳細