SpyBara
Go Premium

plugins/troubleshooting.md 2026-10-08 22:58 UTC to 2026-10-09 21:01 UTC

This page contains 73 additions and 3 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sun 4 23:58 Mon 5 23:58 Tue 6 23:59 Wed 7 23:59 Fri 9 22:01

プラグインのトラブルシューティング

Claude Code でプラグインエラーを修正します。/plugin の実行からインストール、組織ポリシーまで、段階ごとにグループ化された正確なメッセージを見つけます。

このページでは、Claude Code プラグインおよびマーケットプレイス(Claude Code がプラグインをインストールするカタログ)のエラーメッセージと症状を一覧表示しています。各エントリは、原因、1 つの修正方法、および修正が機能した後に表示される内容を示しています。

メッセージがプラグインまたはマーケットプレイスに名前を付ける場合、エントリは <name> などのプレースホルダーを表示します。

プラグインをインストールする場合、構築する場合、マーケットプレイスをホストする場合、または組織のプラグインを管理する場合は、このページを使用してください。

表示されたメッセージを検索してください。各メッセージは、実行したコマンドではなく、それを生成する段階の下に一覧表示されています。たとえば、マーケットプレイスが見つからないためにインストールが失敗する場合があるため、そのメッセージはマーケットプレイスを追加するの下に表示されます。

`/plugin` が実行される場所を見つける

/plugin は、実行中の Claude Code ターミナルセッション内で入力するコマンドであり、インタラクティブパネルを開きます。このセクションのエントリは、入力できるが実行できない場所と、存在しないコマンドスペルをカバーしています。

`/plugin isn't available in this environment`

/plugin を Claude Code ターミナルセッション以外の場所で入力し、Claude は何も開く代わりにこの行で返信しました。

/plugin パネルを描画するターミナルがないセッションでこの返信を取得します:claude -p を使用した非インタラクティブモード、Agent SDK、Claude デスクトップアプリの Code タブ、VS Code 拡張パネル、および claude.ai/code のブラウザ。

VS Code 拡張パネルでは、/plugin install <plugin>@<marketplace> など、その後に何かがある /plugin 行のみがこの返信を取得します。単独で入力された /plugin または /plugins は、プラグインを管理ダイアログを開きます。

代わりに、使用しているサーフェスからプラグインをインストールしてください:

  • Claude デスクトップアプリ、ローカルまたは SSH セッション:プロンプトの横にある + ボタンをクリックし、プラグイン、プラグインを追加をクリックしてプラグインブラウザを開きます
  • VS Code 拡張:プラグインをインストールの下の VS Code タブを使用してください
  • Web 上の Claude Code、またはデスクトップクラウドセッション:クラウドセッションにはプラグインブラウザがありません。プラグインをインストールの下の Cloud session タブを参照して、クラウドセッションが読み込むものを確認してください
  • アクセス権のあるターミナル:claude を実行してそこで /plugin を入力するか、セッションを開始せずにシェルで claude plugin install <plugin>@<marketplace> を実行してください

ターミナルインストールが機能する場合、/plugin は ✓ Installed <plugin>. で始まるインストール概要を出力し、claude plugin install は Successfully installed plugin: <plugin>@<marketplace> を出力します。

`zsh: no such file or directory: /plugin`

シェルプロンプトで /plugin ... を入力し、シェルが /plugin という名前のファイルが存在しないと報告しました。Bash は bash: /plugin: No such file or directory と報告します。

/plugin は Claude Code セッション内で入力するコマンドであり、シェルプロンプトではありません。セッションを開始して、そこで同じコマンドを入力してください:

claude

次に、Claude Code プロンプトで:

/plugin install <plugin>@<marketplace>

成功したインストールは ✓ Installed <plugin>. で始まる概要を出力します。インストール自体が失敗する場合、そのメッセージはマーケットプレイスを追加またはプラグインをインストールの下にあります。

セッションを開始せずにシェルからインストールするには、代わりに claude plugin install <plugin>@<marketplace> を実行してください。

`The term '/plugin' is not recognized as the name of a cmdlet`

PowerShell プロンプトで /plugin ... を入力し、/plugin は Claude Code コマンドであり、プログラムではありません。Bash と Zsh はこのエラーの独自の形式を報告します。

代わりに、これらのいずれかを使用してください:

  • claude を実行し、Claude Code プロンプトで /plugin を入力してください
  • PowerShell でセッションを開始せずに claude plugin install <plugin>@<marketplace> を実行してください

`claude: command not found` after `claude plugin ...`

シェルで claude plugin install ... を実行し、シェルが claude をまったく見つけられませんでした。Windows では、メッセージは 'claude' is not recognized as the name of a cmdlet または 'claude' is not recognized as an internal or external command です。

原因はプラグインコマンドではありません。PATH を確認するの手順に従い、プラグインコマンドを再試行してください。

`Unknown command` と存在しないコマンドスペル

どこかで見たプラグインコマンドを入力し、セッションで Unknown command: /<name> を取得したか、シェルの claude バイナリから error: unknown command '<name>' または error: unknown option '<flag>' を取得しました。

Claude Code が持たないいくつかのコマンドスペルが使用されています。下の表は、各スペルを実際のコマンドにマップします。プラグインコマンドリファレンスはサブコマンドとそのフラグを一覧表示しています。

入力したもの Claude Code が言うこと 代わりに使用してください
claude plugin add <source> error: unknown command 'add' マーケットプレイスを追加するには claude plugin marketplace add <source>、またはプラグインをインストールするには claude plugin install <plugin>@<marketplace>
claude plugin install <plugin> --project error: unknown option '--project' claude plugin install <plugin>@<marketplace> --scope project
/install <plugin> Unknown command: /install /plugin install <plugin>@<marketplace>
/plugin add <source> /plugin パネルが Discover タブで開きます /plugin marketplace add <source>
marketplace.anthropic.com をソースとして Invalid marketplace source format. Try: owner/repo, https://..., or ./path 公式マーケットプレイスの場合は anthropics/claude-plugins-official

これらのスペルは間違っているように見えますが、機能します:

  • claude plugins は claude plugin のエイリアスです
  • claude plugin remove は claude plugin uninstall のエイリアスです
  • セッション内の /plugins と /marketplace は /plugin と同じパネルを開きます

マーケットプレイスを追加

マーケットプレイスは、git リポジトリ、URL、またはローカルパスから Claude Code に追加するカタログです。これらのエントリは、追加が失敗するか、後で更新が失敗するときに取得するメッセージをカバーしています。

`Marketplace "claude-plugins-official" not found`

セッションで /plugin install <plugin>@claude-plugins-official を実行し、Claude Code はこの名前のマーケットプレイスがないと報告しました。

公式マーケットプレイスはまだこのマシンに登録されていません。Claude Code は通常、インタラクティブターミナルセッションを初めて開始するときに自動的に登録します。VS Code 拡張を通じてのみ Claude Code を使用した場合、またはそのステップをスキップまたは延期する場合は実行されていません:

  • ポリシーがソースをブロックする場合
  • CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL が設定されている場合
  • 再試行を待機している失敗した試行の後

claude plugin シェルコマンドは決してそれを登録しません。

追加してから、インストールを再試行してください:

/plugin marketplace add anthropics/claude-plugins-official

Claude Code は Successfully added marketplace: claude-plugins-official を出力し、/plugin marketplace list はマーケットプレイスをそのソースと共に表示します。

このメッセージの他のマーケットプレイス名については、Marketplace "<name>" not foundを参照してください。

同じ文字列は、パネルの読み込み失敗のリストである /plugin Errors タブにも表示されます。設定で名前が付けられたプラグインが追加していないマーケットプレイスを名前付けする場合。

`Marketplace "" not found`

セッションで /plugin install を実行し、Claude Code はこの名前のマーケットプレイスがないと報告しました。このコマンドの 2 つの形式がこのメッセージに到達します:

  • /plugin install <plugin>@<name>:インストール行(多くの場合は誰かが送信したもの)は、追加していないマーケットプレイスを名前付けします。このエントリの残りの部分は、それを見つけて追加することをカバーしています。
  • /plugin install <source>(パス、URL、または owner/repo を使用):このフォームは、既に追加したソースであっても、インストールする代わりにメッセージを報告します。1 つのコマンドでソースからインストールするには、マーケットプレイスを追加してインストールを参照してください。

名前が claudeai- で始まる場合、マーケットプレイスは claude.ai でホストされており、シェルから claude plugin marketplace add --claudeai <name> で名前で追加します。claude.ai からマーケットプレイスを追加を参照してください。

他の名前については、インストール行はマーケットプレイスの名前を付けますが、マーケットプレイスがホストされている場所は言いません。Claude Code にはマーケットプレイス名を検索するインデックスがありません。行を送信した人にマーケットプレイスのソースを尋ねてください。これは GitHub owner/repo、git URL、またはパスです。次にマーケットプレイスを追加し、インストール行を再度実行してください。

誰かが送信したマーケットプレイスはサードパーティであるため、インストール前にプラグインを確認してください。

既にマーケットプレイスを追加した場合は、/plugin marketplace list に対してスペルを確認してください。

`Invalid marketplace source format`

/plugin marketplace add <source>、claude plugin marketplace add <source>、または claude plugin install <plugin> --marketplace <source> を実行し、Claude Code は Invalid marketplace source format. Try: owner/repo, https://..., or ./path で返信しました。

Claude Code は、次のいずれかの形式でソースを受け入れます:

  • GitHub owner/repo ショートハンド
  • https:// または http:// URL
  • user@host:path SSH URL
  • ./、../、/、または ~ で始まるローカルパス

claude-plugins-official などの裸の名前はそれらのいずれにも一致しません。marketplace.anthropic.com などの裸のホスト名も同様です。

ソースを受け入れられた形式の 1 つで再入力してください:

/plugin marketplace add anthropics/claude-plugins-official

追加が機能する場合、Claude Code は Successfully added marketplace: <name> を出力します。

`'' is not a valid GitHub owner/repo shorthand`

github.com/owner/repo または gitlab.example.com/group/project パスなど、owner/repo ではないスラッシュを含むソースを渡しました。Claude Code はこのメッセージと受け入れられた形式のリストでそれを拒否しました。

owner/repo ショートハンドは GitHub のみであり、GitHub の命名規則に従う必要があるため、ホスト名または追加のパスセグメントが失敗します。マーケットプレイスがホストされている場所に一致する形式でソースを渡してください:

  • 任意のホスト上のリポジトリ:完全なクローン URL
  • ホストされた marketplace.json:その https:// URL
  • ローカルチェックアウト:./path または絶対パス

