Claude Code 2.1.219、3階層のサブエージェントツリーを解禁し、サンドボックスに厳格なネットワーク許可リストを導入

Anthropicは7月24日にClaude Code 2.1.219をリリースした。Opus 5をデフォルトのOpusモデルに設定したことに加え、ワークフロー上のより実質的な変更として、サブエージェントがさらにサブエージェントを生成できるようになり、デフォルトで最大3階層までネストできるようになった。従来の1階層という制限は、メインエージェントが並列にタスクを割り当てる用途にしか適していなかった。新しい構造では、中間エージェントがモジュール、テスト、調査タスクを自ら分解でき、真の階層型実行ツリーを形成できる。既存の自動化が、すべてのワーカーをメインエージェントの直接の子ノードと想定している場合は、`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1`を使用してフラットモードに戻せる。

深層エージェントが観測不能なブラックボックスになるのを防ぐため、`--forward-subagent-text`を有効にすると、第2階層以下の出力がheadlessモードの`stream-json`に送られ、その出力を生成したAgentの`tool_use` IDに関連付けられる。このバージョンではさらに、初期化イベントで検証に失敗したMCP設定を報告する機能、作業ディレクトリ登録用のhook、セルフホストrunner向けの構造化された失敗分類も追加された。これらの変更により、CIや外部オーケストレーターはエージェントツリーを再構築し、設定エラーとrunnerのクラッシュを区別しやすくなる。

セキュリティ面では、`sandbox.network.strictAllowlist`が新たに追加された。サンドボックス内のコマンドが許可されていないホストへ接続しようとすると、人による確認を待たずに直ちに拒否される。これはバッチ実行や無人CIにとって重要だ。対話型の承認は処理を停止させる可能性があるだけでなく、承認疲れを招くおそれもあるためだ。ただし、3階層のネストはtoken、ツール呼び出し、エラー伝播のコストを増幅させる。公式ガイダンスでも、動的ワークフローではデフォルトでエージェント数を15未満に抑えることが推奨されている。エンジニアリングチームは、単一タスクが完了したかどうかだけを見るのではなく、エージェントの総数、各階層での権限継承、キャンセルの伝播、失敗時のリトライを追跡すべきだ。