マルチエージェントClaude Code プラグインが動かない時の直し方｜エラー別
この記事の要点
- エラーは、表示された文をそのまま探すのが一番の近道。出る段階は「どこで打つか」「目録を足す」「入れる」「入れた後」「会社の制限」に分かれる
- 入れたのに動かない時は、/plugin の Installed と Errors を見てから、必要なら /reload-plugins で読み込み直す
- フックやサーバーが動かない時は、名前の大文字小文字・matcher・デバッグの記録の順に確かめる
Claude Code のプラグインが 「入らない」「入れたのに何も起きない」 という時は、表示された文をそのまま手がかりにするのが一番の近道です。
この記事では、公式ドキュメント「Troubleshoot plugins」（2026年11月13日確認）から、よく出る表示を段階ごとに選び、原因と直し方をまとめます。プラグインの基本は Claude Codeのプラグインとは？ で、入れる前の安全確認は Claude Code プラグインは安全？ で解説しています。
結論：まず「どの段階で止まったか」を見分ける
エラーは、出た段階ごとに原因が違います。 公式の対処表も、①どこで打つか ②目録（マーケットプレイス）を足す ③入れる ④入れた後 ⑤会社の制限、の順に並んでいます。打ったコマンドと、エラーが出た段階が違うこともある点に注意します。たとえば「入れる」で止まっても、原因が「目録が無い」なら ② の話です。
① /plugin を打つ場所が違う
| 表示 | 原因 | 直し方 |
|---|---|---|
| /plugin isn't available in this environment | 画面を描けない場所で打った（-p の実行・Agent SDK・デスクトップアプリの Code タブ・ブラウザなど） | ターミナルで claude を起動して打つか、シェルで claude plugin install を使う |
| zsh: no such file or directory: /plugin | シェルの入力欄で打った | claude で会話を始めてから打つ |
| claude: command not found | Claude Code 本体の場所が通っていない | 本体の入り方（PATH）を直してからやり直す |
| Unknown command | 存在しない書き方 | 下の対応表を見る |
よくある書き間違いも公式にまとまっています。
- claude plugin add ではなく、目録を足すなら claude plugin marketplace add、入れるなら claude plugin install
- --project ではなく、--scope project
- /install ではなく、/plugin install
逆に、claude plugins（複数形）や claude plugin remove は、正しい書き方の別名として使えます。
② マーケットプレイスが見つからない
「Marketplace "claude-plugins-official" not found」 は、公式の目録がまだこのパソコンに登録されていない時に出ます。ふだんはターミナルで初めて会話を始めた時に自動で登録されますが、VS Code の拡張機能しか使っていない時や、会社の設定で止められている時は登録されません。会話の中で次を打って足します。
/plugin marketplace add anthropics/claude-plugins-official成功すると「Successfully added marketplace」と出ます。ほかの名前の目録で同じ表示が出た時は、その目録を足していないか、名前が違います。
③ 入れようとしたら見つからない
「Plugin "名前" not found in marketplace」 は、手元にある目録の写しに、その名前が無い時に出ます。
- 「写しが古いかも」という案内が付いていたら、/plugin marketplace update に目録の名前を付けて更新し、入れ直す
- 案内が無ければ、名前の書き間違いを疑う。/plugin の Discover の一覧から名前をコピーする
目録の名前を付けずに入れようとして 「not found in any marketplace」 と出た時は、名前@目録 の形で目録を指定します。指定すると、探す前に目録が更新されます。
④ 入れたのに動かない
まず状態を確かめてから、何かを変えます。 順番は次の3つです。
- /plugin の Installed を開き、一覧にあって有効になっているかを見る（シェルなら claude plugin list）
- 同じ画面の Errors を開き、読み込めなかった理由を読む
- この会話の途中で入れたなら、/reload-plugins で読み込み直す
入れた時に 「Run /reload-plugins to apply.」 と出た場合は、自分で打たなくても画面を閉じると自動で読み込み直されます。MCP の道具が増減する時は「次のメッセージで会話を全部読み直す」という案内が出るので、そのまま進めるなら --force を付けて実行するか、新しい会話を始めます。
ほかに、つまずきやすい表示です。
- ユーザー設定で切ったのに読み込まれる：プロジェクトの設定が有効にしていて、そちらが優先されています。自分のパソコンだけ切りたい時は、.claude/settings.local.json で false にします
- プロジェクト設定で有効なのに、ここには入っていない：リポジトリの設定は「有効にする」だけで、入れはしません。案内どおり --scope project を付けて入れ、読み込み直します
設定ファイルの優先順位は Claude Code の設定ファイル で解説しています。
フックが動かない
読み込みのエラーは無いのに動かない時は、次の順に見ます。
- イベント名の大文字小文字（PostToolUse など）が合っているか
- matcher が道具の名前に合っているか
- その場面をわざと起こす（PostToolUse なら、ファイルを1つ編集させる）
- デバッグの記録で、そのフックが動いたかを見る
フックの書き方は Claude Codeのフックとは？ で解説しています。
MCP サーバーがつながらない
/mcp で状態を見ます。開始時のエラーを読みたい時は claude --debug で起動し、デバッグの記録を開きます（画面には出ません）。設定の形が間違っているサーバーは、Errors の欄に出ずに静かに外されることがあるので、claude plugin validate でプラグインのフォルダを検査します。MCP そのものの設定は Claude Code の MCP とは？ で説明しています。
⑤ 会社の設定で止められた
会社で配る設定（マネージド設定）がプラグインを制限していると、次のような表示が出ます。自分で回避するのではなく、どの設定で止まっているかを管理者に伝えるのが正しい対応です。
| 表示の一部 | 止めている設定 |
|---|---|
| is blocked by enterprise policy | 目録の禁止リストか許可リスト |
| is not in the allowed marketplace list | 目録の許可リスト |
| is blocked by your organization's policy | プラグイン・目録・依存先の禁止 |
よくある質問
エラーの表示が見当たらない時は？
/plugin の Errors の欄と、claude --debug で残るデバッグの記録を見ます。表示の文がわかれば、公式の対処ページで同じ文を探すのが速い方法です。
自分で作ったプラグインのスキルが出ない時は？
claude plugin validate でフォルダの形を検査し、スキルの置き場所や書き方の間違いを直します。作り方の基本は Claude Codeのプラグインとは？ にまとめています。
Windows でアンインストールしたのに残ります
公式の対処表にも、Windows でアンインストール後もプラグインが残る場合の項目があります。表示の文を手がかりに公式ページの該当箇所を確かめ、それでも直らない時は Claude Code を最新にしてから試します。
まとめ
- エラーは「どこで打つか」「目録」「入れる」「入れた後」「会社の制限」の段階で見分ける
- 入れたのに動かない時は、Installed → Errors → /reload-plugins の順
- フックはイベント名と matcher、MCP は /mcp とデバッグの記録で確かめる
- 会社の制限は回避せず、表示の文を管理者に伝える
出典：Anthropic「Troubleshoot plugins」（2026年11月13日確認） https://code.claude.com/docs/en/plugins/troubleshooting
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。