たとえば、公式マーケットプレイスをそのクローン URL で追加するには、セッションで:

/plugin marketplace add https://github.com/anthropics/claude-plugins-official.git

成功した追加は Successfully added marketplace: <name> を出力します。

`Invalid git URL`

マーケットプレイスを追加したか、プラグインをインストールしたか、git アドレスから更新を実行し、コマンドが Invalid git URL で失敗しました。

Claude Code は git アドレスを実行する前にすべてのチェックを行います。サポートしていないプロトコルを持つアドレスを拒否します。また、git がアドレスが示すものとは異なるサーバーまたはフォルダに名前を付けるとして読むことができるアドレスも拒否します。

アドレスの後のテキストは、変更する内容を名前付けします。メッセージが言うようにアドレスを書き直し、コマンドを再度実行してください。

代わりに is blocked by enterprise policy と言う拒否は、組織の設定から来ています。マーケットプレイスソースはエンタープライズポリシーによってブロックされていますを参照してください。

`Path does not exist: `

marketplace add にローカルパスを渡し、そのパスに何も存在しません。相対パスは現在のディレクトリに対して解決されます。

メッセージで解決されたパスを確認してください。次に、相対パスが開始するディレクトリからコマンドを実行するか、マーケットプレイスディレクトリへの絶対パスを渡してください。成功した追加は Successfully added marketplace: <name> を出力します。

Claude Code は .claude-plugin/marketplace.json を含むディレクトリ、または .json ファイルへのパスを受け入れます。他のファイルへのパスは File path must point to a .json file (marketplace.json) で失敗します。

`Marketplace file not found at /.claude-plugin/marketplace.json`

Claude Code はマーケットプレイスをクローンまたはダウンロードしましたが、その内部の予想されるパスに marketplace.json が見つかりませんでした。追加コマンドは Failed to add marketplace: Marketplace file not found at ... として報告します。

デフォルトの場所はリポジトリルートの .claude-plugin/marketplace.json であり、マーケットプレイスリファレンスは受け入れられた場所を一覧表示しています。

修正は所有者と他の人で異なります:

  • マーケットプレイスを所有している場合:ファイルをその場所に配置し、マーケットプレイスを再度追加してください
  • 他の誰かがホストしている場合:所有者に正確なソースを尋ねてください

`Cannot add marketplace "": Claude Code cannot install plugins from a marketplace with this name`

マーケットプレイスを追加しましたが、その marketplace.json 内の name が、my-plugin@my-marketplace のようなプラグイン ID の @ 以降の部分として有効ではありません。Claude Code は追加を拒否し、何も登録しません。

メッセージの残りの部分には、名前のルールが記載されています。この例では、_internal は _ で始まっているためルールに違反しています:

Cannot add marketplace "_internal": Claude Code cannot install plugins from a marketplace with this name. Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. The name is set by "name" in the marketplace's marketplace.json; ask its maintainer to change it.

そのルールに合う名前をマーケットプレイスに付けてから、再度追加してください:

  • マーケットプレイスを所有している場合:marketplace.json の name を、たとえば internal-tools に変更してください
  • 他の誰かがホストしている場合:所有者に名前の変更を依頼してください

v2.1.295 より前は、Claude Code はこの例の追加を成功として報告していました。

`SSH authentication failed` または `HTTPS authentication failed`

git リポジトリからマーケットプレイスを追加または更新し、クローンが Failed to clone marketplace repository: で失敗し、その後にこれらの行のいずれかが続きました。

まずリポジトリ自体を確認してください:スペルが間違った owner/repo、存在しないリポジトリ、またはアクセスできないプライベートリポジトリもこのメッセージで終わります。ブラウザでリポジトリ URL を開くか、ターミナルで git ls-remote <url> を実行して、それが存在し、アクセス権があることを確認してください。

リポジトリが正しい場合、原因は認証情報です。Claude Code は git をインタラクティブプロンプト無効で実行するため、パスワード、キーパスフレーズ、またはターミナルが行うような認証情報を要求できません。git がプロンプトを必要とする場合、fatal: Cannot prompt because user interactivity has been disabled または terminal prompts disabled が元のエラーに表示されます。既に非対話的に機能する認証情報のみが成功します:

  • SSH:ssh -T git@<host> はパスフレーズを要求せずに成功する必要があり、ホストは既に known_hosts にある必要があります
  • HTTPS:認証情報ヘルパーはホストのトークンを保持する必要があります。GitHub の場合は、gh auth login と gh auth setup-git を実行してください。別のホストの場合は、個人用アクセストークンを git 認証情報ヘルパーに保存してください。git ls-remote <url> でテストしてください

ターミナルで git ls-remote がプロンプトなしで成功したら、追加または更新を再度実行してください。成功した追加は Successfully added marketplace: <name> を出力します。成功した更新はシェルから Successfully updated marketplace: <name> を出力するか、セッションで ✔ Updated 1 marketplace を出力します。

GitHub owner/repo ソースの SSH をスキップするように Claude Code を設定するには、CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 を設定してください。これがないと、Claude Code は github.com の SSH キーが設定されているように見える場合、これらのソースを SSH 経由でクローンし、SSH クローンが失敗するときに HTTPS にフォールバックします。

バックグラウンド自動更新が認証情報で何ができるか、できないかについては、バックグラウンド自動更新が認証情報で行うことを参照してください。

`SSH host key is not in your known_hosts file`

接続したことのないホストから SSH 経由でマーケットプレイスを追加し、クローンがこの行と ssh -T git@<host> ヒントで失敗しました。キーが変更されたホストの場合、メッセージは SSH host key has changed で、代わりに ssh-keygen -R <host> ヒントが表示されます。

Claude Code は StrictHostKeyChecking=yes でクローンするため、キーを自動的に受け入れるのではなく、まだ受け入れていないホストを拒否します。ターミナルから 1 回接続してフィンガープリントを受け入れ、再試行してください:

ssh -T git@github.com

パブリックリポジトリの場合は、SSH を完全に回避するために、代わりにマーケットプレイスを https:// URL で追加してください。

`Command 'git' not found or is in an unsafe location`

Windows では、マーケットプレイスを追加し、Claude Code は Failed to clone marketplace repository: Command 'git' not found or is in an unsafe location (current directory) と報告しました。

Claude Code は PATH で git を探し、現在のディレクトリでのみ見つかったものを実行することを拒否します。修正するには、Git をインストールして再試行してください:

1

Git for Windows をインストール

Git for Windows をインストールして、git が PATH 上にあるようにしてください。

2

新しいターミナルを開く

新しいターミナルを開いて、更新された PATH が適用されるようにしてください。

3

git が実行されることを確認

git --version がバージョンを出力することを確認してください。

4

追加を再試行

marketplace add コマンドを再度実行してください。

`Git clone timed out after 120s`

マーケットプレイスを追加または更新し、Git clone timed out after 120s で失敗し、その後に CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS を設定するヒントが続きました。

マーケットプレイスのクローンと、更新するために再クローンすることは、デフォルトで 120 秒を取得します。大規模なリポジトリまたは遅い接続の場合は、制限を上げてください。値はミリ秒単位です:

export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000

次に、同じシェルで再試行してください。

リポジトリがモノレポの場合は、claude plugin marketplace add <source> --sparse <paths> で名前を付けたディレクトリにチェックアウトを制限してください。

マーケットプレイスの更新がオフラインで失敗し続ける

マーケットプレイスの git ホストに到達できない環境で作業しており、すべてのセッションがバックグラウンドで失敗した更新を繰り返します。マーケットプレイスの既存のチェックアウトは所定の位置に留まり、スタートアップは遅延しません。

各セッション、自動更新がオンのマーケットプレイスの場合、Claude Code はバックグラウンドでマーケットプレイスの git ホストをチェックして新しいコミットを確認します。そのチェックがホストに到達できない場合、マーケットプレイスを再度クローンしようとし、オフラインではそのクローンも失敗します。

この変数を設定して、チェックがホストに到達できない場合の再クローン試行をスキップし、既存のチェックアウトを使用し続けてください:

export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

変数が設定されている場合、Claude Code は .claude-plugin/marketplace.json を既に含むチェックアウトの再クローンのみをスキップします。クローンされたことのないマーケットプレイスまたはクローンが途中で停止したマーケットプレイスは、クローン試行を取得するため、オンライン中に 1 回追加してください。

完全にオフラインの展開の場合は、代わりに CLAUDE_CODE_PLUGIN_SEED_DIR を使用してイメージビルド時にプラグインディレクトリを事前に入力してください。コンテナと CI をシードに従ってください。

GitHub Enterprise Server ホストでマーケットプレイス追加が失敗

GitHub Enterprise Server(GHES)URL からマーケットプレイスを追加し、ポリシーエラーを取得したか、claude.ai から追加し、GitHub アクセスエラーを取得しました。

両方のケースは GHES ページにあります:

  • ポリシーエラーは、組織がマーケットプレイスソースを制限し、管理者がホストの hostPattern を追加する必要があることを意味します
  • claude.ai での GitHub アクセスエラーは、独自の GitHub Enterprise アカウントがまだ接続されていないことを意味します

プラグインをインストール

マーケットプレイスを追加してインストールを実行し、インストールが何かをインストールする代わりにメッセージで停止しました。これらのエントリはそれらのメッセージをカバーしています。また、プラグインまたはそのマーケットプレイスが見つからない、読み込めない、または信頼できない場合に、後で /plugin Errors タブに表示される関連メッセージ、または空の Discover タブもカバーしています。

`Plugin "" not found in marketplace ""`

/plugin install <name>@<marketplace> または claude plugin install <name>@<marketplace> を実行し、プラグイン名がマシン上のそのマーケットプレイスのカタログのコピーにありません。

シェルで claude plugin install を実行し、マーケットプレイスをまったく追加していない場合、同じメッセージを出力します。claude plugin marketplace update <marketplace> が Marketplace '<marketplace>' not found で答える場合、まずマーケットプレイスを追加してください。

更新ヒント付きの `not found in marketplace`

ヒントは Your local copy may be out of date — try claude plugin marketplace update <marketplace> または The marketplace couldn't be refreshed (...) を読みます。Claude Code はマーケットプレイスをオフラインの場合など、ルックアップの前に更新しなかったため、カタログのコピーが古い可能性があります。マーケットプレイスの名前で更新し、再度インストールしてください:

