Claude Code v2.1.172 — サブエージェントが入れ子で動くようになり、最大5階層まで分割できる

Claude Code v2.1.172では、サブエージェントが自分のサブエージェントを呼び出せるようになり、入れ子(ネスト)で最大5階層までタスクを分割できるようになりました。あわせて、Amazon Bedrockのリージョン解決が~/.awsの設定を読むようになり、モデル選択まわりの不具合もまとめて整えられています。本稿では、この版で何が変わり、どの利用形態に効くのかを、版差分のタイムラインと利用形態別の早見表で見ていきます。

このリリースで何ができるようになるか

この版の中核は、サブエージェントのネスト解禁です。これまでサブエージェントは「親エージェントから呼ばれる末端」で、その内側からさらに別のサブエージェントを起動することはできませんでした。v2.1.172では、サブエージェントが自身のサブエージェントを生成でき、最大5階層までの入れ子が公式に認められています。

調査役のサブエージェントが、配下に「コード探索」「ドキュメント突合」といった子エージェントをぶら下げる、という設計が回避策なしで組めるようになりました。深さの上限が5階層と明示されたことで、無限に増殖する心配なくオーケストレーション(複数エージェントの指揮)を設計できます。

2つ目は、Amazon Bedrock経由で使う際のリージョン解決の改善です。AWS_REGIONが未設定でも~/.awsの設定ファイルからリージョンを読み取るようになり、AWS SDKと同じ優先順位に揃いました。どこからリージョンを取得したかは/statusで確認できます。

3つ目は、モデル選択まわりの信頼性向上です。availableModelsによる制限がサブエージェントや各種モデルピッカーに正しく効くようになり、Bedrockで提供されていないモデルが/modelに出てしまう問題なども解消されました。1Mコンテキストの扱いやopusplanの挙動も合わせて整えられています。

あなたの開発フローはどう変わるか

変化の効き方は利用形態によって異なります。マルチエージェント運用を組んでいる人ほど恩恵が大きく、ローカルで単発のタスクを回すだけの使い方では体感差はほとんどありません。

マルチエージェント運用をしている場合、これまでは入れ子の制約を避けるために、ファイル経由でエージェント間をつないだり、claude -pの非対話モード(ヘッドレス実行)を別プロセスとして呼び出したりする回避策が必要でした。v2.1.172ではサブエージェントが直接子エージェントを持てるため、こうした自前の連携を挟まずに階層を組めるようになります。

企業でAmazon Bedrockを使っている場合、AWS_REGIONを明示していない環境でリージョンが解決されずにつまずく場面が減ります。~/.awsにプロファイルを置いて運用しているチームは、環境変数の二重管理から解放されます。取得元が/statusに出るため、想定と違うリージョンを参照していないかの切り分けも速くなります。

1Mコンテキストを多用している場合、使用クレジットがない状態で1Mコンテキストのセッションが永久に止まる不具合が解消され、標準のコンテキスト上限まで自動で圧縮(コンパクト)されて復帰します。ただしこれは特定条件で詰まっていた人向けの修正で、通常運用への影響は限定的です。

IDE(VS Code)で使っている場合、PowerShellのツール呼び出しが生のJSONで表示されていた問題が直り、コマンド表示と権限ダイアログが正しく出るようになりました。シェル出力からANSIエスケープ(端末制御用の特殊文字)も除去され、ログが読みやすくなります。

利用形態別の影響早見表

自分の使い方でどの程度効くかは、次の早見表で確認できます。全員が即更新すべき種類の修正ではなく、運用形態ごとに濃淡があります。

availableModelsで利用モデルを絞っている組織は、サブエージェントのモデル上書きやエージェント割り当て時のモデル選択にも制限が効くようになった点で「明確な恩恵あり」に寄ります。claude-opus-4-8のようなバージョン固有のIDで許可リストを書いていた場合、/modelからOpusや1Mコンテキストの行が消えていた問題も直っています。

