Claude Codeの動作が遅くなる：スキル、サブエージェント、MCP、プラグインの選び方

なぜ2026年に「Claude Codeに何でも詰め込む」ことが最大の悩みになったのか？#

公式ドキュメントにさえ、「いつ何を選ぶべきか」への包括的な回答は用意されていませんでした。

この記事で紹介する1か月間の経験には、実際のプロジェクトで使った4つの仕組みがすべて含まれます。1つの複雑なタスクに使うサブエージェント群、繰り返し行う手順のための少数のスキル、ライブデータ用のMCPサーバー2つほど、そしておよそ24個のプラグインから選んだ数個です。このガイドでは、実例を選択マトリクスにまとめ、すぐ使える判断フロー、Anthropicの引用、Claudeを使い物にならなくする7つのアンチパターンを紹介します。

スキル、サブエージェント、MCP、プラグインは、1つの表でどう違うのか？#

選択マトリクス：

起業家向けに簡単なたとえで説明すると、10人の会社のCEOになったつもりで考えてください。

• CLAUDE.md — 会社の規約。いつも壁に掲げられ、全員が読み、誰も異議を唱えません。
• スキル — 社内の手順。「レビューのやり方」「リリースノートの書き方」「支払いの受け付け方」などです。
• サブエージェント — 独立したオフィスと、限定された権限リストを持つ専門家。何でもできる鍵を渡すと、従業員ではなく、もう1人のCEOが生まれます。
• MCPサーバー — 社内システム。CRM、銀行、倉庫などです。これは知識ではなく、接続です。
• プラグイン — ストアで買える既製ソリューション。手順、専門家、連携機能を1つの箱にまとめたパッケージです。

これらが互いに競合する4つの選択肢ではなく、1つのシステムを構成する4つのレイヤーだと理解すれば、「どれが優れているか」という問いはなくなります。残るのは「何をどこに置くか」です。

Claude Codeのスキルとは何か、いつインストールすべきか？#

Anthropicの公式定義：

スキルには3つのレベルがあります。

1. メタデータ。 セッションの起動時に常に読み込まれます。frontmatterに記載された名前と説明です。スキル1つにつき、起動時に約100トークンを使います。
2. 指示。 Claudeがトリガーとなるリクエストを受け取ったときだけ読み込まれます。最大5,000トークン、つまりSKILL.mdの本文です。
3. リソース。 指示が明示的に参照したときだけ読み込まれます。バンドルファイル、scripts/内のスクリプト、references/内の参考資料などです。スクリプトはbashで実行され、コード自体はコンテキストに入りません。

Anthropicはこの原則を「段階的開示」と呼んでいます。

同じ記事には、この考え方を何よりもうまく説明する比喩もあります。

スキルを使う場合：

• 何度も繰り返す標準的な手順。PRレビュー、リリースノート、スタイルガイドに沿ったコードレビューなど。
• CLAUDE.mdの節が、単なる情報から手順へと変わり、ほかのあらゆる作業の邪魔になり始めたとき。
• 複数のプロジェクトで同じ指示に一貫して従わせたいとき。

実用的な目安は、同じことを2回以上するなら、システムに任せることです。1回目は手動のプロンプトを使います。2回目には、スキル化を検討できます。

スキルを使わない場合：

• ライブデータ（データベース、API、検索、現在の株価データ）が必要なタスク。これはMCPの役割であり、スキルではありません。「現在の価格を取得する」スキルは幻覚を起こします。
• 独立したコンテキストが必要なタスク。これはサブエージェントの役割です。
• 「.envを含むコミットをブロックする」といった強制的なチェックが必要な場合は、スキルだけに頼らず、対象のコミット経路で動くフックを使います。実際にどこまで検査するかを確認し、テストしてください。フックは、ファイルの読み取り、コピー、公開のすべての経路を制限するものではありません。

事前に知っておくべき制限：

• スキル名は最大64文字で、小文字、数字、ハイフンのみ使用できます。anthropicとclaudeは予約語です。
• 説明は最大1,024文字です。一覧では、descriptionとwhen_to_useの合計が1,536文字で切り詰められます。
• SKILL.md本文は500行以下が推奨です。それを超える内容はreferences/とscripts/に移してください。
• コンテキストの自動圧縮（auto-compaction）では、有効なスキルそれぞれの先頭5,000トークンが再添付されます。全スキルの合計上限は25,000トークンです。

サブエージェントとは何か、なぜネストは5段階までなのか？#

公式ドキュメントより：