/plugin marketplace update <marketplace>

claude plugin marketplace update は Successfully updated marketplace: <name> を出力し、/plugin marketplace update は ✔ Updated 1 marketplace を表示します。再試行されたインストールが同じメッセージを出力する場合、ヒントなしの not found in marketplaceが説明するように名前を確認してください。Claude Code がインストール前にマーケットプレイスを更新する場合は、更新が実行されない他のケースを一覧表示しています。

ヒントなしの `not found in marketplace`

名前が最も可能性の高い問題です。/plugin を開き、Discover に移動し、リストから名前をコピーしてください。

v2.1.232 より前では、Claude Code はルックアップが失敗した後にのみ名前付きマーケットプレイスを更新し、自動更新がオンの場合のみでした。

`Plugin "" not found in any marketplace`

@marketplace なしで /plugin install <name> を実行し、登録されたマーケットプレイスにそのプラグインがありません。claude plugin install <name> は Plugin "<name>" not found in any configured marketplace を報告します。

マーケットプレイス名がない場合、claude plugin install は既に持っているカタログを検索し、最初に更新しません。/plugin install は自動更新がオンのマーケットプレイスのみを更新します。マーケットプレイス名を付けると、Claude Code はルックアップの前に更新します:

/plugin install <name>@<marketplace>

インストールが機能する場合、セッションで ✓ Installed <plugin>. を表示するか、claude plugin install から Successfully installed plugin: <plugin>@<marketplace> を表示します。

どのマーケットプレイスがプラグインをリストしているかわからない場合は、/plugin marketplace list を実行して、持っているマーケットプレイスを確認し、/plugin の Discover でプラグイン名を参照してください。

`Plugin '@' is already installed globally`

既にユーザースコープまたは管理設定でインストールされているプラグインの /plugin install を実行し、Claude Code は Use '/plugin' to manage existing plugins. で拒否しました。プラグイン名を @<marketplace> なしで入力した場合、メッセージは globally を省略します。

プラグインはすべてのプロジェクトで既に利用可能であるため、追加するものはありません。そのスコープを変更したり、有効または無効にしたり、設定したりするには、/plugin を開いて Installed に移動してください。

プロジェクトまたはローカルスコープでのみインストールされたプラグインはこのメッセージをトリガーしません。Claude Code はユーザースコープでもインストールできるため、他のプロジェクトで利用可能です。

シェルで claude plugin install は別のメッセージを出力します。ターゲットスコープで既にインストールされているプラグインの場合、Plugin "<name>@<marketplace>" is already installed (scope: user) を出力して終了 0 で終了します。キャッシュディレクトリが見つからない場合、同じコマンドは再度ダウンロードします。

`"" was not installed: it would share its folder with ""`

claude plugin install、/plugin、またはセッション内のインストール提案を通じてプラグインをインストールし、Claude Code はこの行で拒否しました。または、would share its saved data with で拒否しました。

拒否されたプラグインの id と、インストールされたプラグインの id はディスク上の同じフォルダにマップされます。. と @ が - として書き込まれると、それらは同じです。macOS と Windows では、大文字のみが異なる id も同じフォルダにマップされます。両方をインストールすると、1 つのプラグインのファイルが他のプラグインのフォルダに入るため、Claude Code は拒否し、インストールされたプラグインはそのファイルを保持します。

メッセージは方法を名前付けします:

  • 他のプラグインがインストールされている:メッセージは Only one of the two can be installed. と言い、claude plugin uninstall コマンド、または /plugin のアンインストール手順を名前付けします。それを実行し、再度インストールしてください。アンインストールが削除するものについては、アンインストールが削除して保持するものを参照してください。
  • 両方の id が 1 つのインストールで到着する。例えば、プラグインとそれが必要とする依存関係:インストール順序は役に立ちません。マーケットプレイスの 2 つのプラグインをリストしている保守者のみが、それらの 1 つの名前を変更することで修正できます。2 つが異なるマーケットプレイスから来る場合、どちらかの保守者が修正できます。

`This plugin uses a source type your Claude Code version does not support`

マーケットプレイスエントリがこのバージョンの Claude Code がフェッチできないソースタイプを使用するプラグインをインストールし、Claude Code はこのメッセージと Update Claude Code and try again. で停止しました。

Claude Code を更新し、インストールを再試行してください。ソースタイプはマーケットプレイスリファレンスにあります。

`Plugin archive integrity check failed`

zip アーカイブとして配布されるプラグインをインストールし、Claude Code はこの行と The archive was not installed. で拒否しました。プラグインのマーケットプレイスエントリは sha256 ピン付きの archive ソースを使用し、ダウンロードされたファイルのダイジェストはピンと一致しません。

完全なメッセージは次のようになります:

Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

修正は発行者とインストーラーで異なります:

  • プラグインを発行する場合:URL が提供する正確なファイルのダイジェストを再計算し、マーケットプレイスエントリの sha256 を更新してください。shasum -a 256 my-plugin.zip を使用するか、PowerShell で Get-FileHash -Algorithm SHA256 my-plugin.zip を使用してください
  • プラグインをインストールする場合:セッションで /plugin marketplace update <name> を実行してカタログを更新し、エントリが修正された場合に備えて、インストールを再試行してください。更新後もダイジェストが一致しない場合は、インストール前にマーケットプレイス所有者にピン留めされたファイルを尋ねてください

`An npm plugin source must name a registry package`

マーケットプレイスエントリが npm ソースを使用するプラグインのインストール、更新、または読み込みが失敗し、メッセージにこの文が含まれています。Claude Code は何かをフェッチする前にエントリの package 値をチェックし、それを拒否しました。メッセージには値と理由が示されます:

"github:acme/formatter" was not installed: it is not an http or https link. An npm plugin source must name a registry package (name or name@version) or link to a tarball file. For a plugin in a git repository, use a "github", "url" or "git-subdir" source.

マーケットプレイスの所有者がエントリを変更する必要があります:

  • 自分が所有者の場合:package を npm プラグインソースリファレンスが受け入れる値に変更するか、エントリを github、url、または git-subdir ソースに切り替えてください
  • そうでない場合:メッセージをマーケットプレイス所有者に報告してください

`Marketplace "" is registered from an untrusted source`

以前に追加したマーケットプレイスが読み込みを停止し、そのプラグインも同様です。この行は /plugin Errors タブまたは次の更新に表示されます。

マーケットプレイスは公式 Anthropic マーケットプレイス用に予約されている名前で登録されていますが、登録されたソースは anthropics GitHub リポジトリではありません。予約された名前はマーケットプレイスが読み込まれるか更新されるたびに再チェックされるため、マーケットプレイスとそれからインストールされたプラグインは読み込みを停止します。

完全なメッセージは予約された名前と修正を名前付けします:

Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

修正はユーザーと発行者で異なります:

  • マーケットプレイスを使用する場合:シェルで claude plugin marketplace remove <name> を実行し、公式 github.com/anthropics リポジトリからマーケットプレイスを再度追加してください
  • 名前が予約される前に名前を使用したサードパーティマーケットプレイスを発行する場合:名前を変更し、ユーザーにソースから再度追加するよう依頼してください

v2.1.205 より前では、Claude Code はマーケットプレイスを追加するときのみ名前をチェックしたため、名前が予約される前に登録されたエントリは読み込みを続けました。

`Marketplace "" is added but ignored`

マーケットプレイスには ~/.claude/plugins/known_marketplaces.json にエントリがありますが、そのエントリが、Claude Code がこのファイルを読み込むたびに実行するチェックに失敗したため、マーケットプレイスとそこからインストールされたプラグインは読み込まれなくなります。シェルでは、claude plugin list が影響を受ける各プラグインについて、理由と修正方法を示す行を報告します:

Marketplace team-tools is added but ignored. Its location is on a network drive, has "." or ".." in its path, or couldn't be checked. Re-add the marketplace (one added from a folder or file must be re-added from a copy on this computer), or, to trust a folder on a network drive, declare it under extraKnownMarketplaces in user or managed settings.

セッションでは、/plugin の Errors タブはマーケットプレイス名を引用符で囲み、理由の後で行を終え、その下の行に修正方法を表示します。

is added but ignored の後の文は、エントリが失敗したチェックを示します:

  • Its location is on a network drive, has "." or ".." in its path, or couldn't be checked、または The folder or file it was added from についての同じ文:マーケットプレイスのディレクトリ、または追加元のローカルパスが、ネットワーク上の場所にあるか、パスに . または .. セグメントを含むか、チェックできませんでした
  • Its git URL can't be used: <reason> または Its URL can't be read as an https:// or http:// address:エントリに記録されたソース URL が、Claude Code がクローンまたはフェッチを拒否する URL です
  • Its source doesn't match its extraKnownMarketplaces entry in user or managed settings:エントリが同じ名前の extraKnownMarketplaces 宣言と一致しません

理由の代わりに (see the debug log) が is added but ignored の後に続く場合、Claude Code はマーケットプレイスの名前を拒否しています。例えば、予約された名前の別表記などです。デバッグログにエントリが示されます。

対処方法:

  • メッセージ内の修正方法に従ってください。シェルで claude plugin marketplace remove <name> を実行し、サポートされているソースまたはローカルパスからマーケットプレイスを再度追加して、そのプラグインを再インストールしてください(remove コマンドはそれらのプラグインをアンインストールします)。remove コマンドは無視されたエントリにも機能します
  • ネットワーク上の場所にあるマーケットプレイスを維持するには、ユーザー設定または管理設定の extraKnownMarketplaces で宣言してください。リポジトリの .claude/settings.json または .claude/settings.local.json での宣言は対象外です
  • 設定の宣言と異なるソースの場合は、宣言されたソースからマーケットプレイスを再度追加するか、宣言を変更してください。claude plugin marketplace add も同じ不一致を拒否します。対応する Cannot add marketplace のエントリを参照してください
  • 拒否された名前の場合は、行に Remove it: の後のコマンドがあればそれを使用して、マーケットプレイスを削除してください。同じ名前で再度追加しても再び拒否されます

v2.1.286 より前では、理由にかかわらず、claude plugin list はそのようなマーケットプレイスを Marketplace <name> not found と報告し、/plugin の Errors タブは Marketplace "<name>" is registered but was refused (see the debug log) と報告していました。理由はデバッグログにのみ表示されました。v2.1.286 では、理由と修正方法の文は Its recorded location is network-shaped or unclassifiable (never probed) のように異なる表現でした。

`Plugin has a corrupt manifest file` または `has an invalid manifest file`

