複雑な開発タスクをサブエージェントに任せても、これまでは一段階の委譲が限界でした。Claude Code 2.1.172では、サブエージェントがさらにサブエージェントを起動できるようになり、最大5階層までネストできます。

この記事でわかること

  • Claude Code 2.1.172の主な変更点
  • ネストサブエージェントが解決する課題と仕組み
  • 1Mコンテキストの自動コンパクト化など運用面の改善
  • アップデートの入手方法と活用のポイント

https://github.com/anthropics/claude-code/releases/tag/v2.1.172

2.1.172で何が変わったか

Anthropicは2026年6月10日、ターミナル向けコーディングエージェント「Claude Code」のバージョン2.1.172を公開しました。公式リリースノートには30件超のCLI変更が列挙されており、中でもサブエージェントのネスト対応と1Mコンテキストの自動コンパクト化が注目を集めています。

Claude Codeは、自然言語でコードベースを理解し、ファイル編集やGit操作を任せられるエージェント型の開発ツールです。メインエージェントがサブエージェント（副エージェント）を起動し、調査やレビューなどの部分タスクを分離して実行する仕組みを持っています。

なぜネストが必要だったか

サブエージェントは、親エージェントとは別のコンテキストウィンドウで動き、完了後に要約だけを返します。大規模なコードベースの調査や、実装とレビューを分けたい場面では、この分離がコンテキストの圧迫を抑える手段になります。

しかしv2.1.172以前は、サブエージェント側からさらにサブエージェントを起動できませんでした。実装担当のサブエージェントがレビュー用のサブエージェントを直接呼び出す、といった二段階以上の委譲はメインエージェントが一手間介在する必要がありました。複雑なワークフローほど、親のコンテキストに中間結果が溜まりやすい構造でした。

Claude Codeの開発リードであるBoris Cherny氏は、エージェントがエージェントを起動する方式でコンテキスト管理を改善する実験を進めており、深度5を上限とするネスト対応を今回のリリースに含めたと述べています。

ネストサブエージェントの仕組み

2.1.172の最大の機能追加は、サブエージェントが自身のサブエージェントを起動できる点です。ネストの深度は最大5階層に制限されています。

各階層のエージェントは独立したコンテキストで動作し、親には要約だけが返ります。たとえば「メイン → 実装担当 → コードレビュー」のように、タスクを階層的に分解できます。ターミナルでは矢印キー（下方向）でエージェントの階層をたどって監視できます。

深度5は恒久仕様ではなく、まずはこの上限で運用し、実際のワークフローでの挙動を見極める段階と位置づけられています。無制限の再帰は無限ループやコンテキストの暴走を招くため、ハーネス側で深度カウンタが働きます。

1Mコンテキストの自動コンパクト化

もう一つの実用性の高い修正は、1Mコンテキストセッションの扱いです。利用枠（usage credits）なしで1Mコンテキストを使っていたセッションが、以前は永久にスタック状態になる不具合がありました。

2.1.172では、利用枠がない場合にセッションが標準のコンテキスト上限へ自動コンパクト化され、作業を再開できるようになります。コンパクト化とは、会話履歴を要約してコンテキストを圧縮する仕組みで、Claude Codeはモデル呼び出し前に複数段階の圧縮パイプラインを走らせています。

あわせて、1Mコンテキスト関連のモデル選択バグも修正されています。ANTHROPIC_DEFAULT_OPUS_MODELに既に1Mサフィックスが付いているのに二重付与される問題、opusplan設定でプランモード時に1Mコンテキストが適用されない問題、BedrockやVertexで「Opus (1M context)」が選べない問題などが解消されています。

その他の変更と改善

AWS Bedrock利用者向けには、環境変数AWS_REGIONが未設定のときに~/.awsの設定ファイルからリージョンを読み取るようになり、AWS SDKの優先順位に合わせました。/statusでリージョンの取得元も確認できます。

/pluginでマーケットプレイスのプラグインを閲覧する際、検索バーが追加されました。長い会話でのパフォーマンス改善、サブエージェント並列実行中のCPU使用率低下、Claude in Chromeのツール読み込みのバッチ化など、体感速度に関わる改善も含まれています。

VS Code拡張では、PowerShellのツール呼び出しが生JSONではなくコマンド表示になる修正や、シェル出力のANSIエスケープ除去が入っています。

アップデート方法と活用のヒント

Claude Codeは通常、次回起動時に自動更新されます。手動で確認する場合はターミナルでclaude updateを実行します。GitHubのリリースページから各OS向けバイナリを直接ダウンロードすることもできます。

ネスト機能を活かすには、従来どおりサブエージェントに任せたいタスクへ「use subagents」と指示する方法が有効です。実装とレビューを別階層に分けたい場合、サブエージェント定義（~/.claude/agents/配下のMarkdown）で役割とツール権限を明確にしておくと、深いネストでも意図した動きを引き出しやすくなります。

一方、深度5の上限に達した階層からはこれ以上の起動は拒否されます。タスク設計では、一段階ごとに返却される要約の粒度を意識し、親コンテキストへの情報の逆流を抑えるのがポイントです。

既存ワークフローとの違い

v2.1.172以前は、多段の委譲を組むにはメインエージェントが各段階を仲介する必要がありました。2.1.172以降はサブエージェント自身が下位タスクを切り出せるため、親のコンテキストをよりクリーンに保てます。

エージェントチーム（ピア間メッセージング）とは異なり、ネストサブエージェントは「起動 → 完了待ち → 結果を受け取る」という同期的な委譲モデルです。レビュー完了を待ってから実装結果を返す、といったパターンに向いています。

Claude Code 2.1.172は、エージェント開発の実運用で求められていた多段委譲と、長文セッションの安定性を同時に手当てしたアップデートです。複雑なタスクをエージェントに任せている開発者は、早めの更新を検討する価値があります。