主な変更点

30項目の変更があり、テーマごとにまとめると次のように読めます。各項目に「誰に効くか」を1行添えます。

新機能・改善

• サブエージェントのネスト解禁:サブエージェントが自身のサブエージェントを最大5階層まで生成できます(マルチエージェントを設計する人)。
• Bedrockのリージョン解決:AWS_REGION未設定時に~/.awsを読み、AWS SDKと同じ優先順位に揃います。取得元は/statusに表示(企業のBedrock利用者)。
• /pluginに検索バー:マーケットプレイスのプラグインを探すときに検索できます(プラグインを多用する人)。
• OTELメトリクスの拡張:claude_code.lines_of_code.countにmodel属性が追加され、モデル別に集計できます(利用状況を計測する運用者)。

性能・体感まわりでは、長い会話でのメッセージ正規化の重複処理が削られ、ツール使用の状態が変わらないときは履歴全体の変換を避けるようになりました。アイドル時のCPU使用も下がり、/goalのステータス表示が待機中に毎秒5回もターミナルを再描画しなくなっています。Chrome連携のツール読み込みは1回のまとめ呼び出しになり、Windowsの一部コンソールでは対応していないマウス追跡を無効化しました。

モデル選択まわりの信頼性修正

モデル選択に関わる修正が複数入り、availableModelsの制限が効かない問題群が中心です。

• サブエージェントのモデル上書き、エージェント割り当てのモデルピッカー、アドバイザーモデルにavailableModelsの制限が適用されるようになりました(モデルを絞る組織)。
• claude-opus-4-8のようなバージョン固有IDで許可リストを書くと、/modelからOpusとSonnetの1Mコンテキスト行が隠れていた問題を修正(同上)。
• Bedrockが提供しないモデルが/modelに並び、選ぶと無言でセッションのモデルが切り替わっていた挙動を修正(Bedrock利用者)。
• ANTHROPIC_DEFAULT_OPUS_MODELに既に1M接尾辞が含まれるとき、モデルIDに[1M][1m]と二重に付いていた問題を修正。
• プラン モードでopusplanが1Mコンテキストで動かず、opusplan[1m]の回避策も正しくOpusへ切り替わるよう修正(プランモードで1Mを使う対象ユーザー)。
• claude agentsの割り当て入力で/model候補が誤った先頭スラッシュ付きで表示され、組織で無効なモデルまで出ていた問題を修正。

セッションとエージェント表示の修正

• 1Mコンテキストをクレジットなしで使うと永久に固まる問題を修正。標準の上限まで自動で圧縮され復帰します(クレジット切れに当たった人)。
• 会話に複数の画像があると「画像を処理できず削除した」という警告が繰り返し出る問題を修正(画像を多用する人)。
• エージェント表示で、ワーカーが応答済みでも最大30秒間「Working」のスピナーが残る問題を修正。
• 入れ子のエージェントを止めた後、親のバックグラウンドサブエージェントが「active」のまま残る問題を修正(ネストを使う人)。
• サブエージェントのチャットタブを開いている間、上矢印の履歴に親エージェントのプロンプトが出ていた問題を修正。

バックグラウンド実行と権限の修正

• 事前ウォームしたワーカーに割り当てられたバックグラウンドエージェントが、別ディレクトリのプロジェクト設定(.mcp.jsonの承認や信頼)を読みうる問題を修正(セキュリティ面で重要)。
• デーモンの自動更新後、古いバージョンで開始したバックグラウンドセッションへの再接続がEAUTHで失敗する問題を修正。

権限ルールとメモリーの修正

• WebFetch(domain:*.example.com)のワイルドカードがサブドメインに一致しない問題と、Read(secrets-*/config.json)のようにパターン途中にワイルドカードを含むファイル権限ルールが起動時に拒否される問題を修正(細かな権限ルールを書く人)。
• リモートセッションでマウントしたチーム メモリー(CLAUDE_MEMORY_STORES)が見つからない問題を修正。
• スクリプトのプロンプト文字列やコメントがDate.now()やMath.random()に触れているだけで、ワークフロー検証が拒否していた問題を修正。

