Claude Code v2.1.217 — サブエージェントの同時実行に上限を設け、際限ない並列を抑えた版

Claude Code v2.1.217は、1つのメッセージから際限なくサブエージェントが枝分かれして走るのを防ぐため、同時実行の数に既定20の上限を設けた版です。あわせて、サブエージェントが入れ子でさらに子を起動する動きを既定で止め、--max-budget-usd の上限に達したら背景で走るエージェントも停止するようになりました。並列でエージェントを多用する運用ほど効き、単発の対話利用では体感は小さめです。番号上の直前はv2.1.216(欠番なし)で、サンドボックスの分離を層ごとに選べる設定などが入った版でした。その1つ前のv2.1.215では /verify と /code-review が自動起動をやめ、手動での呼び出しに変わっています。本版は現時点の最新です。この記事では、利用形態別の影響早見表と、サブエージェントの統治がこの数版でどう変わってきたかの時系列を添えて、更新の判断材料を示します。

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

この版で押さえたい変化は3つあります。サブエージェントの同時実行に既定の上限がついたこと、トランスクリプトの保存が静かに失敗しなくなったこと、そしてClaude DesktopとWindowsまわりの企業向けの不具合が直ったことです。芯にあるのは1つ目の並列統治で、1つのメッセージから背景のエージェントが無制限に増えていくのを、既定の設定で抑えられるようになりました。

1つ目は、並列実行の歯止めです。同時に走るサブエージェントの数に既定20の上限がつき、CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS で変更できます。さらに、サブエージェントが入れ子でさらに子エージェントを起動する動きは既定で無効になり、深い入れ子を許すには CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH を設定します。--max-budget-usd の扱いも変わりました。上限に達すると新しい起動を断るだけでなく、すでに背景で走っているエージェントも止まります。

2つ目は、トランスクリプトの安全側の作りです。ディスク不足などで書き込みが失敗しているとき、あるいは引き継いだ環境変数のせいでセッションの保存が切れているときに、警告が出るようになりました。これまでは記録が表に出ないまま失われる余地がありました。加えて、壊れた添付エントリを含むトランスクリプトで --resume・--continue や /resume がTypeErrorで落ちる問題も直っています。

3つ目は、Claude DesktopとWindowsの信頼性です。企業ネットワークのmTLS・TLS検証・OAuthスコープ・プロキシの設定が、Claude Desktopのセッションで無視されていた問題が直りました。Windowsの自動更新が失敗して claude.exe が消えることがあった問題も対象で、失敗した更新は保全しておいた実行ファイルを自動で戻すようになっています。

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

本版の効き方は利用形態でかなり分かれます。サブエージェントを並列で多用する運用や、支出上限をつけて無人で回す運用では手応えが大きく出ます。Claude Desktopや企業ネットワーク越しの利用は使っている設定しだい、Windowsでの常用にも効きます。一方、ローカルで短い対話を回すだけならほとんど変化を感じません。

並列でサブエージェントを多用する運用

この使い方に本版がいちばん効きます。1つの指示が多数の背景エージェントに枝分かれする構成では、これまで同時実行の数に歯止めがなく、走る本数が読めませんでした。既定20の同時上限と、入れ子起動を既定で止めた変更で、1回のメッセージから広がる範囲が上限で区切られます。必要なら CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS で本数を、CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH で入れ子の段数を調整できます。

支出上限をつけて無人で回す運用

--max-budget-usd で費用の上限を切って無人で走らせている場合、これまで上限に達しても背景のサブエージェントは走り続けることがありました。本版では、上限に達すると新しい起動を断り、動いている背景エージェントも止めます。費用の頭打ちが、前面のやり取りだけでなく背景の並列処理にも一律にかかります。人が張り付かない経路で費用を管理する運用ほど、この変更が効いてきます。

トランスクリプトや再開に頼る運用