Claude Codeには、知らないうちにすでに使っている組み込みサブエージェントが3つあります。

2026年6月10日、AnthropicはClaude Code v2.1.172をリリースし、サブエージェントの公開以来続いていた制限を撤廃しました。子エージェントが、最大5段階まで自分自身のサブエージェントを起動できるようになりました。

5という数字は安全上の上限であり、最適化の目標ではありません。

YAMLオーケストレーターテンプレートを含む機能の詳しい説明は、ネストしたサブエージェントのガイドをご覧ください。

サブエージェントを使う場合：

• コードやログを調査した後、短い結論だけが必要なとき。
• 同時に並行して進められるタスク。
• 専門分野ごとの委任：バックエンド／フロントエンド／テスト／レビューなど、各エージェントが1つの機能を担当します。
• コスト管理：SonnetやOpusの代わりにHaikuサブエージェントを使います。費用を5～7分の1に抑えられます。

サブエージェントを使わない場合：

• 一度きりの単純なタスクや簡単なツール呼び出し。サブエージェントの起動にはコストがかかります。
• タスク間で状態を共有する必要がある場合。サブエージェント同士は互いのコンテキストを参照できません。関連する作業はメインスレッドに留めてください。

主なアンチパターン：

サブエージェントにOpusとすべてのツールを与えると、別のメインセッションができるだけです。ツールリストがメインエージェントと同じなら、そのサブエージェントは適切に制約されていません。

つまり、親と同じ権限を持つサブエージェントは、2人目のCEOにすぎません。意味がなく、コストもかかります。

MCPサーバーとは何か、いつClaude Codeに接続すべきか？#

公式の定義：

MCPで実際にできること：

• ClaudeをGoogle CalendarとNotionに接続して、パーソナルアシスタントを作る。
• Figmaに接続し、デザインから完成済みのWebプロジェクトをClaudeに生成させる。
• 社内チャットボットを複数のデータベースに一度に接続する。
• Blenderと3Dプリンターに接続し、モデルを作ってすぐに印刷する。

最初にインストールする人が多い、よく知られたMCPサーバー：

接続方法とインストールコマンドは、MCPカタログにまとめられています。

MCPを使う場合：

• 外部データや操作への接続全般。「データベースから行を取得する」「Jiraのチケットを読む」「Slackに投稿する」など。
• 同じサービスを複数のプロジェクトやエージェントで使う場合は、サーバーを1つにまとめると簡単です。

MCPを使わない場合：

• 静的な知識や手順。これはMCPではなくスキルの役割です。「コードレビューの進め方」はスキルです。「GitHubの最新PRを読んでレビューする」はMCPです。
• 一度きりのCLIコマンド。サーバーを設定するより、Bashを使うほうが簡単です。
• 「アーキテクチャを正しくするため」という理由だけでMCPを作ろうとするとき。それはタスクではなく、見た目の問題です。

2026年に「Claude Codeの動作がおかしい」という不満の大きな原因の1つが、MCPに関する主な落とし穴です。

MCPを一度にすべてインストールすると、LLMのコンテキストウィンドウが圧迫されます。利用可能なすべてのツールがコンテキストに読み込まれるからです。

実践的な経験則は、特定のタスクに絞った有効なMCPサーバーを2～3台以下に保つことです。紹介した多数のサーバーを使う構成では、起動が遅くなり、エラーも増えました。

MCP tool searchはClaude Code v2.1.xで追加されました。ツールはコンテキストに片端から読み込まれるのではなく、インデックス化され、必要に応じて取得されます。これにより「1つのプロジェクトに多数のMCPを入れる」コストは下がりますが、完全になくなるわけではありません。

プラグインはスキルとどう違うのか、なぜ境界が曖昧になったのか？#

公式の説明：

2026年6月のインストール数上位：

選択肢の詳しい分析は、101個から選ぶトップ10プラグインのガイドをご覧ください。

プラグインを使う場合：

• デザインやレビューなど、ワークフローの大部分をカバーする既製のコミュニティバンドル。
• 「スキル＋サブエージェント＋MCP＋フック」の構成を手作業で組み立てたくないときは、既製のものを使えます。
• 組織内への配布。管理者がチーム用マーケットプレイスを作成し、開発者は1つのプレフィックスからインストールします。

プラグインを使わない場合：

