Claude Codeのプラグインが反映されない・入れたら重くなった時の確認手順【2026年】

Claude Codeのプラグインが反映されないときは、まず /reload-plugins を実行し、/plugin のErrorsタブを見ます。入れてから重い、自分のスキルが呼ばれにくいときは、スキル一覧の枠を /context と /skill-doctor で確かめ、使わないプラグインを無効にします。

プラグインが「反映されない」「入れたら重くなった」の原因早見表

症状は2つに分かれます。入れたのに出てこないのは、ほとんどが読み込みのタイミングかスコープの問題です。入れてから重い、自分のスキルが選ばれにくいのは、プラグインが毎回の会話に足す名前と説明文の量が原因です。2026年10月時点の公式ドキュメントと、僕の会社の記録から、多い順に並べます。

言葉を3つ定義しておきます。プラグインとは、スキル・エージェント・フック・MCPサーバーなどをまとめてClaude Codeに追加する拡張パッケージのことです。スコープとは、そのプラグインを誰に、どの範囲で有効にするかを決める区分のことです。スキル一覧とは、Claudeがどのスキルを使えるかを知るために、会話に毎回載る名前と説明文の一覧のことです。

公式ドキュメントは、有効なプラグインは使った会話だけでなく、すべてのセッションに加わると説明しています。Claudeが自分で呼べるスキル・エージェント・コマンドの名前と説明文は毎ターンの文脈に入り、使用量に数えられます。MCPサーバーはセッションと一緒に起動し、フックは決まったタイミングで動きます。入れ方やマーケットの選び方はClaudeのmarketplacesとプラグインの追加・導入の実録に書きました。

プラグインが反映されないときの確認手順（/reload-plugins・Errorsタブ・スコープ）

公式ドキュメントの確認の順番は「入っていて有効か」「エラーが出ていないか」「読み込み直したか」です。設定ファイルを直接いじる前に、この順に見ます。

手順1 入っていて、有効になっているかを見る

セッションの中で /plugin を開き、Installedタブにそのプラグインがあるかを見ます。シェルなら claude plugin list で、版・スコープ・状態が同じ内容で出ます。作者が最初はオフにしているプラグインもあり、その場合は claude plugin enable <名前> で有効にします。

手順2 Errorsタブを読む

同じ /plugin の画面のErrorsタブに、読み込みに失敗した理由と、次にやることが1行ずつ出ます。プラグインの中のMCPサーバーが起動時に出したエラーは、claude --debug で起動したときのログ（~/.claude/debug/ の下）に残ります。

手順3 /reload-plugins で読み込み直す

シェルの claude plugin install で入れたプラグインは、次にClaude Codeを起動したときか、開いているセッションで /reload-plugins を実行したときに読み込まれます。成功すると Reloaded: に続けて、プラグイン・スキル・エージェント・フック・サーバーの数が出ます。

行の終わりが Run /reload-plugins --force to apply. なら、何も読み込まれていません。MCPのツールが増減して会話のキャッシュが使えなくなるため、Claude Codeが保留にしています。/reload-plugins --force を実行するか、新しいセッションを開きます。

手順4 スコープの食い違いを確かめる

スコープはuser（自分の全プロジェクト）・project（そのリポジトリの全員）・local（自分のそのリポジトリだけ）の3つです。同じプラグインが複数にあると、local、project、userの順に優先されます。

Errorsタブに Plugin "<name>" is enabled in project settings but isn't installed here と出ていたら、リポジトリの設定では有効なのに、その端末には入っていません。claude plugin install <名前>@<マーケット> --scope project を1回実行し、/reload-plugins します。

ブラウザなどのクラウドのセッションは、手元の端末に入れたプラグインを読み込みません。手元では動くのにクラウドで出ないのは、不具合ではなく仕様です。

手順5 / を打って確かめる

プラグインのスキルは /<プラグイン名>:<スキル名> の形で出ます。自分のスキルと同じ名前でも衝突しません。Installedタブの詳細にスキルが1つも並んでいないプラグインは、もともと / に出すものを持っていません。

入れたら重くなった・自分のスキルが呼ばれにくい時の確認手順（スキル一覧の枠）

重さの正体は、毎回の会話に足される名前と説明文です。公式ドキュメントによると、スキル一覧の枠はモデルのコンテキストウィンドウの1%に連動し、あふれると、呼び出しの少ないスキルから説明文が省かれます。名前は残るので呼べますが、Claudeが依頼と結びつけるための言葉が消えます。

手順1 プラグインが足す量を見る

シェルで claude plugin details <名前> を実行します。Always-on の行が、有効にしているすべてのセッションに足される量の見積もりです。部品ごとの行で、どのスキルやエージェントが大きいかも分かります。フックとMCPサーバーはこの見積もりに入りません。出力にも、数字は見積もりで実際と違うことがある、と書かれています。

手順2 実際に載っている量を見る

セッションの中で /context を実行し、Skillsの行を見ます。公式ドキュメントによると、この行は枠を適用した後の大きさで、モデルが実際に受け取る量と一致します。/doctor でも、一覧の大きさの見積もりと、大きい順の内訳が出ます。

