並列の蛇口を既定で締める──Claude Code v2.1.217が子エージェントに入れた「20体・入れ子オフ・予算の網」

Anthropic は7月21日、コーディングエージェント「Claude Code」のバージョン 2.1.217 を公開しました。目玉は華やかな新機能ではなく、並列で走るサブエージェント（子エージェント）の「既定値」を安全側へ寄せる調整です。1つの指示から子エージェントが無制限に枝分かれするのを止め、入れ子を既定でオフにし、コスト上限をバックグラウンドの子にも効かせる——自律の幅を広げてきた同ツールが、その幅の初期設定を締め直した更新と言えます。

一度に走る子エージェントに、20という天井

まず追加されたのが、同時に実行する子エージェントの数を既定で20体に制限する仕組みです。環境変数 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS で変更できます。公式チェンジログには「1つのメッセージがバックグラウンドの子エージェントを無制限に増やせないように」と目的が明記されています。

Claude Code はこれまで、1回の指示から多数の子エージェントを並行起動できました。速度は上がる一方、同時に走る数が読めなければ、API の課金もマシン負荷も読めません。まず「同時実行数」に上限を設けることで、瞬間的な暴走を止める狙いです。

入れ子は「既定でオン」から「既定でオフ」へ

もう一つの変更は、方向性が逆です。子エージェントがさらに孫エージェントを産む「入れ子」を、既定で無効にしました。深い入れ子を使いたい場合は CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH を明示的に設定する必要があります。

入れ子は以前のバージョン（v2.1.172）で最大5階層まで解禁され、複雑な分業を組めるようになった機能でした。それが今回、既定ではオフに戻った形です。負担の所在が「暴走をオプトアウトで止める」から「深い並列をオプトインで許す」へ移った、と読めます。

予算の網から漏れていた「バックグラウンドの子」

3点目は不具合修正です。実行コストの上限を決める --max-budget-usd が、バックグラウンドで動く子エージェントには効いていなかった問題を修正しました。上限に達すると新規の起動を拒否し、走っている子も停止します。無人運用や CI で動かす場合、コスト上限が一部の実行をすり抜けていたのは看過しにくい穴でした。

既存の「セッションあたり200体」（v2.1.212）や動的ワークフローの規模調整と合わせると、Claude Code は総数・同時実行・深さ・金額の複数の層で並列を抑える設計に近づいています。

つまみは増えたが、どれを回すかは見えにくい

もっとも、既定を絞ることは万能ではありません。深い入れ子や大規模な並列を前提に組んだワークフローは、今回の更新後に環境変数の明示設定が要ります。設定を知らないまま「以前より遅い・浅い」と感じる利用者も出得ます。

加えて、制御の「つまみ」が増えるほど、どれをどう回すかの可視性が問われます。GitHub には、環境変数リファレンスにセッション単位の上限の記載が抜けているとの指摘も上がっています。選択肢が増えることと、運用者がそれを把握できることは別の課題だ、という声です。

地道な安定化も同梱

このほか v2.1.217 では、バックグラウンドセッションがシンボリックリンクを解決せず作業フォルダの外へ出られた問題の修正（セキュリティ関連）、Desktop 版で mTLS やプロキシ設定が無視される不具合の修正、切り詰めた MCP 出力がメモリに残るリークの修正、スクリーンリーダー対応の改善や絵文字ショートカット入力の追加など、地道な安定化も含まれます。

派手さはないものの、無人・並列でエージェントを走らせる現場ほど効く更新です。まずは自分の運用が既定の「20体・入れ子オフ」で足りるかを確認し、足りなければ環境変数で明示的に広げる——今回の設計は、そうした「意識してから広げる」運用を促しています。

参照: Claude Code 公式チェンジログ ／ Releasebot（Claude Code 更新履歴） ／ GitHub CHANGELOG ／ GitHub Issue #78406