• 1つのスキルで解決できるタスクなのに、念のためという理由でMCPを5台も含むバンドルを導入するとき。それはコンテキストを無駄に散らかすだけです。
• 監査できないクローズドソースのプラグイン。自分の権限で動作するため、インストール前に中身を読んでください。
• 同じテーマのプラグインをすでに使っている場合。コンテキスト内で重複すると、問題も二重になります。

Claude Code v2.1.143以降では、インストール前にContext costとして、プラグインが各メッセージに追加するトークン数の推定値が表示されます。v2.1.145以降ではWill installフィールドが表示され、バンドルに含まれるコマンド、エージェント、スキル、フック、MCP、LSPの完全な一覧を確認できます。インストールをクリックする前に、まずこの画面を開いてください。

2026年に使える選択マトリクスはどれか？#

優先順位順の6つの質問：

1. 繰り返し行う手順、スタイル、チェックリストか？ はいなら、スキル。
2. 外部データや操作（データベース、API、Slack、GitHub、Figma）が必要か？ はいなら、MCPサーバー。
3. メインコンテキストを散らかさないよう、別のコンテキストが必要か？ はいなら、サブエージェント。
4. 特定のイベントでチェックや自動処理を行いたいか？ はいなら、対象範囲をテストしたフック。より広いアクセス制限には、権限設定や環境の隔離を使います。
5. 1～4の仕組みをまとめた既製のバンドルをワンクリックで使いたいか？ はいなら、マーケットプレイスのプラグイン。
6. データ、コンテキスト、スタイルが必要な複雑なタスクか？ その場合は組み合わせを使います。Haikuサブエージェント＋あらかじめ読み込ませたスキル＋範囲を絞ったMCPを1つ。

組み合わせの公式：

規約をあらかじめ読み込ませたスキルと、範囲を絞ったライブデータ用MCPサーバーを備えるHaikuサブエージェントは、実際に効果を発揮するパターンです。

依存関係の向きに関する主なルールは次のとおりです。

サブエージェントはMCPサーバーを使えます。MCPサーバーはサブエージェントを使えません。

つまり、MCPは常にデータと操作を担い、エージェントではありません。タスクを委任するなら、MCPがサブエージェントを呼び出すのではなく、サブエージェントがMCPを呼び出します。

ここで紹介する具体例は、SEO記事を1本60分で執筆するデジタルエージェンシーの編集エンジンです。内部には25個のサブエージェントと14段階のレビューがあり、それぞれ独自のコンテキスト、権限、編集規約のスキルを持ち、順番に実行されます。あるサブエージェントは、既製タグと過去記事のデータベースを持つMCPサーバーに接続します。メインのオーケストレーターエージェントはOpusで動き、子エージェントはHaikuで動くため、予算を抑えられます。

これは「記事工場」ではありません。速さではなく品質の深さが求められるタスクで、4つの仕組みを1つのシステムにどう組み合わせるかを示す例です。

今すぐClaude Codeから取り除くべき7つの間違いとは？#

1. 流行っているからという理由で、トップ10のプラグインをすべてインストールした。 それぞれがすべてのメッセージにトークンを追加します。/plugin listを開き、それぞれのContext costを確認してください。2週間使っていないものは削除しましょう。

2. 他人の.mcp.jsonからMCPサーバーを15台コピーした。 他人の構成は、その人のプロジェクトとタスクに合わせたものです。現在のプロジェクトで有効にするMCPは2～3台以下にしてください。余分なものは別プロジェクト用の設定に移すか、今すぐ削除してください。

3. スキルとMCPプラグインが同じ仕事をしている。 スキルが「コードレビューをする」と指示する一方で、pr-review-toolkitプラグインも独自のレビューフローを実行します。互いに優先権を奪い合い始めます。「Claude、どうして同じことを行ったり来たりするの？」という症状が出ます。解決策は、信頼できる情報源を1つにすることです。紹介した構成では、指示を自分で管理できるよう、スキルが選ばれました。

4. フックが必要なのに、強制したいルールにスキルを使っている。 スキルは提案であり、保証ではありません。「コミットに.envを含めない」という目的なら、pre-commitフックでそのコミット経路を検査できます。ステージ済みの内容や別の経路も個別にテストしてください。すべての読み取りや他の公開経路を防ぐものではなく、スキルだけでその境界を強制することもできません。

5. 親と同じ権限を持つサブエージェントを使っている。 Opusとすべてのツールを与えた結果、別のメインセッションができました。公式ドキュメントのシステムプロンプトでは、サブエージェントに限定されたツールリストと、独自の制約されたタスクを与えるよう推奨しています。そうしないと、高価なクローンにすぎません。