手順3 使っていないものを洗い出す

/skill-doctor（Claude Code v2.1.252以降）は、スキルごとの量と呼ばれた回数を出し、一度も呼ばれていないスキルを示します。プラグインのスキルも対象です。/plugin のInstalledタブでは、14日以上かつ10セッション以上使っていないプラグインが「Not used recently」にまとまります。

手順4 絞る

使っていないプラグインは claude plugin disable <名前>@<マーケット> で無効にします。戻すときは enable、消すなら uninstall です。

自分のスキルの説明文を守る方法は2つあります。1つは枠を広げる設定 skillListingBudgetFraction で、たとえば 0.02 で2%になります。もう1つは、優先度の低い自分のスキルを設定の skillOverrides で "name-only" にして、ほかのスキルに枠を譲ることです。ただし、プラグインのスキルに skillOverrides は効きません。プラグイン側を絞る手段は、プラグインごとの無効化だけです。スキルの説明文の書き方と枠の考え方はClaudeのスキルの作り方と使い方で詳しく書いています。

裏方で実際に起きた例：約290本入りのプラグインで、自作スキル約14本の説明文が消えた

2026年10月2日、僕の会社は、スキルを約290本同梱する大型のサードパーティ製プラグインを、userスコープで入れました。社内の導入メモからの転記です。

まず「反映されない」に当たりました。入れたときに動いていたセッションには、プラグインのスキルが出ませんでした。反映されたのは、次に開いたセッションからです。公式の説明どおりの動きですが、知らないと「入っていない」と勘違いします。

次に量です。claude plugin details で見た見積もりは、常時およそ31,500トークンの上乗せでした。ところが、入れる前と後で、セッションの使用量の内訳にあるスキル一覧の欄を比べると、9,967トークンから9,833トークンで、増えていませんでした。

代わりに起きたのが説明文の消失です。僕が自分で作ったスキルのうち約14本が、一覧の上で名前だけになっていました。呼べなくなったわけではありませんが、自動で選ばれにくくなります。プラグイン側の約290本も、最初から名前だけでした。つまり、枠を取り合った結果、プラグインのスキルも自分のスキルも、どちらも自動では選ばれにくい状態になっていたということです。

この動きは、公式ドキュメントの説明（枠があふれると、呼び出しの少ないスキルから説明文が省かれる）と合っています。ただし、僕の環境の数字と公式の1%という枠がどう対応するかまでは確かめていないので、ここでは実測として書くにとどめます。

僕の会社には、逆に増えた記録もあります。2026年9月16日の集計では、プラグイン21個の説明文だけで40,198トークンあり、使っていない18個を止めて1セッションあたり39,601トークン減りました（詳しくは上のマーケットの記事とClaude Codeの料金と使用量上限の実測）。見積もりより増えないことも、大きく増えることもあるので、入れた後に自分の環境で測るのが確実です。

プラグインで重くしない・呼ばれにくくしないための再発防止

この経験から、僕は次の4つを確認の手順にしています。

• 入れたら新しいセッションで確かめる。 入れた直後のセッションで出なくても慌てず、/reload-plugins か新しいセッションで / を打って確かめます。
• 入れる前と後で、スキル一覧の量と説明文を見比べる。 量が増えていなくても、自分のスキルの説明文が省かれていることがあります。
• 自分のスキルが呼ばれにくいと感じたら、まず大きなプラグインを無効にする。 必要なスキルが数本だけなら、プラグインをやめて、そのスキルだけを自分のスキルのフォルダに入れる形に切り替えます。
• プラグインと手動の導入を二重にしない。 同じものを両方の方法で入れると、スキルとフックが重複します。どちらで入れたかを記録しておきます。

業務でプラグインを使うときの注意（フック・無人の定期タスク・チーム）

業務で一番気をつけたいのはフックです。フックとは、ファイルの編集の前後など決まったタイミングで、自動でコマンドを走らせる仕組みのことです。仕組みはClaude Codeのフックの使い方にまとめています。

僕の会社は、このプラグインのフックを、用意されていた設定のうち最小のものにしました。標準の設定には、各ファイルへの最初の編集を一度止めて説明を求めるフック、MCPの状態が悪いと判定すると呼び出しを止めるフック、応答のたびにデスクトップ通知を出すフックが含まれていたためです。人が見ている作業なら役に立ちますが、当社は毎朝の定期タスクを無人で動かしています。誰も答えない場面で一度止まると、その日の作業がそこで終わります。

公式ドキュメントによると、プラグインのフックがツールの実行を止めたときは、エラーの最後に This hook comes from the <plugin> plugin. と出ます（v2.1.281以降）。急に編集が止まるようになったら、この行でどのプラグインかを確かめられます。

チームで使うときは、リポジトリの設定に書くだけでは全員の端末に入らない点に注意します。手順4のとおり、各メンバーが一度インストールする必要があります。そのほか、困りごとの全体はClaude Codeのエラー・困りごと一覧から引けます。

プラグインやスキルを自社の業務に合わせて選び、棚卸しする仕組みまで整えたい方には、下のセミナーで具体的な作り方をお伝えしています。