このほか、利用ポリシーによる拒否メッセージが新しいセッションの開始やモデル変更を促す内容に改善され、サインインしていなくても/code-reviewのultraが説明付きで表示されるようになりました。リモート操作のフッター表示は/rc activeへ短縮され、狭いターミナルでは隠れます。コンテナを保持できないリモートでは/loopの案内を止めています。/pluginのマーケットプレイス一覧でカーソルが失われる問題や、Escで戻る先が誤っていた問題も直りました。

npm install -g @anthropic-ai/claude-code
claude --version

更新後、/statusでBedrockのリージョン取得元を確認できます。

/status

サブエージェントのネスト解禁はオーケストレーション設計を何に変えるか

サブエージェントのネスト解禁は、マルチエージェント運用の設計の前提を一つ動かしたと読めます。これまで多くの解説では「サブエージェントは入れ子にできない」が前提で、親が複数の子を並列に呼ぶ「1階層のファンアウト」までが基本形でした。深い分割が必要なときは、ファイル経由の受け渡しやclaude -pでの別プロセス起動といった回避策で階層を疑似的に作るのが定石だったわけです。

v2.1.172では、サブエージェント自身が子を持てるため、「親=全体統括」「子=領域別の調査」「孫=具体的なファイル探索」といった素直な木構造をそのまま組めます。最大5階層という上限は、深すぎる入れ子で制御が効かなくなるのを避ける現実的なラインと見ることもできます。

一方で、階層を深くすればその分だけ起動するエージェントが増えるため、トークンの消費や実行時間がどの程度増えるかは設計次第です。公式には深さごとのコストや所要時間の目安は示されていないため、まずは浅い構成から試し、必要に応じて階層を足すのが扱いやすいと考えられます。サブエージェントの基本はサブエージェント完全ガイドに、並列での組み方はサブエージェントの並列実行パターンにまとめています。

版差分タイムライン(v2.1.170 → v2.1.172)

直前の版はv2.1.170で、2.1.171は欠番(changelogに存在しません)です。番号上の直前・直前の機能追加版・記事化された直前のいずれもv2.1.170を指すため、ここでは単に直前のv2.1.170との差分で並べます。

Fable 5という新モデルへの対応を入れたv2.1.170に続き、v2.1.172はマルチエージェントの組み方そのものを広げる方向の更新と読めます。直前版の詳細はClaude Code v2.1.170の変更点で確認できます。

Bedrockのリージョン解決はどう変わったか(v2.1.170 → v2.1.172)

Bedrock利用時のリージョン解決は、AWS_REGIONに依存する形から、AWS SDKと同じ優先順位に揃う形へ変わりました。下表は具体版番号での挙動の対比です。

環境変数を明示せず~/.awsのプロファイルで運用してきたチームには、設定の二重管理が減る変化です。プラグインまわりでは/pluginに検索バーが付き、マーケットプレイスのプラグイン探索が速くなりました。導入の流れはプラグインとマーケットプレイス活用ガイドにまとめています。

まとめ

Claude Code v2.1.172は、サブエージェントのネスト解禁を中核に、Bedrockのリージョン解決とモデル選択まわりの信頼性をまとめて整えた版です。マルチエージェント運用を設計している人と、環境変数を明示せずBedrockを使っている人は、更新の価値が大きい変更がそろっています。

1Mコンテキストでクレジット切れに固まっていた人や、availableModelsでモデルを絞っていてピッカーの表示がずれていた組織も、本版で摩擦が解消します。ローカルで単発のタスクを回す使い方では体感差は小さいため、手の空いたタイミングでの更新で問題ありません。Claude Code全体の使い方はClaude Code完全ガイドを参照してください。