6. プラグインのインストール前にWill installを確認しなかった。 Claude Code v2.1.145以降では、このフィールドでバンドルの完全な内容を確認できます。「ちょっとした機能」用のプラグインに、MCPサーバー3台、サブエージェント2つ、フック5つが含まれていることもよくあります。それらがすべてコンテキスト内に入り込みます。

7. 古い.claude/commands/が、新しいスキルと重複している。 Anthropicのドキュメントには次のように書かれています。

古いcommands/フォルダーも引き続き動作しますが、現在の標準はスキルです。紹介した例では両方のフォルダーを使っていましたが、commands/を削除し、バンドルファイルとトリガーを含むスキルを残しました。

Claude Codeが「散らかっている」兆候：

• すべてのメッセージで、利用可能なツールが200行以上にわたって表示される。
• 簡単なタスクに、1か月前より時間がかかる。
• Claudeが似た2つのスキルやプラグインを混同する。
• セッション開始時に名前の衝突に関する警告が出る。
• 必要だったMCP Bではなく、スキルAなど、Claudeが間違ったツールを呼び出す。

これらの症状が2つ以上当てはまる場合は、今すぐ/plugin listと/skill listを開いてください。まず2週間使っていないものを削除します。次に各項目のContext costを確認します。その後、上記のアンチパターンに対処してください。

コンテキストを使い切らずに、スキルとMCPをいくつ残せるか？#

Claude Codeで直接確認できる内容：

• /skill list — 有効なスキルの一覧とトークンサイズ。
• /plugin list — プラグインの一覧とContext cost。
• /mcp list — MCPサーバーとそのツール数。

実数で見るトークン予算：

コンテキストウィンドウは作業空間の上限であり、どのタスクでもその量のトークンを消費するわけではありません。同じ成果について、実測の入力、キャッシュ入力、出力、繰り返したターンを比較してください。隔離によって親のコンテキストを小さく保てても、サブエージェント側では利用量が発生します。

Anthropicは技術ブログで、スキルの自動圧縮に関する数値を示しています。有効なスキルそれぞれの先頭5,000トークンが再添付され、全体の上限は25,000です。つまり、「重い」スキルを一度に5個より多く有効にすると、Claudeは一部の指示を失い始めます。

実用的な簡単ルール：

• スキル： 現在のプロジェクトでは有効なものを5～7個までにしてください。残りは~/.claude/skills/disabled/に置き、必要になったら戻せます。
• MCP： 1つのプロジェクトにつき2～3台までにしてください。ドキュメント用のContext7は、ほとんどの場合、導入する価値があります。それ以外はタスクに応じて使い分けてください。
• プラグイン： 必ず1つずつインストールし、2週間後に使ったか確認してください。使っていなければ削除します。

Anthropicの2026 Agentic Coding Trends Reportと、開発者の80%がClaudeにタスクを完全委任できない理由について詳しく分析した記事は、別のガイドにあります。そのレポートの主な数値は、開発者は仕事の60%にAIを使う一方、タスクを完全に委任する割合は0～20%にとどまるというものです。主な理由は、コンテキストの過負荷とツールに対する制御の喪失です。

初心者はどこから始めるべきか：最小限の実用的なセットアップ#

2週間作業した後の最小構成：

1. ルートにプロジェクトのルールを記載したCLAUDE.mdを置きます。
2. Claude Code以外のツールでも作業する予定なら、互換性のためにAGENTS.mdを用意します。詳しくは「Claude Code、Codex、Cursorで使う1つの指示ファイルの作り方」をご覧ください。
3. 主な繰り返しタスク向けにスキルを1つ用意します。たとえば、スタイルガイドに沿ったcode-reviewから始めてください。
4. 最新ドキュメントを参照するためにMCPサーバーを1台使います。Context7がその候補です。これがないとClaudeは実在しないAPIを今でも幻覚します。
5. 最初の1か月はプラグイン0個、サブエージェント0個にします。これはお金を節約するためではなく、制御するためです。基本を理解するまでは、バンドルに混乱させられます。

そこからはタスクに合わせてください。繰り返す手順が出てきたら、スキルにします。特定のサービスのライブデータが必要なら、MCPを追加します。大きなタスクがメインコンテキストを埋め始めたら、サブエージェントに任せます。

これが3段階の全体像です。まずはコンテキストを整え、次に2回以上行う作業をシステムに任せ、最後にシステムが独断で間違いを犯さないよう、自動チェックを追加します。前の段階が機能してから、次の段階を追加してください。