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

> Claude Codeの拡張機能、コンテキスト使用量、7つの間違い、最小限の実用的なセットアップを比較し、技術的な例をそのまま保持しています。

Source: https://ailoot.ai/blog/ja/claude-code-skills-subagents-mcp-plugins/
Canonical: https://ailoot.ai/blog/ja/claude-code-skills-subagents-mcp-plugins/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-038
Revision: sha256-91ab35668c6f3cc1507a819945c18de89297405ad8d69a2f1dbd4488a9468708


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

スキルは、トリガーによって読み込まれる繰り返し利用する指示です（待機中は約100トークン）。サブエージェントは、独自の権限を持つ独立した200Kのコンテキストです。MCPは外部データやAPIに接続します。プラグインは、最初の3つをまとめた既製のバンドルです。2026年の基本構成は、規約をあらかじめ読み込ませたスキルと、ライブデータ用に範囲を絞ったMCPを1つ備えるHaikuサブエージェントです。それ以外は、幻覚を起こすか、コンテキストを埋め尽くします。

</div>



<div class="aside" data-semantic="ailoot-docs-link" aria-label="Ailoot documentation">

Ailootの使い方については、[ドキュメント](https://ailoot.ai/docs/)をご覧ください。

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

2026年6月までに、Claude Codeにはスキル、サブエージェント、MCP、プラグインの4つの拡張機能が揃いました。公式レジストリには101個のプラグインがあり、コミュニティのカタログには何千個もあります。何でもインストールしたくなる誘惑に負けると、Claudeの動作が遅くなり、似た機能を混同し、メッセージのたびに使用制限を消費します。読者が知りたいのは、エージェントをガラクタ置き場にせず、タスクごとにどの仕組みを使うべきかということです。

</div>

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

4つの仕組みは、1つのアーキテクチャを構成する4つのレイヤーです。スキルはClaudeに手順を教えます。サブエージェントはタスクを別のコンテキストに隔離します。MCPは外部データに接続します。プラグインは最初の3つを1つのパッケージにまとめます。それぞれに適したタスク、トークン使用量、コンテキストを散らかすリスクがあります。間違ったレイヤーを選んだときにだけ、問題が起きます。

</div>

選択マトリクス：

| 特性 | スキル | サブエージェント | MCPサーバー | プラグイン |
|----|----|----|----|----|
| 独立したコンテキスト | いいえ | **はい**（新規200K） | いいえ | 独自のサブエージェントを通じて |
| 外部データとAPI | いいえ | 割り当てられたMCPを通じてのみ | **はい** | 独自のMCPサーバーを通じて |
| トークン節約 | 70～90%（段階的開示） | 複雑なタスクで最大70% | ツール検索による | バンドルの内容による |
| ツールの制限 | `allowed-tools`を通じて | frontmatterで厳密に指定 | サブエージェントまたはポリシーを通じて | バンドルの一部 |
| より安価なモデルを選ぶ | `model`フィールドを通じて | **はい**、frontmatterで指定 | 該当なし | 独自のサブエージェントを通じて |
| セットアップ時間 | 数分 | 数分 | 数時間から数日 | マーケットプレイスからワンクリック |
| 主な用途 | チェックリスト、規約、スタイル | ノイズの多い出力を伴う委任タスク | データベース、API、ライブデータ | すぐ使えるコミュニティのワークフロー |
| 主な落とし穴 | 500行を超える肥大化したSKILL.md | 親と同レベルの権限を持つサブエージェント | 3台を超えるMCPサーバー | 中身を読まずに使うバンドル |

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

スキルとは、`SKILL.md`ファイル（YAML frontmatterとMarkdownの指示）を含むフォルダーです。`~/.claude/skills/<name>/`またはプロジェクト内の`.claude/skills/<name>/`に配置します。段階的開示の仕組みで動作します。起動時には名前と説明だけが読み込まれ（約100トークン）、タスクがトリガーに一致したときに限り、本文全体が読み込まれます。待機中のコストは、4つの仕組みの中で最も低くなります。

</div>

Anthropicの公式定義：

<figure>
<blockquote>
<p>スキルは、Claudeにドメインの専門知識を与える再利用可能なファイルリソースです。ワークフロー、コンテキスト、ベストプラクティスによって、汎用エージェントを専門家に変えます。</p>
</blockquote>
<figcaption>— Anthropic Docs, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview</figcaption>
</figure>

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

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

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

<figure>
<blockquote>
<p>段階的開示は、Agent Skillsの柔軟性と拡張性を支える基本的な設計原則です。</p>
</blockquote>
<figcaption>— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills</figcaption>
</figure>

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

<figure>
<blockquote>
<p>エージェント向けのスキルを作るのは、新入社員のためのオンボーディングガイドを書くようなものです。</p>
</blockquote>
<figcaption>— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills</figcaption>
</figure>

**スキルを使う場合：**

- 何度も繰り返す標準的な手順。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段階までなのか？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

サブエージェントとは、独自の200Kトークンのコンテキスト、システムプロンプト、限定されたツールリスト、独立した権限を持つ、子Claudeです。主な目的は隔離です。ノイズの多い検索結果、長いログ、探索的な作業をサブエージェント内に留め、最終的な要約だけをメインコンテキストに返します。2026年6月10日以降、サブエージェントは最大5段階までネストできます。

</div>

公式ドキュメントより：

<figure>
<blockquote>
<p>サブエージェントは、特定の種類のタスクを担当する専門AIアシスタントです。検索結果、ログ、参照しないファイルの内容でメインの会話が埋まりそうな補助タスクには、サブエージェントを使います。サブエージェントは独自のコンテキスト内で作業し、要約だけを返します。</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/sub-agents</figcaption>
</figure>

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

| サブエージェント | モデル | アクセス | 動作する場所 |
|----|----|----|----|
| **Explore** | Haiku | 読み取り専用 | コード検索。CLAUDE.mdとgit statusを省略してコンテキストを節約 |
| **Plan** | Haiku | 読み取り専用 | Planモード。コードを書く前に考える |
| **General-purpose** | Sonnet/Opus | すべてのツール | 複雑な複数ステップのタスク |

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

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

YAMLオーケストレーターテンプレートを含む機能の詳しい説明は、[ネストしたサブエージェントのガイド](https://ailoot.ai/blog/ja/claude-code-nested-subagents/)をご覧ください。

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

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

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

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

主なアンチパターン：

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

MCP（Model Context Protocol）は、AIをデータベース、API、ファイルシステム、SaaSなどの外部システムに接続する、Anthropic発のオープン標準です。2026年6月までに、Claude、ChatGPT、Cursor、VS Codeなど、数十のクライアントが対応しています。modelcontextprotocol.ioは、MCPをAIアプリケーション向けのUSB-Cポートにたとえています。

</div>

公式の定義：

<figure>
<blockquote>
<p>MCPはAIアプリケーション向けのUSB-Cポートだと考えてください。USB-Cが電子機器の接続方法を標準化したように、MCPはAIアプリケーションを外部システムに接続する標準的な方法を提供します。</p>
</blockquote>
<figcaption>— modelcontextprotocol.io, https://modelcontextprotocol.io/introduction</figcaption>
</figure>

MCPで実際にできること：

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

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

| MCPサーバー | 接続するもの | 入手先 |
|----|----|----|
| **Context7** | あらゆるライブラリの最新ドキュメント | claude-plugins-officialのプラグイン |
| **GitHub** | Issue、PR、リポジトリ | claude-plugins-official |
| **Filesystem** | 許可されたフォルダー内のファイル（Claude Codeでは作業フォルダーのみ） | リファレンスMCPプロジェクトサーバー、リポジトリmodelcontextprotocol/servers |
| **Postgres** | データベースへの直接アクセス | リファレンスサーバーは提供終了。後継として現在使われているのはBytebaseのDBHub |
| **Magic MCP by 21st.dev** | アニメーションとUIコンポーネント | MCPカタログ |
| **Slack / Linear / Jira / Notion** | 職場向け連携機能 | claude-plugins-official |

接続方法とインストールコマンドは、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を入れる」コストは下がりますが、完全になくなるわけではありません。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

プラグインは、パッケージ化されたバンドルです。スキル、サブエージェント、MCPサーバー、フックを任意の組み合わせで含められます。Anthropicはすべてを1つの形式にまとめ、`/plugin install`コマンド1つでインストールし、自動更新できるようにしました。`claude-plugins-official`マーケットプレイスは2026年2月に公開され、6月までにプラグインは101個に達しました。「単独のスキル」と「スキル1つで構成されたプラグイン」の違いは、パッケージ化の方法だけです。

</div>

公式の説明：

<figure>
<blockquote>
<p>プラグインは、スキル、エージェント、フック、MCPサーバーによってClaude Codeを拡張します。プラグインマーケットプレイスは、これらの拡張機能を自分で組み立てずに見つけてインストールするためのカタログです。アプリストアに接続するようなものだと考えてください。ストアを追加するとコレクションにアクセスできますが、どのアプリをダウンロードするかは自分で決めます。</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/discover-plugins</figcaption>
</figure>

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

| 順位 | プラグイン | インストール数 | 内容 |
|----|----|----|----|
| 1 | **Frontend Design** (Anthropic) | 829 316 | デザイン用スキルとサブエージェント |
| 2 | **Context7** (Upstash) | 348 660 | ドキュメント用MCPラッパー |
| 3 | **Code Review** (Anthropic) | 347 221 | レビュー用の並列サブエージェント5つ |
| 4 | **Code Simplifier** | 284 632 | 簡素化用スキルとフック |
| 5 | **TypeScript LSP** | 177 136 | LSPプラグイン |
| 6 | **Pyright LSP** | 91 225 | LSPプラグイン |

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

**プラグインを使う場合：**

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

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

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

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



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

このガイドの中心となるのは、6つの質問からなる判断フローです。上から順に進み、最初に当てはまる回答で止めてください。このアルゴリズムで、タスクの95%に対応できます。残りの5%は、Haikuサブエージェント、規約をあらかじめ読み込ませたスキル、範囲を絞ったライブデータ用MCPサーバーを組み合わせる必要がある複雑なシナリオです。これが効果を発揮する「2026年の基本構成」です。

</div>

優先順位順の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つの間違いとは？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

ここで取り上げるのは、記事で説明した主な間違い7つです。どれも回答の質を下げ、トークンを消費します。修正にかかる時間はそれぞれ5～15分です。先月プラグインを10個以上インストールしたなら、少なくとも3つは当てはまる可能性が非常に高いでしょう。

</div>

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のドキュメントには次のように書かれています。

<figure>
<blockquote>
<p>カスタムコマンドはスキルに統合されました。ファイル<code>.claude/commands/deploy.md</code>とスキル<code>.claude/skills/deploy/SKILL.md</code>は、どちらも<code>/deploy</code>を作成し、同じように動作します。</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/skills</figcaption>
</figure>

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

厳密な上限はありませんが、実用上の目安はあります。有効なスキルは10～12個までにしてください。それ以上では、Anthropicのメタ上限によって、自動圧縮の際に各スキルの内容が削られ始めます。1つのプロジェクトで有効にするMCPサーバーは、2～3台以下にしてください。プラグインは、各メッセージあたりのContext costが1,000トークン未満の場合にのみ使ってください。これらの目安は理論ではなく実践に基づいています。

</div>

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

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

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

| 仕組み | 待機中のコスト | トリガー時のコスト | コンテキストの容量 |
|----|----|----|----|
| **スキル** | 約100トークン（メタデータのみ） | 読み込んだ指示と実際に参照した資料 | 呼び出し元のコンテキストを使用 |
| **サブエージェント** | 約50トークン（名前と説明） | 実際の入力、出力、ツールの結果、繰り返すターン | 独立したウィンドウ。200Kという例は容量であり、委任ごとの消費量ではない |
| **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%にとどまるというものです。主な理由は、コンテキストの過負荷とツールに対する制御の喪失です。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

重要なポイント

何を選べばよいかわからない段階なら、ここに挙げたものは何もインストールしないでください。まず基盤を作ります。`CLAUDE.md`、プロジェクトコンテキストをまとめた別フォルダー、そしてタスクの基本構成です。Claude Codeだけで2週間、実際のタスクに取り組んでください。その後、繰り返し行う手順（それがスキル）、不足しているライブデータ（それがMCP）、コンテキストを埋め始めたタスク（それがサブエージェント）が明らかになります。

</div>

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

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

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

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

<div class="section" role="doc-bibliography" aria-label="Sources">

### 出典

- [Agent Skills Overview - Anthropic Docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
- [Skills - Claude Code Docs](https://code.claude.com/docs/en/skills)
- [Subagents - Claude Code Docs](https://code.claude.com/docs/en/sub-agents)
- [Plugins - Claude Code Docs](https://code.claude.com/docs/en/discover-plugins)
- [Equipping Agents for the Real World with Agent Skills - Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
- [MCP Introduction - modelcontextprotocol.io](https://modelcontextprotocol.io/introduction)
- [GitHub anthropics/skills - open repository](https://github.com/anthropics/skills)
- [Anthropic 2026 Agentic Coding Trends Report](https://resources.anthropic.com/2026-agentic-coding-trends-report)

</div>







<div class="aside" data-semantic="ailoot-link" aria-label="Ailoot">

[Ailoot](https://ailoot.ai/)について、さらに詳しくご覧ください。

</div>

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

### サブエージェントへの委任では、必ず200Kトークンを消費しますか？

いいえ。コンテキストウィンドウは容量を表します。利用量は、実際に処理した入力と出力、ツールの結果、追加のターンで決まります。最大容量を委任1回の固定料金と考えず、キャッシュ入力を含む実測の総利用量を比較してください。

### スキル、MCPサーバー、サブエージェントはどう使い分けますか？

繰り返す手順にはスキル、外部システムへのアクセスにはMCP、作業の詳細でメインの会話が埋まりそうな範囲の決まったタスクにはサブエージェントを使います。プラグインはこれらをまとめたものなので、インストール前に内容を確認しましょう。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。