Claude Code はプラグインをフェッチしましたが、その .claude-plugin/plugin.json を読み込めませんでした。シェルでは、この行の <name> は一時ディレクトリ名である可能性があります。Failed to install plugin "<name>@<marketplace>" プレフィックスはプラグインの実際の名前を運びます。表現は失敗したチェックを示します:

  • corrupt manifest file、その後に JSON parse error::ファイルは有効な JSON ではありません
  • invalid manifest file、その後に Validation errors::ファイルは解析されますが、スキーマに失敗します。例えば、必須フィールドが見つからない場合の name: Invalid input

claude plugin install は Failed to install plugin "<name>@<marketplace>": として報告し、コード 1 で終了します。

プラグインの作成者がファイルを修正する必要があり、その後までプラグインをインストールできません:

  • 自分が作成者の場合:シェルで claude plugin validate <plugin-directory> を実行して、問題のあるパスで同じエラーを表示し、ファイルを修正してください
  • そうでない場合:メッセージをマーケットプレイス所有者に報告してください

`Plugin directory not found at path: `

/plugin の Errors タブは、マーケットプレイスが ./plugins/my-plugin などの相対パスでリストする有効なプラグインに対してこれを表示し、マーケットプレイス内のそのパスにディレクトリが存在しません。マーケットプレイスを維持する場合は、エントリの source パスを修正するか、フォルダを復元してください。それ以外の場合は、メッセージをマーケットプレイス所有者に報告してください。

Marketplace directory not found at path: <path> は、代わりにマーケットプレイス自体のディレクトリが見つからないことを意味します。ローカルパスから追加したマーケットプレイスの場合、そのディレクトリが移動または削除されました。復元するか、マーケットプレイスを削除して新しい場所から再度追加してください。

`No plugins available` または `No marketplaces configured`

/plugin を開き、Discover タブが空であるか、claude plugin marketplace list が No marketplaces configured を出力しました。

マーケットプレイスが登録されていないため、表示するカタログがありません。セッションで、公式マーケットプレイス anthropics/claude-plugins-official を追加してください:

/plugin marketplace add anthropics/claude-plugins-official

Claude Code は Successfully added marketplace: claude-plugins-official を出力し、Discover はそのプラグインをリストします。Anthropic マーケットプレイスページは、追加できる他のマーケットプレイスをリストしています。

`Marketplace "" is already added from a different source`

セッションまたはシェルから、インストールコマンドの --marketplace <source> で新しいマーケットプレイスソースを指定しました。Claude Code がそのソースからフェッチしたカタログは、別のソースから既に追加したマーケットプレイスと同じ名前を持っています。Claude Code は既存のマーケットプレイスを置き換えずに保持し、プラグインはインストールされません。

完全なメッセージは次のようになります:

Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

どのソースを使用するかを選択してください:

  • 既に追加したマーケットプレイス:/plugin install <plugin>@<name> で名前でインストールしてください
  • 新しいソース:/plugin marketplace remove <name> を実行し、インストールを再試行してください

`Cannot add marketplace "": its source doesn't match its extraKnownMarketplaces entry in user or managed settings`

マーケットプレイスを追加しましたが、その marketplace.json 内の name には、ユーザー設定または管理設定に既に extraKnownMarketplaces エントリがあります。指定したソースがそのエントリに記載されたソースと異なるため、Claude Code は追加を拒否し、何も登録しません。

2 つのソースは、タイプが同じで、すべてのフィールドの値が同じ場合に一致します。指定しなかった ref を設定しているエントリは、異なるものとみなされます。github エントリは、リポジトリを https://github.com/ URL として指定した場合も異なるものとみなされます。Claude Code はその URL を git ソースとして記録するためです。次のいずれかを実行してください:

  • 宣言されたソースを使用:Claude Code は設定で宣言されたマーケットプレイスを自動的に登録するため、まずセッションで /plugin marketplace list を実行してください。リストに名前が表示される場合、マーケットプレイスは既に登録されており、追加するものはありません。

    リストに表示されない場合は、エントリの記述どおりにソースを入力して追加してください。source オブジェクトが { "source": "github", "repo": "acme-corp/claude-plugins", "ref": "v1.2.0" } のエントリの場合は、次を実行します:

    /plugin marketplace add acme-corp/claude-plugins#v1.2.0
    
  • 新しいソースを使用:extraKnownMarketplaces エントリを編集または削除し、マーケットプレイスを再度追加してください。管理設定がそれを宣言する場合は、管理者に尋ねてください

v2.1.287 より前では、メッセージは Cannot add marketplace "<name>": its network source differs from the one declared for it in settings (kind, target, or a fetch-shaping field such as headers / ref / path / sparsePaths) でした。

`Failed to install: ()`

/plugin メニューでインストールするプラグインを選択し、それらのいずれもインストールされず、メニューは失敗した内容の概要で閉じました。

git の出力など、いくつかの理由は最初の行のみを表示します。そのような理由が短縮された場合、概要は Installing a plugin from its details (Enter) in /plugin shows its full error. で終わります。

何をするかは、概要が理由を短縮したかどうかによって異なります:

  • 括弧内の理由が名前を付けるものを修正してください
  • 理由が短縮された場合、/plugin を実行し、Discover タブでプラグインを選択し、Enter を押してその詳細からインストールしてください。インストールがそこで失敗する場合、詳細ビューは完全なエラーを表示します

`Could not move the new copy of this plugin version into `

プラグインをインストールする場合、Claude Code はそのファイルの新しいコピーをダウンロードし、プラグインキャッシュのそのバージョンのフォルダに移動します。このメッセージは移動が失敗したことを意味し、通常は別のプログラムがインストール中にフォルダを使用していたためです。ファイルシステムコードは括弧内に表示されます:

Could not move the new copy of this plugin version into /home/user/.claude/plugins/cache/acme-tools/formatter/1.2.0: the new copy or the version folder stayed busy while the install ran (ENOTEMPTY) — usually a scanner still reading the freshly downloaded files, another program using that folder, or another process re-creating it. The previously installed copy was moved back. Run the install again once other Claude Code sessions or programs using that folder have finished.

メッセージは、インストール前にインストールされたコピーに何が起こったかを示し、プラグインが引き続き機能するかどうかを示します:

  • The previously installed copy was moved back:持っていたバージョンはまだインストールされています
  • had to be removed first、was not moved back、または could not be moved back:そのプラグインバージョンはインストールが成功するまでインストールされません
  • そのような文がない:以前のコピーがなかったため、バージョンはまだインストールされていません

Windows では、別のプログラムがインストールされたコピー自体を保持している場合、メッセージは代わりにそのコピーが could not be replaced であり、It was not replaced and the new copy was discarded であると言うため、持っていたバージョンはまだインストールされています。

Left on disk リストはキャッシュ内に設定されたフォルダに名前を付けます。そのバージョンの後のインストールまたはプラグインキャッシュクリーンアップはそれらを削除するため、削除する必要はありません。

インストールを修正するには:

  • ~/.claude/plugins/cache の下のプラグインのフォルダを使用している他の Claude Code セッション、エディタ、ターミナルを閉じ、インストールを再度実行してください
  • メッセージがプラグインキャッシュフォルダの権限を確認するよう指示する場合は、名前を付けたフォルダの書き込み権限を復元し、ディスク領域を解放し、インストールを再度実行してください

依存関係エラー

依存関係を宣言するプラグインは、依存関係を満たすことができない場合、インストールに失敗するか、インストールして無効のままになる可能性があります。メッセージはインストール時または読み込み時に到達します:

  • インストール中:拒否はインストールのエラーメッセージとして返されます
  • プラグインが読み込まれるとき:問題は claude plugin list と /plugin Errors タブに表示され、Claude Code は解決するまで影響を受けたプラグインを無効のままにします

表は各メッセージとその修正をリストしています。作成者として依存関係を宣言するには、プラグイン依存関係を参照してください。

メッセージ 意味 解決方法
Dependency "<dep>" is not installed 宣言された依存関係がインストールされていません。 シェルで claude plugin install <dep>@<marketplace> でインストールするか、プラグインをアンインストールしてください。依存関係のマーケットプレイスがまだ登録されていない場合は、それを追加し、セッションで /reload-plugins を実行してください。これにより、解決できる不足している依存関係がインストールされます。
Dependency "<dep>" is disabled 依存関係はインストールされていますが、オフになっています。 依存関係を有効にするか、それを必要とするプラグインをアンインストールしてください。
Requires "<dep>" <range>, installed <version> インストールされた依存関係のバージョンはプラグインの宣言された範囲外です。 依存関係を範囲内のバージョンに更新するか、プラグインをアンインストールしてください。
<Plugin or Dependency> "<name>" has conflicting version requirements バージョンはすべての範囲を満たしていません。メッセージは範囲をリストします。 競合するプラグインの 1 つをアンインストールまたは更新するか、上流の作成者に制約を広げるよう依頼してください。
... has version requirements too complex to intersect または has an invalid version requirement 範囲は有効な semver ではないか、結合された範囲を交差させることができません。 無効な範囲を修正するか、長い || チェーンを簡素化してください。
... has no git tag satisfying <range> 依存関係のリポジトリには範囲内に <name>--v* タグがありません。 上流がその規約でリリースをタグ付けしていることを確認するか、範囲を緩和してください。
Dependency "<dep>" (required by <plugin>) is in <marketplace>, which is not in the allowlist 依存関係は別のマーケットプレイスにあり、クロスマーケットプレイス解決はデフォルトでオフです。 依存関係を自分でインストールしてください。シェルで claude plugin install <dep>@<marketplace> に加えて、プラグインをインストールしている --scope を使用してから、再試行してください。

これらをプログラムで表示するには、シェルで claude plugin list --json を実行してください。問題のあるプラグインは、メッセージを含む errors フィールドと、各フィールドの type を含む errorDetails フィールドを運びます:最初の 2 行は dependency-unsatisfied で、3 番目は dependency-version-unsatisfied です。

プラグインがインストールされているが機能していない

インストールは成功しましたが、プラグインのスキル、フック、またはサーバーが何もしていません。まず プラグインが表示されないか、そのスキルが表示されない を確認してください。ここでは Claude Code がロードしたものをどこで報告するかが説明されており、メッセージと照合できます。

プラグインが表示されないか、そのスキルが表示されない

プラグインをインストールして / と入力してそのスキルを期待したか、Claude にそれを使用するよう求めたが、何も起こりませんでした。

何かを変更する前に、プラグインの状態を確認してください。

