複数のプロジェクトを横断してClaude Codeに調査や作業を頼んでいると、「サブエージェントを一度に何体まで投げていいのか」が地味に気になる場面がある。大きな調査ほどタスクを細かく分けてサブエージェントに振りたくなるが、これまでは総数の上限を気にして分割・統合の設計をする必要があった。2026年8月4日リリースのClaude Code v2.1.221で、このあたりの仕様がまとまって変わったので、実務目線で整理しておく。
何が変わったか
まず、サブエージェントの総数に設定されていた「200体」という上限が撤廃された。代わりに導入されたのが「同時に並列実行できるのは最大20体まで」という制限だ。つまり、投げられるタスクの総数そのものには上限がなくなり、代わりに同時実行数（スループット）で調整される方式に切り替わったことになる。
加えて、少し遅れて2026年8月12日のv2.1.229で、ネストされたサブエージェント（サブエージェントがさらに別のサブエージェントを呼び出す構成）が、深さ3階層までサポートされるようになった。「親→子→孫」の3段階の委譲が正式に扱えるということだ。
なぜこの変更が効くのか
この変更の核心は、「投げるタスクの数」と「同時に走る数」が切り離された点にある。以前の200体上限は、大きなプロジェクトで細かいタスクを大量にサブエージェントへ振ろうとすると、どこかで頭打ちになる可能性を意味していた。今回の変更後は、投げる総数を気にする必要がなくなり、「同時に走るのは最大20体まで」という待ち行列で吸収される設計になっている。
自分の場合、複数プロジェクトのファイルを横断して調査する作業を日常的にClaude Codeへ依頼している。以前は「これ以上いっぺんに頼むと詰まりそうだ」と自分の側で作業を小分けにしていたが、いまはまとめて投げてキュー任せにできる場面が増えた。ただし裏側で20並列という上限は生きているので、「全部同時に動いているように見えて、実際は順番にさばかれている」感覚は持っておいた方がいい。
スキル・フック・サブエージェントは別物
このアップデートを機に、混同しやすい3つの概念を整理しておく。
| 概念 | 役割 |
|---|---|
| Skills（スキル） | 特定の作業向けに用意しておく手順書・専門知識。呼び出して使う |
| Hooks（フック） | 条件を満たせば必ず発火する、決定的な処理 |
| Subagents（サブエージェント） | 親とは別のコンテキストを持つ、独立した作業単位 |
今回の変更が触っているのはあくまで3つ目、サブエージェントの「同時にいくつ走らせられるか」という運用面の制約であって、スキルやフックの仕組み自体が変わったわけではない。
実務で取り入れやすい工夫
- まとまった量のタスクを一括で依頼し、順番の処理はシステム側に任せる発想に切り替える。以前ほど「並列数を絞らないと」と身構える必要はない
- ネスト（深さ3まで）を使う場面では、階層を深くしすぎない。役割分担が本当にその深さまで必要かを一度考えてから設計する
- 「毎回必ず実行してほしい処理」はフック、「専門知識として持たせておきたいもの」はスキル、「別の文脈で並行して進めたい作業」はサブエージェント、と役割を混同しないようにする
まとめ
| 項目 | 変更前 | 変更後 |
|---|---|---|
| サブエージェント総数上限 | 200体 | 撤廃 |
| 同時並列実行数 | 明確な上限規定なし | 最大20体まで |
| ネスト対応 | 基本1階層 | 深さ3階層まで |
出典: Claude Code 公式Changelog（code.claude.com/docs/en/changelog）
普段の作業ログはブログ「クジラとAIと」に書いている。AI（Claude）が一人称で日々の失敗や気づきを綴っている日記ブログで、今回の話も別の角度からそちらで触れている。