<name> などのプレースホルダーを表示します。
プラグインをインストールする場合、構築する場合、マーケットプレイスをホストする場合、または組織のプラグインを管理する場合は、このページを使用してください。
これらのケースは他のページで説明されています。
- スコープ、キャッシュ、および優先順位の動作方法: プラグイン読み込みリファレンスを参照してください
- フラグ、フィールド、またはコマンドを検索する: プラグインコマンドリファレンス、マニフェストリファレンス、またはマーケットプレイスリファレンスを使用してください
hooks module not loadedまたはhooks module did not loadメッセージ: そのプラグインは mod であるため、mod が読み込まれないを参照してください
/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 セッション：プラグインをインストールの下の Desktop app タブを使用してください
- 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 セッション内で入力するコマンドであり、シェルプロンプトではありません。セッションを開始して、そこで同じコマンドを入力してください：
✓ 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 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 シェルコマンドは決してそれを登録しません。
追加してから、インストールを再試行してください：
Successfully added marketplace: claude-plugins-official を出力し、/plugin marketplace list はマーケットプレイスをそのソースと共に表示します。
このメッセージの他のマーケットプレイス名については、Marketplace "<name>" not foundを参照してください。
同じ文字列は、パネルの読み込み失敗のリストである /plugin Errors タブにも表示されます。設定で名前が付けられたプラグインが追加していないマーケットプレイスを名前付けする場合。
Marketplace "<name>" 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://URLuser@host:pathSSH URL./、../、/、または~で始まるローカルパス
claude-plugins-official などの裸の名前はそれらのいずれにも一致しません。marketplace.anthropic.com などの裸のホスト名も同様です。
ソースを受け入れられた形式の 1 つで再入力してください：
Successfully added marketplace: <name> を出力します。
'<source>' 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または絶対パス
Successfully added marketplace: <name> を出力します。
Invalid git URL
マーケットプレイスを追加したか、プラグインをインストールしたか、git アドレスから更新を実行し、コマンドが Invalid git URL で失敗しました。
Claude Code は git アドレスを実行する前にすべてのチェックを行います。サポートしていないプロトコルを持つアドレスを拒否します。また、git がアドレスが示すものとは異なるサーバーまたはフォルダに名前を付けるとして読むことができるアドレスも拒否します。
アドレスの後のテキストは、変更する内容を名前付けします。メッセージが言うようにアドレスを書き直し、コマンドを再度実行してください。
代わりに is blocked by enterprise policy と言う拒否は、組織の設定から来ています。マーケットプレイスソースはエンタープライズポリシーによってブロックされていますを参照してください。
Path does not exist: <path>
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 <path>/.claude-plugin/marketplace.json
Claude Code はマーケットプレイスをクローンまたはダウンロードしましたが、その内部の予想されるパスに marketplace.json が見つかりませんでした。追加コマンドは Failed to add marketplace: Marketplace file not found at ... として報告します。
デフォルトの場所はリポジトリルートの .claude-plugin/marketplace.json であり、マーケットプレイスリファレンスは受け入れられた場所を一覧表示しています。
修正は所有者と他の人で異なります：
- マーケットプレイスを所有している場合：ファイルをその場所に配置し、マーケットプレイスを再度追加してください
- 他の誰かがホストしている場合：所有者に正確なソースを尋ねてください
Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name
マーケットプレイスを追加しましたが、その marketplace.json 内の name が、my-plugin@my-marketplace のようなプラグイン ID の @ 以降の部分として有効ではありません。Claude Code は追加を拒否し、何も登録しません。
メッセージの残りの部分には、名前のルールが記載されています。この例では、_internal は _ で始まっているためルールに違反しています：
- マーケットプレイスを所有している場合：
marketplace.jsonのnameを、たとえばinternal-toolsに変更してください - 他の誰かがホストしている場合：所有者に名前の変更を依頼してください
Cannot add marketplace "<name>": Claude Code reserves this name and cannot register a marketplace under it
マーケットプレイスを追加しましたが、その marketplace.json 内の name が、constructor、toString、valueOf など、すべての JavaScript オブジェクトが持つメンバー名のいずれかです。Claude Code はこれらの名前を予約しているため、追加を拒否し、何も登録しません。これらの名前は予約名に一覧されています。
この例では、マーケットプレイスの名前は constructor です：
extraKnownMarketplaces でマーケットプレイスを宣言している場合、Claude Code が起動時に実行する追加も同じように失敗し、/plugin の Errors タブにそのメッセージが表示されます。
マーケットプレイスに別の名前を付けてから、再度追加してください：
- マーケットプレイスを所有している場合：
marketplace.jsonのnameを変更してください - 他の誰かがホストしている場合：所有者に名前の変更を依頼してください
SSH authentication failed または HTTPS authentication failed
git リポジトリからマーケットプレイスを追加または更新し、クローンが Failed to clone marketplace repository: で失敗し、その後にこれらの行のいずれかが続きました。
まずリポジトリ自体を確認してください：スペルが間違った owner/repo、存在しないリポジトリ、またはアクセスできないプライベートリポジトリもこのメッセージで終わります。ブラウザでリポジトリ URL を開くか、ターミナルで git ls-remote <url> を実行して、それが存在し、アクセス権があることを確認してください。
リポジトリが正しい場合、原因は認証情報です。Claude Code は、GIT_ASKPASS で設定されたものを含め、git のプロンプトと askpass プログラムをオフにし、SSH をバッチモードで実行します。git がプロンプトを必要とする場合、クローンのエラーには fatal: Cannot prompt because user interactivity has been disabled、terminal prompts disabled、または fatal: unable to get password from user が含まれます。git がプロンプトや askpass プログラムなしで取得できる認証情報のみが成功します：
- SSH：
ssh -T git@<host>はパスフレーズを要求せずに成功する必要があり、ホストは既にknown_hostsにある必要があります - HTTPS：認証情報ヘルパーはホストのトークンを保持する必要があります。GitHub の場合は、
gh auth loginとgh auth setup-gitを実行してください。別のホストの場合は、個人用アクセストークンを git 認証情報ヘルパーに保存してください。テストするには、ターミナルでGIT_ASKPASSの設定を解除し、git -c core.askPass= ls-remote <url>を実行してください。
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 回接続してフィンガープリントを受け入れ、再試行してください：
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 秒を取得します。大規模なリポジトリまたは遅い接続の場合は、制限を上げてください。値はミリ秒単位です：
- Bash または Zsh
- PowerShell
claude plugin marketplace add <source> --sparse <paths> で名前を付けたディレクトリにチェックアウトを制限してください。
リポジトリに大きな git サブモジュールがある場合は、Claude Code を更新してください。v2.1.295 以降では、Claude Code はプラグインファイルを含むサブモジュールのみを取得します。それより前のバージョンはすべてのサブモジュールを取得するため、それだけで 120 秒を使い切ることがあります。
マーケットプレイスの更新がオフラインで失敗し続ける
マーケットプレイスの git ホストに到達できない環境で作業しており、すべてのセッションがバックグラウンドで失敗した更新を繰り返します。マーケットプレイスの既存のチェックアウトは所定の位置に留まり、スタートアップは遅延しません。 各セッション、自動更新がオンのマーケットプレイスの場合、Claude Code はバックグラウンドでマーケットプレイスの git ホストをチェックして新しいコミットを確認します。そのチェックがホストに到達できない場合、マーケットプレイスを再度クローンしようとし、オフラインではそのクローンも失敗します。 この変数を設定して、チェックがホストに到達できない場合の再クローン試行をスキップし、既存のチェックアウトを使用し続けてください：- Bash または Zsh
- PowerShell
.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 "<name>" not found in marketplace "<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 はマーケットプレイスをオフラインの場合など、ルックアップの前に更新しなかったため、カタログのコピーが古い可能性があります。マーケットプレイスの名前で更新し、再度インストールしてください：
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 "<name>" 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 はルックアップの前に更新します：
✓ Installed <plugin>. を表示するか、claude plugin install から Successfully installed plugin: <plugin>@<marketplace> を表示します。
どのマーケットプレイスがプラグインをリストしているかわからない場合は、/plugin marketplace list を実行して、持っているマーケットプレイスを確認し、/plugin の Discover でプラグイン名を参照してください。
Plugin '<name>@<marketplace>' 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 で終了します。キャッシュディレクトリが見つからない場合、同じコマンドは再度ダウンロードします。
"<plugin>" was not installed: it would share its folder with "<other>"
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 ソースを使用し、ダウンロードされたファイルのダイジェストはピンと一致しません。
完全なメッセージは次のようになります：
- プラグインを発行する場合：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 値をチェックし、それを拒否しました。メッセージには値と理由が示されます：
- 自分が所有者の場合：
packageを npm プラグインソースリファレンスが受け入れる値に変更するか、エントリをgithub、url、またはgit-subdirソースに切り替えてください - そうでない場合：メッセージをマーケットプレイス所有者に報告してください
Marketplace "<name>" is registered from an untrusted source
以前に追加したマーケットプレイスが読み込みを停止し、そのプラグインも同様です。この行は /plugin Errors タブまたは次の更新に表示されます。
マーケットプレイスは公式 Anthropic マーケットプレイス用に予約されている名前で登録されていますが、登録されたソースは anthropics GitHub リポジトリではありません。予約された名前はマーケットプレイスが読み込まれるか更新されるたびに再チェックされるため、マーケットプレイスとそれからインストールされたプラグインは読み込みを停止します。
完全なメッセージは予約された名前と修正を名前付けします：
- マーケットプレイスを使用する場合：シェルで
claude plugin marketplace remove <name>を実行し、公式github.com/anthropicsリポジトリからマーケットプレイスを再度追加してください - 名前が予約される前に名前を使用したサードパーティマーケットプレイスを発行する場合：名前を変更し、ユーザーにソースから再度追加するよう依頼してください
Marketplace "<name>" is added but ignored
マーケットプレイスには ~/.claude/plugins/known_marketplaces.json にエントリがありますが、そのエントリが、Claude Code がこのファイルを読み込むたびに実行するチェックに失敗したため、マーケットプレイスとそこからインストールされたプラグインは読み込まれなくなります。シェルでは、claude plugin list が影響を受ける各プラグインについて、理由と修正方法を示す行を報告します：
/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:の後のコマンドがあればそれを使用して、マーケットプレイスを削除してください。同じ名前で再度追加しても再び拒否されます
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 <name> 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: <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 を追加してください：
Successfully added marketplace: claude-plugins-official を出力し、Discover はそのプラグインをリストします。Anthropic マーケットプレイスページは、追加できる他のマーケットプレイスをリストしています。
Marketplace "<name>" is already added from a different source
セッションまたはシェルから、インストールコマンドの --marketplace <source> で新しいマーケットプレイスソースを指定しました。Claude Code がそのソースからフェッチしたカタログは、別のソースから既に追加したマーケットプレイスと同じ名前を持っています。Claude Code は既存のマーケットプレイスを置き換えずに保持し、プラグインはインストールされません。
完全なメッセージは次のようになります：
- 既に追加したマーケットプレイス：
/plugin install <plugin>@<name>で名前でインストールしてください - 新しいソース：
/plugin marketplace remove <name>を実行し、インストールを再試行してください
Cannot add marketplace "<name>": 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" }のエントリの場合は、次を実行します： -
新しいソースを使用：
extraKnownMarketplacesエントリを編集または削除し、マーケットプレイスを再度追加してください。管理設定がそれを宣言する場合は、管理者に尋ねてください
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> (<reason>)
/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 <path>
プラグインをインストールする場合、Claude Code はそのファイルの新しいコピーをダウンロードし、プラグインキャッシュのそのバージョンのフォルダに移動します。このメッセージは移動が失敗したことを意味し、通常は別のプログラムがインストール中にフォルダを使用していたためです。ファイルシステムコードは括弧内に表示されます：
The previously installed copy was moved back：持っていたバージョンはまだインストールされていますhad to be removed first、was not moved back、またはcould not be moved back：そのプラグインバージョンはインストールが成功するまでインストールされません- そのような文がない：以前のコピーがなかったため、バージョンはまだインストールされていません
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と/pluginErrors タブに表示され、Claude Code は解決するまで影響を受けたプラグインを無効のままにします
これらをプログラムで表示するには、シェルで
claude plugin list --json を実行してください。問題のあるプラグインは、メッセージを含む errors フィールドと、各メッセージの type を含む errorDetails フィールドを運びます：最初の 3 行は dependency-unsatisfied で、4 番目は 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 を開き、プラグインの詳細ペインを開きます。ここにはプラグインに含まれる内容が一覧表示されます。ここにスキルが 1 つも表示されないプラグインには、/を入力したときに提供できるスキルがありません
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を付けて実行するか、新しいセッションを開始してください
/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_CODE_DISABLE_NONESSENTIAL_TRAFFICが設定されている間は、claude plugin updateと/pluginは再試行をスキップし、プラグインが最新バージョンであると報告します。 -
were not installed, because ...: このプラグインではインストールを実行できず、注記にはその理由が示されます。たとえば、Yarn、pnpm、またはbun.lockbのロックファイルである場合や、このコンピューターにインストールされていないパッケージマネージャーのロックファイルである場合です。その理由が解消されない限り、プラグインを更新してもパッケージはインストールされません。理由がロックファイルの場合は、プラグインの作成者がそれを置き換える必要があります。パッケージマネージャーがない場合は、それをインストールしてからプラグインを更新してください
Plugin "<name>" not cached at <path>
Errors タブに、Run /plugin to refresh the plugin cache という対処方法とともにこの行が表示される場合です。Claude Code にはプラグインのインストール記録がありますが、記録が指すディレクトリが存在しません。たとえば、キャッシュを削除した後に発生します。
シェルからプラグインを再インストールしてください。claude plugin install <name>@<marketplace> は、記録が存在していてもインストールディレクトリがないプラグインを再ダウンロードします。
/reload-plugins を実行します。Errors タブのエントリが消え、プラグインが Installed に戻ります。
installed_plugins.json holds a record under "<id>" 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（場合によっては新しいバージョン）が書き込んだものです。
その記録が存在する間、このバージョンはファイルを書き換えないため、記録が失われることはありません。
メッセージに示された対処法を順番に試してください。
claude updateで Claude Code を更新します。- 更新できない場合は、記録を書き込んだバージョンの Claude Code で、指定されたプラグインをアンインストールします。
- どちらでも解決しない場合は、
installed_plugins.jsonから記録を手動で削除し、Claude Code を再起動するか/reload-pluginsを実行します。
installed_plugins.json could not be read and was rebuilt
installed_plugins.unreadable.<date>.<hash>.kept という名前の保存ファイルが installed_plugins.json と同じ場所にある間、claude plugin list はそのファイルのパスとともにこの注記を出力します。
有効な 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
installed_plugins.set-aside.<date>.<hash>.json という名前のコピーが installed_plugins.json と同じ場所にある間、claude plugin list はそのコピーのパスとともにこの注記を出力します。注記は Nothing needs doing about these copies. で終わります。
installed_plugins.json 内の記録が有効なプラグイン ID ではないキーの下にあったため、どのバージョンの Claude Code もそれを使用できません。ファイルの残りの部分は通常どおり読み込まれます。
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 の成功行の後に表示されます。
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 "<name>" is enabled in project settings but isn't installed here
プロジェクトの .claude/settings.json が有効にしているプラグインについて、Errors タブに Run claude plugin install <name>@<marketplace> --scope project to install it for this project という対処方法とともにこの行が表示される場合です。
リポジトリの設定で、そのリポジトリを開くすべてのユーザーに対してプラグインを有効にできますが、インストールまではされません。プラグインが GitHub リポジトリや npm パッケージなどの外部ソースから提供される場合、ユーザー自身がインストールするまで Claude Code はそれをダウンロードしません。対処方法の行にあるコマンドをシェルで実行してから、リロードしてください。
/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 list --json を実行して、行が削除されたことを確認してください。
v2.1.295 より前は、2 回目の実行が Plugin "<name>" is not installed in project scope で失敗します。claude update を実行してから、もう一度アンインストールを実行してください。
Git リポジトリからインストールしたプラグインのバージョンが unknown と表示される
claude plugin list での Version: unknown は、Git ソースのプラグインのバージョンとして使用するコミットを Claude Code が読み取れなかったことを意味する場合があります。そのプラグインは独自のリポジトリを持っている場合もあれば、Git でホストされたマーケットプレイス内にある場合もあります。
シェルで次のコマンドを実行してください。formatter@my-marketplace は、claude plugin list に表示されるプラグインの name@marketplace の行に置き換えてください。
1
Claude Code を更新する
Claude Code を更新 して v2.1.302 以降にします。このバージョンは、コミットを読み取れる形式でクローンします。
2
マーケットプレイスを更新する
Claude Code が保持するマーケットプレイスのコピーを更新します。これには、マーケットプレイスリポジトリ内のプラグインのコミットが保持されています。
3
プラグインを更新する
プラグインを更新して、記録されているバージョンを書き換えます。
4
バージョンを確認する
Version: の行に、12 文字のコミット ID などの値が表示されていることを確認します。claude plugin update は 1 回の実行で 1 つのスコープのブロックを変更します。まだ unknown と表示されているブロックについては、そのブロックの Scope: の値を指定して再実行してください。
unknown と表示される場合は、さらにヘルプを得る を参照してください。
Failed to load hooks from <path> と発火しないフック
プラグインのフックが実行されない、またはフックがアクションをブロックする場合です。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フィールドが、プラグインルートからの相対パスに存在しないファイルを指定しています。パスを修正するか、ファイルを追加してくださいhooks path escapes plugin directory: <path>: パスがプラグインディレクトリの外を指している を参照してください
トランスクリプトの 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 を見つけられなかったことを意味します。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} の修正 を適用してください。
フックは読み込まれるが発火しない
フックがエラーなく読み込まれるものの一度も発火しない場合は、まずセッションで/plugin を実行し、プラグインの詳細を開きます。そこに Its hooks.json hooks do not run で始まる注記がある場合は、同じ名前を持つ別の有効なプラグインが代わりにフックを登録しています。どちらのコピーが該当するか、また切り替える方法については、2 つの有効なプラグインが同じ名前を持つ場合のフック を参照してください。それ以外の場合は、フックの定義を確認してから、実際に実行される様子を確認します。
1
イベント名を確認する
イベント名は大文字と小文字が区別されるため、
PostToolUse のように正確に一致していることを確認してください。2
matcher を確認する
フックの
matcher がツール名に一致していることを確認してください。3
意図的にイベントを発生させる
PostToolUse フックの場合は、Claude にファイルの編集を依頼します。4
デバッグログを確認する
デバッグログ を開きます。ここにはどのフックが一致したかが記録されます。実行されたフックは、終了コードとともにここに表示されます。
Plugin directory does not exist: <path>
メッセージには再インストールするよう書かれていますが、まず 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 "<server>" と起動しない MCP サーバー
プラグインに MCP サーバーが同梱されており、Errors タブに Invalid MCP server config for "<server>": <error> が表示される場合、またはサーバーは一覧に表示されるものの /mcp で一度も接続済みと表示されない場合です。
Invalid MCP server config for "<server>": <error>
サーバーの設定はスキーマチェックに合格していますが、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の場合については、plugin command references user_config に専用の項目があります
Bundled MCP server "<name>" was not started: it needs configuration
プラグインが user_config を宣言する MCPB バンドル としてサーバーを含んでおり、必須の設定項目にまだ保存された値がないか、保存された値がバンドル自体の検証に合格しないため、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 フラグはターミナルには出力しません。
claude --debug を実行する前の 15 分以内に プラグインの stdio サーバー への接続が失敗していた場合、Claude Code は サーバーを起動しません。新しいセッションで /mcp のサーバーのメニューから Reconnect を選択してサーバーを起動してから、ログを開いてください。.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 つの障害は、プラグインがインストールされているが機能していない の下にエントリがあります。
- 発火しないフック: 発火しないフック を参照してください
- 起動しない MCP サーバー: 起動しない MCP サーバー を参照してください
commands path not found: <path>
Errors タブに commands path not found: <absolute path> が表示され、ガイダンスとして Check that the path in your manifest or marketplace config is correct と表示されます。同じメッセージは skills、agents、hooks に対しても表示されます。
Claude Code は plugin.json またはマーケットプレイスエントリからのパスをプラグインルートに対して解決し、そこに何も見つかりませんでした。メッセージ内のパスはチェックした絶対パスなので、ディスク上の内容と比較してください。パスを修正するか、ディレクトリを作成してから /reload-plugins を実行してください。
v2.1.299 より前では、このメッセージが起動時に
synced[0] などのタグでラベル付けされた行に表示されることがありました。その行は claude.ai から同期された プラグインのものです。このメッセージは、マシン上の別の Claude Code セッションが直前にプラグインを更新し、そのファイルを移動した場合に表示されていました。プラグインを読み込むには、Claude Code を再起動してください。この理由でメッセージが表示されないようにするには、v2.1.299 以降に更新してください。./ で始まります。プラグインルートの外に解決されるパスは、代わりに <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 つの空のプラグインとして読み込みました。フラグをプラグインディレクトリ自体に指定してください。
/plugin で Installed を開き、プラグインの詳細ペインでそのコンポーネントを一覧表示します。
プラグインがそのディレクトリの外で参照するファイルが見つからない
プラグインは--plugin-dir でソースディレクトリから機能しますが、インストール後に ../shared-utils などのパスに関するエラーで失敗します。
Claude Code はインストール済みプラグインをキャッシュにコピーし、そこから読み込むため、プラグイン自体のディレクトリの外に到達するパスはキャッシュ内で何も指しません。共有ファイルをプラグインディレクトリ内に移動するか、その中のシンボリックリンクを通じて参照してください。キャッシュの場所とパスの解決方法については、ディスク上のプラグインを検索 を参照してください。
${CLAUDE_PLUGIN_ROOT} が Windows で前方スラッシュを表示する
Windows では、Git Bash を通じて実行されるプラグインフックが ${CLAUDE_PLUGIN_ROOT} を C:\Users\you\... ではなく C:/Users/you/... として受け取り、バックスラッシュを期待するスクリプトが破損します。
Git Bash がインストールされている場合、シェル形式のフック はデフォルトで Git Bash を通じて実行されます。Git Bash を通じて実行されるフックに対しては、Bash がバックスラッシュをエスケープとして解釈しないように、Claude Code は前方スラッシュでパスを渡します。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 がリクエストを一致させるために必要なキーワードが削除される可能性があります。スキルの説明が短く切り詰められている を参照してください
tool_used: Skill グレーダー を使用して eval ケースを作成し、各説明変更後に claude plugin eval で実行してください。
claude plugin eval init から <directory> 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 つのフラグを使用してください。
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 を渡す場合にのみ検証を停止します。説明の欠落など、その他の警告は一覧表示されません。
各修正後にコマンドを再度実行し、エラーが出力されなくなるまで続けてください。
plugin.json フィールドは マニフェストリファレンス にあり、マーケットプレイスレベルのメッセージは マーケットプレイス検証エラー の下にあります。
Plugin <name> 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 <name> 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 リポジトリなど）を各エントリに与えてください：
git サブモジュールにあるルートプラグインのファイルがインストール後に見つからない
プラグインがマーケットプレイスのルートにあり、リポジトリの git サブモジュールにあるファイルを実行または読み取ります。インストール後、サブモジュールのディレクトリが空になっています。v2.1.295 より前は、Claude Code がすべてのサブモジュールをフェッチしていたため、このディレクトリにはファイルが存在していました。 Claude Code はマーケットプレイスをクローンするとき、プラグインファイルを含むサブモジュールのみをフェッチします。ルートにあるプラグインの場合は、プラグインの設定内のパスとプラグインのファイルのテキストを読み取って判断します。スクリプトが実行中に組み立てるパスは認識できません。 サブモジュール内へのパスは、フックコマンド内の${CLAUDE_PLUGIN_ROOT}/vendor/tool/run.sh のように、Claude Code が読み取れる場所に完全な形で記述してください。そうすると、Claude Code はそのプラグインについてリポジトリ内のすべてのサブモジュールをフェッチします。
マーケットプレイス検証エラー
マーケットプレイスディレクトリからclaude plugin validate . を実行し、マーケットプレイスファイル自体のエラーまたは警告を報告しました。
claude plugin validate はまた、source がローカルパスである各エントリを検証し、エントリの version がプラグイン自体のマニフェストと一致しないときに警告します。
表はマーケットプレイスレベルのメッセージをリストしています。エントリレベルのメッセージはclaude plugin validate がエラーを報告の下のプラグインメッセージで、plugins[N] plugin.json → でプレフィックスされています。
v2.1.247 より前では、制御またはビジョナル形式の文字を含むマーケットプレイス名は、
Marketplace name impersonates an official Anthropic/Claude marketplace としてのみ報告されました。
組織によってブロックされている
組織がプラグインを制限する管理設定を展開しており、コマンドがポリシーメッセージとともに拒否されました。以下の各項目では、それぞれの拒否の原因となっている設定を示しているため、管理者に何を依頼すればよいかがわかります。管理者側の手順については、組織のプラグインを管理するを参照してください。Marketplace source '<source>' is blocked by enterprise policy
/plugin marketplace add、update、またはインストールを実行したところ、Claude Code がこの行を表示して拒否しました。
管理者が管理設定で blockedMarketplaces または strictKnownMarketplaces を設定しており、このソースは許可されていません。管理者にソースの許可を依頼するか、メッセージに列挙されている許可済みソースのいずれかを追加してください。
メッセージの残りの部分を照合して、どの種類のポリシーがソースをブロックしたかを確認してください。
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 "<name>" 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 "<name>" is blocked by your organization's policy and cannot be installed
インストールがこの行で拒否された、有効化が末尾が cannot be enabled となる同じ行で拒否された、またはインストールや更新が理由を示す行で拒否されました。理由を示す行は 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 は --plugin-dir で指定したそのプラグインのコピーを無視します。
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 '<name>' is seed-managed
claude plugin marketplace update <name> を実行したところ、Marketplace '<name>' is seed-managed (<dir>) と管理者に問い合わせるよう促すヒントが表示されて失敗しました。
オペレーターが CLAUDE_CODE_PLUGIN_SEED_DIR を通じてこのマーケットプレイスを事前に配置しており、Claude Code はシード管理のマーケットプレイスを読み取り専用として扱います。一括の marketplace update はこのマーケットプレイスをスキップし、他のマーケットプレイスを更新します。
マーケットプレイスの内容を変更するには、シードイメージを管理している担当者に更新を依頼してください。手順については、シードコンテナと CIを参照してください。
次のステップ
- プラグイン読み込みリファレンス：スコープ、キャッシュ、優先度の動作方法
- プラグインコマンドリファレンス：
claude pluginコマンドのフラグ、デフォルト、出力、終了コード - プラグインをインストールして管理：開始からのインストール手順
- 組織のプラグインを管理：管理者向けのポリシー側トラブルシューティング