1

プラグインがインストールされ、有効になっていることを確認する

/plugin を実行して Installed を開きます。プラグインがリストされ、有効になっていることを確認してください。シェルで claude plugin list を実行すると、各プラグインのバージョン、スコープ、および Status: ✔ enabled を含む同じリストが出力されます。

2

Errors タブを読む

同じパネルの Errors タブを開きます。各エントリはメッセージとガイダンス行をペアにします。このセクションの残りのほとんどのメッセージはそのタブから来ています。

3

このセッション中にインストールした場合は再度読み込む

プラグインがインストールされ、エラーがないが、このセッション中にインストールした場合は、/reload-plugins を実行してください。プラグイン、スキル、エージェント、フック、およびサーバーの数を含む Reloaded: を出力します。何かが失敗した場合、N errors during load. Run /plugin for details. が追加されます。

プラグインがエラーなくロードされ、そのスキルがまだ表示されない場合、次のステップは自分のプラグインと他の人のプラグインで異なります。

  • 構築中のプラグイン: プラグインはロードされるが、そのスキルが見つからない を参照してください
  • 他の人が公開したプラグイン: /plugin で Installed を開き、プラグインの詳細ペインを開きます。ここにはプラグインに含まれるものがリストされています。そこにスキルがリストされていないプラグインは、/ と入力したときに提供するスキルがありません

`Run /reload-plugins to apply.`

/plugin のインストール概要が Plugin is now active. の代わりに Run /reload-plugins to apply. で終わりました。同時に、プロンプトの上に Plugins changed. Run /reload-plugins to activate. という通知が表示されることがあります。

Claude Code はインストール中にプラグインをアクティブ化しませんでした。これは、アクティブ化すると プロンプトキャッシュが無効になる か、アクティブ化の試みが失敗したためです。

コマンドを入力する必要はありません。パネルが閉じて Claude Code が /reload-plugins を実行するか、ストリーミング中のレスポンスが終了するまでキューに入れます。

そのリロードが出力するものを読んでください。

  • プラグイン、スキル、エージェント、フック、およびサーバーの数を含む Reloaded:: プラグインはアクティブになりました。何かがロードに失敗した場合、行は N errors during load. Run /plugin for details. を追加します。
  • This reload changes MCP tools (...) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply.: リロードはプラグイン MCP サーバーを追加または削除するか、LSP ツールを削除し、プロンプトキャッシュを無効にします。LSP の場合、行は This reload adds the LSP tool または This reload removes the LSP tool で始まります。--force で実行してプラグインをアクティブ化するか、新しいセッションを開始してください

v2.1.268 より前では、インストール中にアクティブ化されなかったインストールは、自分で /reload-plugins を実行するまで保留中のままでした。

v2.1.246 より前では、その概要のスキル数にはプラグインの commands/ エントリのみが含まれていたため、リロードはプラグインの SKILL.md スキルをロードしても 0 skills を報告できました。

`The packages it lists are not installed` または `were not installed, because ...`

/plugin と claude plugin list は、依存関係のインストールで node_modules ディレクトリが作成されなかったプラグインに、これらのいずれかのメモを表示します。プラグインはロードされますが、不足しているパッケージを必要とする部分は機能しない場合があります。

  • are not installed: このプラグインではインストールを実行できますが、失敗やタイムアウトなどの理由で完了しませんでした。インストールを再試行するには、メモに示された claude plugin update コマンドをシェルで実行するか、/plugin からプラグインを更新してください

    claude plugin update formatter@my-marketplace
    

    再試行が失敗した場合、出力に原因が示されます。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC が設定されている間は、claude plugin update と /plugin は再試行をスキップし、プラグインが最新バージョンであると報告します。

  • were not installed, because ...: このプラグインではインストールを実行できず、メモにその理由が示されます。たとえば、Yarn、pnpm、または bun.lockb のロックファイルや、パッケージマネージャーがこのコンピューターにインストールされていないロックファイルなどです。その理由が解消されない限り、プラグインを更新してもパッケージはインストールされません。理由がロックファイルの場合は、プラグインの作成者がそれを置き換える必要があります。パッケージマネージャーがない場合は、それをインストールしてからプラグインを更新してください

`Plugin "" not cached at `

Errors タブにこの行が表示され、ガイダンスは Run /plugin to refresh the plugin cache です。Claude Code にはプラグインのインストール記録がありますが、記録が指す ディレクトリが見つかりません。たとえば、キャッシュをクリアした後です。

シェルからプラグインを再度インストールしてください。claude plugin install <name>@<marketplace> は、インストール ディレクトリが見つからないが記録が存在するプラグインを再度ダウンロードします。

claude plugin install <name>@<marketplace>

次に、セッションで /reload-plugins を実行してください。Errors タブエントリが消え、プラグインが Installed の下に戻ります。

`installed_plugins.json holds a record under "" that this version of Claude Code cannot read`

メッセージは次の形式で表示されます。

  • claude plugin list: Note: として出力します
  • claude plugin install、uninstall、および update: Plugin "<name>" was not installed:、Plugin "<name>" was not uninstalled:、または Plugin "<name>" was not updated: で拒否し、その後に同じテキストが続きます
  • これら 3 つのコマンドのいずれかで --json: 結果行は同じ message と failureCode: "install_records_unreadable" を含みます
  • 複数のそのようなレコード: メッセージは holds records under と読みます
  • ファイル全体がこのバージョンが知らない形式を宣言する: メッセージは代わりに installed_plugins.json is in a format (version <N>) that this version of Claude Code does not know と読みます

installed_plugins.json の名前付きレコードは有効なプラグイン ID の下で有効な JSON ですが、そのフィールドはこのバージョンに対して解析されません。おそらく Claude Code の別のバージョン(おそらくより新しいバージョン)がそれを書きました。

レコードがある間、このバージョンはファイルを書き直さないため、レコードは失われません。

メッセージのオプションを順番に実行してください。

  1. claude update で Claude Code を更新してください。
  2. 更新できない場合は、レコードを書いた Claude Code のバージョンで名前付きプラグインをアンインストールしてください。
  3. どちらも役に立たない場合は、installed_plugins.json からレコードを手動で削除してから、Claude Code を再起動するか /reload-plugins を実行してください。

`installed_plugins.json could not be read and was rebuilt`

claude plugin list はこのメモを出力し、installed_plugins.json の横に installed_plugins.unreadable.<date>.<hash>.kept という名前の保持されたファイルのパスを出力します。そのファイルが installed_plugins.json の横に存在する限り。

有効な JSON ではない、またはプラグインのリストではない installed_plugins.json は、インストールしたものを言うことができません。

.kept ファイルを開いて、古いファイルが何を記録したかを確認し、不足しているプラグインを再度インストールしてください。Claude Code はファイルを再度読み込むことはなく、ファイルは cleanupPeriodDays スケジュールで期限切れになります。

`install records under names that no version of Claude Code can use were removed from installed_plugins.json`

claude plugin list はこのメモを出力し、installed_plugins.json の横に installed_plugins.set-aside.<date>.<hash>.json という名前のコピーのパスを出力します。そのコピーが installed_plugins.json の横に存在する限り。メモは Nothing needs doing about these copies. で終わります。

installed_plugins.json のレコードは、Claude Code のどのバージョンも使用できない有効なプラグイン ID ではないキーの下に存在していたため、ファイルの残りは正常にロードされます。

Claude Code は使用不可能なレコードを .set-aside ファイルにコピーし、リストからドロップします。Claude Code はコピーを再度読み込むことはなく、コピーは cleanupPeriodDays スケジュールで期限切れになります。

`does not load (...), so Claude Code ignores the whole file`

コマンドは正常に動作しました。警告で示されている設定ファイルにエラーがあるため、修正するまで Claude Code はそのファイル全体を無視します。コマンドがそこに書き込んだ内容も無視されます。

警告で示されているエラーを修正してください。Claude Code が受け付けない値については、壊れた設定ファイルを修正する で方法を説明しています。その後、コマンドの変更がファイルに残っていない場合は、コマンドを再度実行してください。

警告は、シェルでの claude plugin install、enable、disable、または claude plugin marketplace add の成功行の後に表示されます。

⚠ /home/user/.claude/settings.json does not load (its "permissions" is not valid), so Claude Code ignores the whole file, including anything this command wrote there. Fix the file, then run this command again if its change is missing. If a newer Claude Code wrote the file, update Claude Code instead.

括弧内のテキストがエラーを示します。

  • its "<key>" is not valid: 引用符で囲まれた設定項目に、Claude Code が受け付けない値が入っています。その設定項目が取る値については、設定リファレンス で確認してください。複数の値が失敗した場合、テキストは最初の設定項目を示し、残りの数を示します(例: its "permissions" and 1 other value are not valid)。
  • it is not a JSON object: ファイルのトップレベルが JSON オブジェクトではありません。たとえば、トップレベルが配列のファイルです。

`Disabled in ~/.claude/settings.json but still loads`

~/.claude/settings.json でプラグインを false に設定し、claude plugin list または /plugin の行にこのメッセージが表示され、その後に — project settings enable it, which overrides your user setting などのソースが続きます。その高い優先度のソースの true がユーザー設定をオーバーライドしています。

マシン上でプロジェクト対応プラグインをオプトアウトするには、プロジェクト ファイルより優先度が高い .claude/settings.local.json で ID を false に設定してください。メッセージが名前を付ける他のソースについては、ユーザー設定で無効になっているが、まだロードされている を参照してください。

代わりに claude plugin list がプラグインを required by your org とマークしている場合、設定ファイルは関係ありません。組織は claude.ai で同期されたプラグインを必須としてマークし、以前に無効にしていても読み込まれます。claude.ai から同期されたプラグイン を参照してください。

`Plugin "" is enabled in project settings but isn't installed here`

Errors タブにこの行が表示されます。プロジェクトの .claude/settings.json が有効にするプラグインの場合、ガイダンスは Run claude plugin install <name>@<marketplace> --scope project to install it for this project です。

リポジトリの設定はそれを開く全員のプラグインを有効にできますが、インストールはしません。プラグインが GitHub リポジトリや npm パッケージなどの外部ソースから来ている場合、Claude Code はそれを自分でインストールするまでダウンロードしません。シェルからガイダンス行のコマンドを実行してから、リロードしてください。

claude plugin install <name>@<marketplace> --scope project

セッションで /reload-plugins を実行した後、Errors タブエントリは消え、プラグインは Installed の下にリストされます。

