【日次ログ】Claude Code／サブエージェント深度拡大 ― 多段委任の設計が変わる

日次ログ（2026-07-28）

• 取り上げる変化： Claude Code（Anthropicのコーディングエージェントツール）のv2.1.219アップデートで、サブエージェントの入れ子（ネスト）の深さが既定で1階層から3階層に拡大された
• 一次情報： Claude Code公式changelog（https://code.claude.com/docs/en/changelog／確認日時：2026-07-28 21:08 JST）
• 今日の一言： AIに役割分担させて運用する体制では、委任の連鎖が伸びる分だけ、途中で何が起きているかを追う仕組みも一緒に見直す必要がある

リード

Claude Codeの公式changelogに、サブエージェント（AIがさらに別のAIへ作業を委任する仕組み）の入れ子構造を既定で3階層まで許可する変更が記載されていた。複数のAIに役割を分担させて日々の運用を回している実践者として、この変更は見過ごせないため、今日はこれを取り上げる。

1. 何が起きたか

Claude Code公式changelogのv2.1.219（2026年7月24日付）に、“Subagents can now spawn nested subagents up to depth 3 by default (was 1); set CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 to disable nesting” という記載を確認した。従来は「サブエージェントがさらに別のサブエージェントを呼ぶ」動作が既定では1階層までしか許可されていなかったが、この変更で既定値が3階層まで拡大された。環境変数CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1を設定すれば、従来どおり入れ子を無効化することもできる。同じアップデートには、深さ2階層以降で動くサブエージェントの出力を--forward-subagent-text設定時に表示できるようにする変更や、Claude Opus 5が既定のOpusモデルになった件も含まれていた。

2. 実務にどう影響するか

自社のAIエージェント運用への影響という観点で見ると、日々複数のAIに役割を分担させて業務を回している立場では、この変更は「委任がどこまで連鎖できるか」という設計の前提を動かすものである。従来は1階層までしか委任が伸びなかったため、委任の連鎖が誰から誰へ渡ったかを把握しやすかった。既定で3階層まで伸びるようになると、監督役から見て「誰が最終的に作業しているか」が一段階遠くなる可能性があり、--forward-subagent-textのようなトレース表示の設定を意識して有効にしておく価値が増したと考えられる。ただし、実際に3階層のネストを意図的に発生させて挙動を確認するところまでは、本記事執筆時点では行えていない（未検証）。一般的な個人事業主・小規模チームへの影響としては、Claude Codeでサブエージェントを使った自動化を組んでいる場合、意図せず委任が深く連鎖して制御が効きにくくなるのを避けたいなら、CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1で従来の挙動に固定する選択肢があることを知っておくとよい。

3. まとめ・次に見るポイント

今回はサブエージェントのネスト深度が既定で3階層に拡大された変更を取り上げた。次回以降、実際に3階層のネストを発生させた際の挙動と、--forward-subagent-textによるトレース表示の見え方を確認していきたい（未確認）。