セッションの記録を残し、あとで --resume・--continue や /resume で再開する使い方では、表に出ないデータ喪失と再開時のクラッシュが手当てされました。ディスクが埋まって書き込みが失敗しているときや、引き継いだ環境変数でセッション保存が切れているときには警告が出ます。壊れた添付エントリを含むトランスクリプトで再開がTypeErrorで落ちる問題も直りました。記録が半端でも、再開そのものは通ります。

Claude Desktopや企業ネットワーク越しの運用

mTLS・TLS検証・OAuthスコープ・プロキシといった企業ネットワークの設定が、Claude Desktopのセッションで無視されていた問題が直りました。社内の証明書やプロキシを前提に運用している環境では、これまで設定が効かず接続や検証で詰まる余地がありました。管理された観測基盤を使う場合も、OTEL_EXPORTER_OTLP_ENDPOINT を管理設定で指定したのに一部の信号だけ別のエンドポイントへそれる問題が塞がれました。テレメトリは指定先へ揃うようになっています。

Windowsで常用する運用

Windowsでは、自動更新の失敗で claude.exe が消えることがあった問題が直り、失敗時は保全しておいた実行ファイルを自動で戻します。セッションを背景に送った後(/background または ←)や、負荷の高いマシンでセッションが終了したときに、背景シェルが止められなくなる問題も対象です。この停止不能はWindowsで最も出やすいものでした。

利用形態別の影響早見表

主な変更点

本版は修正が中心で、機能面の芯はサブエージェントの並列統治です。あわせて起動時の安定性、モデルまわり、UIの細部が直りました。性質で分けると次のようになります。効き先が読み取りにくい項目にだけ、誰に効くかを添えます。

サブエージェントの並列統治

• 同時に走るサブエージェントの数に上限を追加(既定20、CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS で変更)。1つのメッセージが背景エージェントを無制限に増やせないようにする
• サブエージェントが入れ子でさらにサブエージェントを起動する動きを既定で無効化。深い入れ子は CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH の設定で許可する
• --max-budget-usd が背景のサブエージェントを止めていなかった問題を修正。上限に達すると新しい起動を断り、走っている背景エージェントも停止する

トランスクリプトとデータ保全

• トランスクリプトの書き込みが失敗しているとき(ディスク不足など)や、引き継いだ環境変数でセッション保存が切れているときに警告を出すよう変更。従来は記録が表に出ないまま失われる余地があった
• 壊れた添付エントリを含むトランスクリプトで --resume・--continue や /resume がTypeErrorで失敗する問題を修正
• 起動中の背景セッションへ接続するとき、トランスクリプトのプレビューが入力欄に密着していた表示を修正。稼働中のレイアウトと同じ1行の余白を空け、セッションが前面に移ってもトランスクリプトがずれないようにした

メモリと起動の安定性

• 切り詰められたMCPツールの出力が、切り詰め前の全文をセッション終了までメモリに保持していたメモリリークを修正
• CLAUDE.md や SKILL.md の paths frontmatterに多数のブレース展開を含む値があると、起動時にCLIがOOMで落ちる、または固まる問題を修正。ブレース展開に予算の上限を設けた

モデルとコンテキスト

• Bedrock上のClaude Opus 4.8で自動コンパクトが一度も起きず、上限を超えると /compact も失敗する問題を修正 — Bedrock経由でOpus 4.8を使う場合に効きます

分離とセキュリティ境界

• 背景セッションの分離が、シンボリックリンクの作業ディレクトリを実体パスへ正規化していなかった問題を修正。セッションがワークスペースのフォルダの外へ出られる余地があった — 分離を前提に並列で走らせる運用に効きます

Claude Desktop・Windows・企業ネットワーク