組織がプラグインを事前にインストールしている場合、管理設定を通じてそうします。プラグインの事前インストールと要求 を参照してください。

Windows で `plugin uninstall` 後もプラグインがインストールされたままになる

Windows でプロジェクトスコープまたはローカルスコープで claude plugin uninstall を実行すると成功と報告されますが、claude plugin list または /plugin にはまだプラグインがリストされています。

installed_plugins.json にはプロジェクトフォルダーに対するプラグインのインストール記録が 2 つあり、それぞれフォルダーのパスの表記が異なっていて、1 回のアンインストールではそのうち 1 つしか削除されません。確認するには、シェルで claude plugin list --json を実行してください。プラグインの残っている行の projectPath は、アンインストールを実行した場所とは異なる表記でフォルダーを示しています(例: C:\work\app に対する c:\work\app)。

同じアンインストールコマンドを、同じ --scope を指定して、同じフォルダーからもう一度実行してください。2 回目の実行では自身のパス表記の下に記録が見つからないため、もう一方の表記の記録を削除します。プロジェクトスコープのインストールの場合:

claude plugin uninstall <name>@<marketplace> --scope project

その後、もう一度 claude plugin list --json を実行して、行が消えたことを確認してください。

v2.1.295 より前では、2 回目の実行は Plugin "<name>" is not installed in project scope で失敗します。claude update を実行してから、アンインストールを再度実行してください。

`Failed to load hooks from ` とフックが発火しない

プラグインのフックが実行されないか、1 つがアクションをブロックします。Errors タブにロード失敗が表示されるか、フックがロードされてトランスクリプトに <Event> hook error 通知またはブロッキング エラーが表示されるか、フックがエラーなくロードされて発火しません。

フックがロードに失敗する

Errors タブに次のいずれかのメッセージが表示されます。

  • Failed to load hooks from <path>: <reason>: hooks/hooks.json が有効な JSON ではないか、フック スキーマに失敗しています。理由は解析または検証エラーを名前付けします。ファイルを修正してください。プラグインを公開する前に hooks/hooks.json の JSON 構文の問題をキャッチするには、シェルで claude plugin validate <plugin-directory> を実行してください
  • hooks path not found: <path>: マニフェストの hooks フィールドが、プラグイン ルートに相対して存在しないファイルを名前付けします。パスを修正するか、ファイルを追加してください

トランスクリプトの `hook error` 通知

... hook error: Failed with non-blocking status code: <stderr> 形式の通知は、フックが実行され、そのコマンドが失敗したことを意味します。たとえば、Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found は、Claude Code が生成したシェルが node を見つけられなかったことを意味します。それをインストールするか、claude を開始するターミナルの PATH にあることを確認してください。

stderr がプラグインのパスをスペースで切り取って表示している場合、フックのシェル形式コマンドは引用符の外で ${CLAUDE_PLUGIN_ROOT} を使用し、インストール パスにスペースが含まれています。変数を二重引用符で囲むか、exec 形式 を使用してください。引用符なしの変数を見つけるには、プラグイン ディレクトリで claude plugin validate を実行し、その 引用警告 を探してください。

通知が Failed to run: Plugin directory does not exist: <path> の場合は、Plugin directory does not exist を参照してください。

その他のエラーについては、プラグイン ディレクトリからフックのコマンドを自分で実行して完全な出力を確認するか、デバッグ ログ で完全な stderr をキャプチャしてください。

プラグイン フックがツール呼び出しまたはプロンプトをブロックする

終了コード 2 で終了するフックは 実行したアクションをブロック します。プラグインのフックがこのようにブロックし、その stderr がブロッキング メッセージの場合、エラーは This hook comes from the <plugin> plugin. で終わります。これにより、どのプラグインを無効にするか修正するかがわかります。v2.1.281 より前では、エラーはプラグインを名前付けしませんでした。

そのメッセージがプラグインのパスをスペースで切り取って表示している場合、引用符なしの ${CLAUDE_PLUGIN_ROOT} 修正 を適用してください。

フックがロードされるが発火しない

フックがエラーなくロードされるが発火しない場合は、その定義を確認してから、実行を監視してください。

1

イベント名を確認する

イベント名は大文字と小文字を区別するため、PostToolUse など、正確に一致することを確認してください。

2

マッチャーを確認する

フックの matcher がツール名と一致することを確認してください。

3

意図的にイベントをトリガーする

PostToolUse フックの場合、Claude にファイルを編集するよう求めてください。

4

デバッグ ログを読む

デバッグ ログ を開きます。これは、どのフックが一致したかを記録します。実行されたフックは、その終了コードとともにそこに表示されます。

`Plugin directory does not exist: `

メッセージには再インストールするよう書かれていますが、まず Claude Code のプロンプトで /reload-plugins を実行してください。セッションがプラグインのフックをロードしたディレクトリがディスクから消えている場合、プラグインのフックは Failed to run: Plugin directory does not exist: <path> (<plugin> — run /plugin to reinstall) で失敗し、フックは実行されません。Plugin directory not found at path: <path> は、マーケットプレイスのエントリに関する別のメッセージです。

リロードにより、プラグインのフックが現在のディレクトリからロードされます。失敗はフックイベントとコマンドごとにセッションにつき 1 回だけ表示されるため、フックが何も表示しなくなっても修正されたことの確認にはなりません。代わりにリロードの出力を読んでください。

  • エラー行のない Reloaded:: プラグインのフックは、存在しないディレクトリを参照しなくなりました
  • N errors during load. Run /plugin for details.: /plugin で Errors タブを開き、表示されたメッセージに対応するこのページのエントリに従ってください
  • Run /reload-plugins --force to apply. で終わる行: 何もリロードされておらず、フックは失敗し続けます。Claude Code のプロンプトで /reload-plugins --force を実行してください

`Invalid MCP server config for ""` と MCP サーバーが起動しない

プラグインが MCP サーバーをバンドルし、Errors タブに Invalid MCP server config for "<server>": <error> が表示されるか、サーバーがリストされているが /mcp が接続を表示しません。

`Invalid MCP server config for "": `

サーバーの設定はスキーマ チェックに合格しますが、Claude Code はこのセッションに対してそれを解決できません。コロンの後のテキストは原因を名前付けし、修正を決定します。

  • Missing environment variables: <names>: シェルで Claude Code を開始するときにそれらの変数を設定してから、新しいセッションを開始してください
  • URL is unset or invalid: URL が使用する ${user_config.*} オプションが設定されていません。/plugin configure <plugin> を実行して設定してください
  • has an invalid MCP url または headersHelper for MCP server '<server>' references ${user_config.*}: プラグイン自体の設定に問題があります。プラグインの MCP 設定で url または headersHelper を修正するか、プラグインがあなたのものでない場合はプラグインの作成者に報告してください。headersHelper の場合は、プラグイン コマンドが user_config を参照 の下に独自のエントリがあります

`Bundled MCP server "" was not started: it needs configuration`

プラグインは、サーバーを MCPB バンドル として含めており、user_config を宣言し、必須の設定に保存された値がないか、保存された値がバンドル自体の検証に失敗しているため、Claude Code はサーバーの起動をスキップします。プラグインの残りは機能します。

/plugin の Installed タブでプラグインを選択し、Configure を選択して値を指定してください。保存した後、/plugin は Configuration saved. を表示して閉じ、Claude Code は インストール済みプラグインの管理 の下で説明されているようにプラグインをリロードします。そのリロードが適用されると、サーバーが起動します。v2.1.285 より前では、Claude Code はこの行を表示せずにサーバーをスキップしました。

サーバーが設定されているが接続しない

/mcp を実行してサーバーのステータスを確認してください。サーバーが正常な場合、/mcp はそれを接続済みとしてリストします。

サーバーが起動中に出力したエラーを読むには、claude --debug を実行し、~/.claude/debug/<session-id>.txt でログを開きます。--debug フラグはターミナルに出力しません。

.mcp.json のサーバー エントリがスキーマに失敗した場合、Errors タブに表示されません。Claude Code はそのサーバーをドロップし、Invalid MCP server config for <server> in <path> をそのデバッグ ログにのみ記録します。プラグインをロードせずにエントリを見つけるには、プラグイン ディレクトリで シェルで claude plugin validate を実行します。これはエラーとして報告します。

v2.1.281 より前では、claude plugin validate は .mcp.json をチェックしませんでした。

サーバーは `--plugin-dir` で機能するがインストール後に失敗する

プラグインの作成者であり、--plugin-dir でソース ディレクトリからプラグインをロードするときはサーバーが起動しますが、プラグインがインストールされると失敗します。

Claude Code はインストール済みプラグインをキャッシュにコピーするため、ソース ディレクトリからのみ機能するパスが壊れます。プラグイン内のパスを ${CLAUDE_PLUGIN_ROOT} で記述してください。

プラグイン ディレクトリの外に到達するパスについては、プラグインがそのディレクトリの外で参照するファイルが見つからない を参照してください。

言語サーバーが起動しない、メモリを使いすぎる、または間違った診断を報告する

コード インテリジェンス プラグイン をインストールし、Claude が診断を表示していないか、言語サーバーがメモリを使いすぎているか、実際ではないエラーを報告しています。

言語サーバーが起動しない

プラグインは別途インストールする言語サーバー バイナリに接続し、Claude Code は PATH からコマンド名で生成します。

/plugin Errors タブに Executable not found in $PATH: "<binary>" などの理由とともに失敗が表示され、claude --debug はそれを LSP server <name> failed to start: <reason> としてログに記録します。

バイナリをインストールし、claude を開始するターミナルの PATH にあることを確認してください。たとえば、which typescript-language-server を使用します。次に、新しいセッションを開始してください。

言語サーバーがメモリを使いすぎる

rust-analyzer や pyright などの言語サーバーはプロジェクト全体をインデックスします。セッションで /plugin disable <plugin> を使用してプラグインを無効にし、代わりに Claude の組み込み検索ツールに依存してください。

モノレポの偽陽性診断

ワークスペース用に設定されていない言語サーバーは、内部パッケージの未解決のインポートを報告できます。Claude Code 側で修正するものはなく、診断は Claude がコードを編集するのを止めません。

プラグインを構築する

--plugin-dir でプラグインを読み込むか、ローカルマーケットプレイスからインストールしてプラグインを開発しています。これらのエントリは、プラグイン開発中に発生する障害をカバーしています。各変更後にチェックを実行するには、テストとデバッグ を参照してください。

プラグインのユーザーにも到達する 2 つの障害は、プラグインがインストールされているが機能していない の下にエントリがあります。

