SpyBara
Go Premium

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

This page contains 1064 additions and 0 deletions.

2026
Fri 25 23:58

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

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 です。

原因はプラグインコマンドではありません。Claude Code がインストールされていないか、このシェルの PATH にそのインストールディレクトリがありません。インストール後の command not found: claudeに従い、プラグインコマンドを再試行してください。

`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 <plugin>@<name> を実行し、多くの場合は誰かが送信したインストール行から、Claude Code はこの名前のマーケットプレイスがないと報告しました。

名前が 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 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> を出力します。

`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 であり、マーケットプレイスリファレンスは受け入れられた場所を一覧表示しています。

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

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

`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 で終了します。キャッシュディレクトリが見つからない場合、同じコマンドは再度ダウンロードします。

`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> を実行してカタログを更新し、エントリが修正された場合に備えて、インストールを再試行してください。更新後もダイジェストが一致しない場合は、インストール前にマーケットプレイス所有者にピン留めされたファイルを尋ねてください

`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 はマーケットプレイスを追加するときのみ名前をチェックしたため、名前が予約される前に登録されたエントリは読み込みを続けました。

`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`

/plugin install <plugin> --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 network source differs from the one declared for it in settings`

marketplace add を実行し、そのソースのカタログは、設定ファイルが extraKnownMarketplaces で異なるソースで既に宣言しているマーケットプレイスと同じ名前を持っています。Claude Code は追加を拒否し、何も登録しません。

メッセージは修正で終わります：ソースは設定で宣言されたものと一致する必要があります。または、宣言を変更します。渡したソースを extraKnownMarketplaces エントリと比較し、その ref、path、headers を含めて、次のいずれかを実行してください：

  • 宣言されたソースを使用：設定エントリが名前を付けるソースからマーケットプレイスを追加してください
  • 新しいソースを使用：extraKnownMarketplaces エントリを編集または削除し、マーケットプレイスを再度追加してください。管理設定がそれを宣言する場合は、管理者に尋ねてください

`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 activate.`

/plugin のインストール概要は Plugin is now active. の代わりに 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 を報告できました。

`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 の下に戻ります。

`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 の下にリストされます。

組織がプラグインを事前にインストールする場合、代わりに管理設定を通じて行います。プラグインを事前にインストールして必須にするを参照してください。

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

プラグインのフックが実行されません。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 をキャプチャしてください。

フックが読み込まれるが決して発火しない

フックがエラーなく読み込まれるが決して発火しない場合は、その定義を確認してから、それが実行されるのを見てください：

1

イベント名を確認

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

2

マッチャーを確認

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

3

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

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

4

デバッグログを読む

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

`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の下に独自のエントリを持っています

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

/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> をガイダンス Check that the path in your manifest or marketplace config is correct で表示します。同じメッセージは skills、agents、hooks に対して表示されます。

Claude Code はマニフェストまたはマーケットプレイスエントリからパスをプラグインルートに対して解決し、そこに何も見つかりませんでした。メッセージのパスは確認した絶対パスであるため、ディスク上のものと比較してください。パスを修正するか、ディレクトリを作成し、/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/... として受け取り、バックスラッシュを期待していたスクリプトが壊れます。

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

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

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

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

プラグインは Installed の下にエラーなくリストされていますが、/ を入力するときにそのスキルは提供されません。

スキルはプラグインルートの skills/ から読み込まれ、コマンドはプラグインルートの commands/ から読み込まれます。.claude-plugin/plugin.json のみが .claude-plugin/ 内に属し、.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 タブ：ダイアログはこのインタラクティブインストールの一部です
  • シェルで 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 を実行してください。

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

`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: ...。

表は検証を停止するメッセージと 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 frontmatter があります。 --- デリミタ間に frontmatter を追加または修正してください。プラグインディレクトリを検証するときに報告されます。
Unknown field '<key>' マニフェストにスキーマが定義しないフィールドがあります。 それを削除するか、メッセージが提案する名前を使用してください。Claude Code は読み込み時に不明なフィールドを無視します。

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

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 に追加するようにしてください。厳密モードを参照してください。

`Warning: No commands found in plugin custom directory`

プラグインが読み込まれるとき、claude --debug ログは ~/.claude/debug/<session-id>.txt で 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 から文字を削除してください。
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 Code は他の形式を受け入れますが、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 をシードを参照してください。

次のステップ