• 企業ネットワークのmTLS・TLS検証・OAuthスコープ・プロキシの設定が、Claude Desktopのセッションで無視される問題を修正
• Windowsの自動更新の失敗で claude.exe が消えることがあった問題を修正。失敗した更新は保全しておいた実行ファイルを自動で戻す
• セッションを背景へ送った後(/background または ←)や、負荷の高いマシンでセッションが終了したときに、背景シェルが止められなくなる問題を修正(Windowsで最も出やすい)

テレメトリと観測性

• OTEL_EXPORTER_OTLP_ENDPOINT を管理設定で指定しても、すべての信号に効かない問題を修正。より狭い範囲の信号ごとの上書きが、管理エンドポイントから離れた先へテレメトリを向けないようにした

アクセシビリティ

• スクリーンリーダーモードの起動時アナウンスが最初のプロンプト描画で途切れる問題と、思考中のステータス行が経過時間やトークン数の更新のたびに数秒ごとに再描画される問題を修正

操作性・UI

• プロンプト入力に絵文字ショートコードの補完を追加。:heart: と打つと ❤️ が入り、:hea の途中で候補が出る。emojiCompletionEnabled 設定で無効化できる
• Remote Controlのセッションで、権限プロンプトやダイアログが出た後に接続した閲覧者に、その保留中の表示が見えない問題を修正
• フッターのPRバッジのリンクを、端末の対応が検出できないとき(ssh/tmux越しなど)でもクリックできるハイパーリンクに改善。FORCE_HYPERLINK=0 で無効化できる
• ログイン失効の警告を、失効の5日前ではなく3日前に出すよう変更
• frontend-designプラグインの提案ヒントを、無期限に繰り返すのではなく生涯3回までの表示に制限

更新は claude update で取得できます。

claude update
claude --version

サブエージェントの並列実行は「解禁」から「既定で制御」へ変わった

サブエージェントの並列は、この数版で「広く走らせる」側から「既定で区切る」側へ重心を移してきました。本版の同時実行上限は、その流れのなかにあります。時系列で並べると、背景で走らせる前提が整った後に、走る量を抑える仕組みが順に足されてきたのが見えます。

v2.1.212が入れたのはセッション全体を通した起動回数の予算で、走る「総数」に上限をかけるものでした。本版が足したのは、ある瞬間に同時に走る「本数」の上限です。総量の予算と、瞬間の並列度という別々の軸に、それぞれ既定の歯止めがつきました。入れ子起動を既定で止めた点も同じ方向で、明示的に許可しない限りエージェントは自分の子を増やせません。

この一連の変更は、費用と暴走の両方を既定側で抑える設計です。背景実行を既定にして並列を後押しした版から、その並列に上限をかける版へ、揺り戻しではなく積み増しで進んでいます。単発の対話利用では表に出にくい領域ですが、1回の指示が多数のエージェントに枝分かれする使い方なら、想定外の本数や費用に振り回される余地が一段狭まりました。

まとめ

本版は、サブエージェントの同時実行に既定20の上限を設け、入れ子の起動を既定で止め、--max-budget-usd が背景のエージェントも停止するようにした版です。1回の指示から多数のエージェントを並列で走らせる運用や、費用の上限を切って無人で回す運用では、更新する価値が見込めます。あわせて、表に出ないまま失われていたトランスクリプトに警告が出るようになり、壊れた添付での再開クラッシュも直りました。Claude Desktopで企業ネットワークの設定が効かない問題や、Windowsの自動更新で claude.exe が消える問題も対象です。

Claude Desktopや企業ネットワーク越しの利用は、mTLSやプロキシなどの設定を使う構成でだけ効きます。一方、ローカルで短い対話が中心なら、体感の変化はほとんどありません。本版が現時点の最新です。更新は claude update で取得でき、自分の使い方が上の早見表のどこに当たるかを見てから、更新の要否を判断できます。

関連ガイド

Claude Code全体の中での本バージョンの位置づけはClaude Code完全ガイドで確認でき、2026年7月のアップデート全体の流れは月次アップデートまとめでたどれます。