`commands path not found: `

Errors タブに commands path not found: <absolute path> が表示され、ガイダンスとして「マニフェストまたはマーケットプレイス設定のパスが正しいことを確認してください」と表示されます。同じメッセージは skills、agents、hooks に対しても表示されます。

Claude Code は plugin.json またはマーケットプレイスエントリからのパスをプラグインルートに対して解決し、そこに何も見つかりませんでした。メッセージ内のパスはチェックした絶対パスなので、ディスク上の内容と比較してください。パスを修正するか、ディレクトリを作成してから /reload-plugins を実行してください。

マニフェスト内のパスはプラグインルートに相対的で、./ で始まります。プラグインルートの外に解決されるパスは、代わりに <component> path escapes plugin directory として報告され、削除されます。

`--plugin-dir` がマーケットプレイスルートにあると `plugins/` の下のプラグインが読み込まれない

claude --plugin-dir <path> を開始し、エラーは表示されませんが、プラグインのスキル、エージェント、フックが表示されません。

--plugin-dir はプラグインのルートディレクトリ(.claude-plugin/plugin.json と skills/ などのコンポーネントディレクトリを含むディレクトリ)を取ります。代わりにマーケットプレイスルートを指定すると、Claude Code は marketplace.json を読まないため、plugins/ の下のプラグインは読み込まれず、エラーは表示されません。v2.1.281 より前では、Claude Code はマーケットプレイスルートをそのディレクトリにちなんだ名前の 1 つの空のプラグインとして読み込みました。フラグをプラグインディレクトリ自体に指定してください。

claude --plugin-dir ./my-marketplace/plugins/my-plugin

その後、/plugin で Installed を開き、プラグインの詳細ペインでそのコンポーネントを一覧表示します。

プラグインがそのディレクトリの外で参照するファイルが見つからない

プラグインは --plugin-dir でソースディレクトリから機能しますが、インストール後に ../shared-utils などのパスに関するエラーで失敗します。

Claude Code はインストール済みプラグインをキャッシュにコピーし、そこから読み込むため、プラグイン自体のディレクトリの外に到達するパスはキャッシュ内で何も指しません。共有ファイルをプラグインディレクトリ内に移動するか、その中のシンボリックリンクを通じて参照してください。キャッシュの場所とパスの解決方法については、ディスク上のプラグインを検索 を参照してください。

`${CLAUDE_PLUGIN_ROOT}` が Windows で前方スラッシュを表示する

Windows では、プラグインフックが ${CLAUDE_PLUGIN_ROOT} を C:\Users\you\... ではなく C:/Users/you/... として受け取り、バックスラッシュを期待するスクリプトが破損します。

Claude Code は Windows 上でシェル形式のフックを Git Bash を通じて実行し、意図的にプラグインルートを前方スラッシュ Win32 形式で置換します。Bash ビルトイン、MSYS ツール、ネイティブ Windows バイナリはすべてその形式を受け入れます。

スクリプトがバックスラッシュを必要とする場合は、フックを exec 形式とシェル形式 の下で説明されているネイティブパスを保持する形式の 1 つに切り替えてください。

  • プロセスを args 配列で直接生成する exec 形式フック
  • "shell": "powershell" を持つフック

プラグインは読み込まれるがスキルが見つからない

プラグインは Installed の下にエラーなしで一覧表示されていますが、/ を入力してもスキルが提供されません。

スキルはプラグインルートの skills/ から読み込まれ、コマンドはプラグインルートの commands/ から読み込まれます。.claude-plugin/ の中には plugin.json だけが属し、.claude-plugin/ 内の skills/ ディレクトリはスキャンされません。ディレクトリをプラグインルートに移動し、/reload-plugins を実行してください。その後、/plugin のプラグイン詳細ペインにスキルが一覧表示され、/ を入力するとそれらが提供されます。

各スキルは SKILL.md を含むディレクトリです。そのディレクトリではなく SKILL.md ファイルを指すマニフェスト内の skills エントリは、path is a file; skills entries must be directories containing SKILL.md として報告されます。

スキルは読み込まれるが Claude がスキルを呼び出さない

プラグインのスキルは /<plugin>:<skill> コマンドを入力すると実行されますが、Claude は通常のリクエストに応じてそれを呼び出しません。

これらの原因を順番にチェックしてください。

  • スキルが disable-model-invocation: true を設定している: 最初のプラグインを作成 のテンプレートスキルがそれを設定しています。Claude が独自にスキルを呼び出すようにしたい場合は、スキルからその行を削除してください。スキルを呼び出すユーザーを制御 がそのフィールドをカバーしています
  • 説明が人々の質問方法と一致していない: スキルがトリガーされていない のチェックを実行してください
  • 説明が切り詰められている: 多くのスキルがインストールされている場合、Claude Code は説明を短縮してリストの文字予算に合わせます。これにより、Claude がリクエストを一致させるために必要なキーワードが削除される可能性があります。スキルの説明が短く切り詰められている を参照してください

1 つずつチェックするのではなく、現実的なプロンプト全体でスキルがどのくらいの頻度でトリガーされるかを測定するには、tool_used: Skill グレーダー を使用して eval ケースを作成し、各説明変更後に claude plugin eval で実行してください。

`claude plugin eval init` から ` is not a plugin or skill folder`

プラグインのルートではないディレクトリ(ホームディレクトリやプラグインをサブディレクトリに保持するリポジトリのルートなど)から claude plugin eval init を実行しました。init は作業ディレクトリの下にスイートを書き込むため、プラグインが見ることのない evals/ ディレクトリを作成する代わりに停止します。

プラグインのルート(.claude-plugin/plugin.json またはスキルの SKILL.md を保持するディレクトリ)に変更し、コマンドを再度実行してください。意図的に別の場所にスイートをスキャフォールドするには、--eval-dir を渡してください。プラグインを eval でテスト を参照してください。

`userConfig` ダイアログが表示されない

プラグインが userConfig オプションを宣言していますが、インストール時に設定ダイアログが表示されません。

インストールが値を要求するかどうかは、実行する場所によって異なります。

  • セッション内の /plugin install、または /plugin の Discover タブ: ダイアログはこのインタラクティブインストールの一部です
  • VS Code 拡張機能の Manage plugins ダイアログ: インストール後に未設定オプションのフォームを要求します。v2.1.285 より前では、そこでのインストールはオプションフォームを表示しなかったため、ターミナルセッションから /plugin configure <plugin>@<marketplace> で値を設定してください
  • シェルの claude plugin install: userConfig 値を要求しません。渡す --config KEY=VALUE 値を保存し、オプションが未設定のままの場合、N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE. と出力します。未設定オプションのいずれかが必須の場合、(M required) が not yet set に続きます。

シェルからインストールした場合は、--config で値を渡し、オプションごとに 1 つのフラグを使用してください。

claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

すべてのオプションが設定されている場合、インストール出力に not yet set 行は含まれません。

代わりに後でダイアログを開くには、セッション内で /plugin configure my-plugin@my-marketplace を実行してください。シェルから、claude plugin configure は、どのオプションがまだ未設定であるかを示し、stdin でパイプされた値を保存します。Claude Code v2.1.285 以降が必要です。

マニフェストが宣言しない --config キーを渡す場合、プラグインはまだインストールされ、コマンドは ⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig. を出力し、その後にプラグインが宣言するキーが続きます。

MCPB バンドルファイル を配布するプラグインの場合、独自の user_config を宣言すると、メッセージは代わりに isn't declared in this plugin's userConfig or by its bundled MCP servers. と読み、既知のキーにはそのサーバーのキー(<server>.<key> として記述)が含まれます。マニフェストが URL で参照するバンドルはインストール時に読み込まれないため、そのキーは一覧表示されず、メッセージは /plugin で設定するよう指示します。<server>.<key> キーの設定には Claude Code v2.1.285 以降が必要です。

`claude plugin validate` がエラーを報告する

claude plugin validate <path> を実行するか、セッション内で /plugin validate <path> を実行し、Found N errors と Validation failed を出力してから、終了コード 1 で終了しました。

バリデーターは、指定したパスのマニフェストを読み込みます。プラグインディレクトリの場合は .claude-plugin/plugin.json、マーケットプレイスディレクトリの場合は .claude-plugin/marketplace.json、両方を含むディレクトリの場合はその両方です。マーケットプレイスの場合、エントリ自体のマニフェスト内の問題にはエントリインデックスをプレフィックスとして付け、plugins[1] plugin.json → json: ... として表示します。v2.1.289 より前では、Claude Code は両方を含むディレクトリをマーケットプレイスとしてのみ検証していました。

テーブルは検証を停止するメッセージと 2 つの警告(No frontmatter block found と Unknown field '<key>')をカバーしており、これらの警告は --strict を渡す場合にのみ検証を停止します。説明の欠落など、その他の警告は一覧表示されません。

メッセージ 原因 修正
File not found: <path> パスにマニフェストがないか、存在しません。 プラグインまたはマーケットプレイスルート(.claude-plugin/ を含むディレクトリ)に対してコマンドを実行してください。
No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json ディレクトリに .claude-plugin/ マニフェストがありません。 マニフェストを作成するか、正しいディレクトリを指定してください。
Invalid JSON syntax: <parse error> マニフェストまたは hooks/hooks.json が有効な JSON ではありません。 JSON を修正してください。hooks/hooks.json を修正するまで、セッションはそのファイル内のフックなしでプラグインを読み込みます。
Path not found: <path>. The runtime loader will report this as a load failure. マニフェスト内のコンポーネントパスが存在しません。 パスを修正するか、ディレクトリを作成してください。
Path contains ".." which could be a path traversal attempt: <path> コンポーネントパスがプラグインディレクトリをエスケープします。 プラグインルート内のパスを使用してください。
Path is a file; skills entries must be directories containing SKILL.md skills エントリがそのディレクトリではなく SKILL.md を指しています。 親ディレクトリ、またはルートレベルの SKILL.md の場合は . を指してください。
No frontmatter block found または YAML frontmatter failed to parse: <error> スキル、エージェント、またはコマンドファイルに YAML フロントマターがないか、無効です。 --- デリミタ間にフロントマターを追加または修正してください。プラグインディレクトリを検証するときに報告されます。
Plugin name "<name>" is reserved: it passes as one of Anthropic's own プラグインの name は 予約名 の 1 つです。 プラグインが何をするかに基づいてプラグインの名前を変更してください。
Unknown field '<key>' マニフェストにスキーマが定義していないフィールドがあります。 それを削除するか、メッセージが提案する名前を使用してください。Claude Code は読み込み時に未知のフィールドを無視します。plugin.json の privacyPolicyUrl やその他のディレクトリ掲載フィールドについては、ディレクトリ掲載フィールド を参照してください。

各修正後にコマンドを再度実行し、エラーが出力されなくなるまで続けてください。

plugin.json フィールドは マニフェストリファレンス にあり、マーケットプレイスレベルのメッセージは マーケットプレイス検証エラー の下にあります。

`Plugin has conflicting manifests`

プラグインが Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components. で読み込みに失敗します。

プラグインには独自の plugin.json があり、そのマーケットプレイスエントリは strict: false を設定しながら、commands、agents、skills、hooks、outputStyles、または themes のいずれかを宣言しています。エントリからこれらのフィールドを削除するか、エントリで strict: true を設定して、Claude Code がそれらを plugin.json に追加するようにしてください。Strict モード を参照してください。

`Warning: No commands found in plugin custom directory`

プラグインが読み込まれると、~/.claude/debug/<session-id>.txt の claude --debug ログに Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories. が記録されます。セッションまたは Errors タブには何も表示されません。

マニフェスト内の commands パスは存在しますが、.md ファイルを保持していないか、サブディレクトリに SKILL.md がありません。コマンドファイルを追加するか、マニフェストからパスを削除してください。

マーケットプレイスをホスト

マーケットプレイスを発行し、ユーザーがエラーを報告するか、独自の検証が失敗します。これらのエントリはマーケットプレイス所有者向けです。

相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗

ユーザーは https://example.com/marketplace.json URL でマーケットプレイスを追加しました。./plugins/my-plugin などの相対パスである source を持つプラグインのインストールは its marketplace entry path does not stay inside the marketplace directory で失敗します。既にインストールされているプラグインは Plugin source path refused で読み込みに失敗します。両方のメッセージはエラーリファレンスエントリを持っています。

ユーザーが URL ベースのマーケットプレイスを追加する場合、Claude Code は marketplace.json ファイル自体のみをダウンロードします。相対パスからプラグインファイルをそのサーバーからフェッチしないため、相対パスはダウンロードされたことのないディレクトリを指しています。Claude Code が独自にフェッチできるソース(GitHub リポジトリなど)を各エントリに与えてください:

{ "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }

または、マーケットプレイスを git リポジトリでホストし、ユーザーにリポジトリ URL で追加するよう指示してください。git ソースの場合、Claude Code はリポジトリ全体をクローンするため、相対パスは解決されます。ソースタイプはマーケットプレイスリファレンスにあります。

マーケットプレイス検証エラー

マーケットプレイスディレクトリから claude plugin validate . を実行し、マーケットプレイスファイル自体のエラーまたは警告を報告しました。

claude plugin validate はまた、source がローカルパスである各エントリを検証し、エントリの version がプラグイン自体のマニフェストと一致しないときに警告します。

表はマーケットプレイスレベルのメッセージをリストしています。エントリレベルのメッセージはclaude plugin validate がエラーを報告の下のプラグインメッセージで、plugins[N] plugin.json → でプレフィックスされています。

メッセージ 種類 修正
Duplicate plugin name "<name>" found in marketplace エラー 各プラグインに一意の name を与えてください。
Path contains "..": <path> under plugins[N].source エラー .. セグメントなしでマーケットプレイスルートに対して相対パスを使用してください。
Marketplace name cannot contain control or bidirectional-formatting characters エラー 名前からエスケープまたは改行などの文字を削除してください。
Plugin name cannot contain control or bidirectional-formatting characters エラー プラグイン name から文字を削除してください。
Claude Code cannot install plugins from marketplace "<name>". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change the marketplace's "name". エラー マーケットプレイスの名前をメッセージが述べるルールに合わせて変更してください。
Claude Code cannot install plugin "<name>". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name". エラー エントリの名前をメッセージが述べるルールに合わせて変更してください。
Marketplace has no plugins defined 警告 plugins に少なくとも 1 つのエントリを追加してください。
No marketplace description provided 警告 トップレベルの description を追加してください。
Plugin name "<name>" is not kebab-case under plugins[N] plugin.json → name 警告 小文字、数字、ハイフンに名前を変更してください。claude.ai マーケットプレイス同期はその形式を必要とします。
Entry declares version "<a>" but <path>/plugin.json says "<b>" 警告 エントリを plugin.json と一致するように更新してください。これはインストール時に権威です。
Marketplace name "<name>" is reserved in Claude Desktop 警告 マーケットプレイスの名前を変更してください。Claude Desktop の管理マーケットプレイス同期は、任意のケースで org、org-provisioned、unknown を拒否します。
Marketplace name "<name>" is not accepted by Claude Desktop または Plugin name "<name>" is not accepted by Claude Desktop 警告 最大 128 文字の文字、数字、.、_、- に名前を変更し、文字または数字で始まります。

v2.1.247 より前では、制御またはビジョナル形式の文字を含むマーケットプレイス名は、Marketplace name impersonates an official Anthropic/Claude marketplace としてのみ報告されました。

組織によってブロック

組織は管理設定をデプロイしてプラグインを制限し、コマンドはポリシーメッセージで拒否されました。これらのエントリは各拒否の背後にある設定に名前を付けるため、管理者に何を依頼するかを知っています。管理者側については、組織のプラグインを管理を参照してください。

`Marketplace source '' is blocked by enterprise policy`

/plugin marketplace add、update、またはインストールを実行し、Claude Code はこの行で拒否しました。GitHub または git ソースの場合、ホストはソースの後に括弧内に続きます。例えば、'github:owner/repo' (github.com)。

管理者は管理設定で blockedMarketplaces または strictKnownMarketplaces を設定し、このソースは許可されていません。管理者にソースを許可するよう依頼するか、メッセージがリストする許可されたソースの 1 つを追加してください。

メッセージの残りを一致させて、どのポリシーがソースをブロックしたかを確認してください:

  • Allowed sources: <list>:ブロックは blockedMarketplaces ブロックリストではなく strictKnownMarketplaces 許可リストから来ています
  • No external marketplaces are allowed.:strictKnownMarketplaces 許可リストは空です
  • ショートハンドが github.com を想定するという Tip::許可リストは git ホストをホスト名で許可し、渡した owner/repo ショートハンドは github.com を指しています。リポジトリが内部ホストに存在する場合は、git@your-git-host.com:owner/repo.git などの完全な URL で再度追加してください

ポリシーがより制限的になる前に追加したマーケットプレイスは、ポリシーがすべての更新に適用されるため、更新を停止します。

`Marketplace "" is not in the allowed marketplace list`

Errors タブはこの行を表示するか、既に登録しているマーケットプレイスの場合は Marketplace "<name>" is blocked by enterprise policy を表示します。

マーケットプレイスソースをブロックする同じ管理設定は読み込み時に適用されます。strictKnownMarketplaces はこのマーケットプレイスを含まないか、blockedMarketplaces がそれに名前を付けるため、Claude Code は読み込みを停止し、そのプラグインも同様です。許可リストバリアントの場合、ガイダンス行は許可されたソースを表示するか、Contact your administrator to configure allowed marketplace sources を読みます。ブロックリストバリアントの場合、This marketplace source is explicitly blocked by your administrator を読みます。

`Plugin "" is blocked by your organization's policy and cannot be installed`

インストールはこの行で拒否されたか、有効化は同じ行で終わったか、Plugin "<name>" is from marketplace "<marketplace>", which is blocked by your organization's policy または Plugin "<name>" depends on "<dep>", which is blocked by your organization's policy という理由で名前を付けたインストールまたは更新。

管理設定はこのプラグイン、そのマーケットプレイス、またはそれが必要とする依存関係をブロックします。どのエントリが適用されるかを管理者に尋ねてください。ブロックされた依存関係は、依存関係のマーケットプレイスが許可されるまでプラグインをインストールできないことを意味します。

`--plugin-dir is disabled by your organization's managed settings (disableSideloadFlags)`

--plugin-dir、--plugin-url、--agents、または --mcp-config で claude を開始しました。Claude Code はこのメッセージで終了し、Plugins, custom agents, and MCP servers can only be loaded from sources your administrator has approved.

管理者は管理設定で disableSideloadFlags を設定し、任意のパスからプラグイン、エージェント、サーバーを読み込むフラグをオフにします。承認されたマーケットプレイスからプラグインを読み込むか、管理者に設定を削除するよう依頼してください。

/plugin Errors タブの関連メッセージは --plugin-dir copy of "<name>" ignored: plugin is locked by managed settings です。管理設定はそのプラグインを名前で有効または無効にし、Claude Code はポリシーをオーバーライドできないようにそのコピーを無視します。

`Plugins from ~/.claude/skills/ are blocked by your organization's managed settings`

claude plugin init または claude plugin enable を実行し、この行で停止しました。メッセージは strictKnownMarketplaces or blockedMarketplaces に名前を付け、管理者に {"source":"skills-dir"} を strictKnownMarketplaces に追加するか、blockedMarketplaces から削除するよう依頼します。

skills-dir ソースは Claude Code が ~/.claude/skills/ ディレクトリから読み込むプラグインを表します。メッセージが名前を付ける変更を行うよう管理者に依頼してください。

`Command-sourced plugins are disabled by your organization's managed settings`

command ソースを持つプラグインをインストールまたは更新し、この行で停止し、The plugin was not installed or updated and its command was not run.

管理者は disableCommandPluginSources を設定したため、Claude Code はマーケットプレイスが宣言したコマンドを実行することを拒否してプラグインを生成します。disableCommandPluginSources が設定されていない場合、allowManagedHooksOnly のみを設定すると同じ効果があります。ポリシーが許可するソースタイプからプラグインを発行できるかどうかを管理者に尋ねてください。

`Marketplace '' is seed-managed`

claude plugin marketplace update <name> を実行し、Marketplace '<name>' is seed-managed (<dir>) で失敗し、管理者に尋ねるヒントが続きました。

オペレーターは CLAUDE_CODE_PLUGIN_SEED_DIR を通じてこのマーケットプレイスを事前に入力し、Claude Code はシード管理マーケットプレイスを読み取り専用として扱います。バルク marketplace update はそれをスキップし、他を更新します。

マーケットプレイスのコンテンツを変更するには、シードイメージを維持する人に更新するよう依頼してください。手順については、コンテナと CI をシードを参照してください。

次のステップ