Claude Code v2.1.212 — 検索とサブエージェントの暴走に上限、会話を別セッションに複製
Claude Code v2.1.212は、WebSearchとサブエージェント起動にセッション単位の上限を設け、/forkを別のバックグラウンドセッションへ切り出し、プランモードが確認なしにファイルを書き換えていた問題を直した版です。
Claude Code v2.1.212は、確認を挟めないエージェント実行に上限と退避のしくみを入れつつ、長時間・無人で走らせるときの取りこぼしを広く直した版です。芯にあるのは、際限なく走りがちな自律実行に初めて天井を設けたことです。WebSearchの呼び出しとサブエージェントの起動にセッション単位の上限が付き、2分を超えたMCPツール呼び出しは自動でバックグラウンドへ退避するようになりました。あわせて /fork が作り直され、会話の複製が新しいバックグラウンドセッションとして走り、これまで /fork が担っていたセッション内のサブエージェントは /subtask に分かれます。プランモードが確認なしにファイルを書き換えていた問題など、安全性まわりの修正も入りました。効き方は使い方で大きく分かれます。直前のv2.1.211がゲートウェイの課金ずれと承認まわりを直した版だったのに対し、本版は自律実行そのものに枠をはめる方向へ寄っています。この記事では、利用形態別の影響早見表と、自律実行のガードレールがv2.1.207から本版までどう積み上がってきたかで、更新の判断材料を示します。
このリリースで何ができるようになるか
この版で押さえたい変化は、暴走しがちな自律実行に上限が付いたこと、/fork が会話ごと別のバックグラウンドセッションへ分かれること、そして過去のセッションを一覧から選んで背後で再開できることの3点です。新しく加わった能力はこの上限と退避のしくみで、残りは /fork まわりの作り直しと安全性の修正に寄っています。
1つ目は、際限なく走る経路への天井です。WebSearchの呼び出しはセッション全体で既定200回まで、サブエージェントの起動もセッションあたり既定200体までとなりました。上限はそれぞれ環境変数 CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION と CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION で調整できます。サブエージェントの残り予算は /clear で戻ります。さらに、2分を超えて走るMCPツール呼び出しは自動でバックグラウンドへ回り、セッションが専有されて操作できなくなる状態を避けます。しきい値は CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS で変えられ、無効化もできます。検索の空回りや委譲の入れ子が止まらなくなる経路に、初めて明確な上限が入りました。
2つ目は、/fork の作り直しです。これまで /fork はセッション内でサブエージェントを立てるコマンドでしたが、本版からは会話の複製を新しいバックグラウンドセッションとして走らせ、claude agents に独立した行として並びます。手元の作業を止めずに、複製した会話を背後で進められます。セッション内でサブエージェントを立てる従来の役割は /subtask に分かれました。会話にタイトルが無いときは、複製が最初のプロンプトから名付けられ、一覧で見分けやすくなります。あわせて、auto modeの設定を既定へ戻す claude auto-mode reset が加わりました。確認プロンプトが出て、--yes を付けると省略できます。
3つ目は、過去のセッションの再開です。エージェント表示で /resume と入力すると、過去のセッションを選ぶ一覧が開きます。一覧から削除したセッションもここに含まれ、選んだものはバックグラウンドセッションとして再開します。停止したバックグラウンドセッションをエージェント表示から開き直す操作も、黙って失敗するのではなく、再開するか、できない理由を示して強制再起動を選べる形に変わりました。
あなたの開発フローはどう変わるか
本版の効き方は利用形態でかなり分かれます。無人や常駐でエージェントを長く回す運用、サブエージェントを深くネストして委譲する運用、MCP経由で重いツールを呼ぶ運用では手応えが大きく、/fork を日常的に使う運用や企業ネットワーク・Windows環境では設定や環境しだい、ローカルで短い対話を回す使い方ではほとんど変化を感じません。
無人・常駐でエージェントを長時間走らせる運用
上限と退避のしくみが、いちばん効くのがこの使い方です。これまで検索や委譲が空回りを始めると、セッションが際限なくトークンを消費し続ける余地がありました。本版では、WebSearchが既定200回、サブエージェントの起動が既定200体で止まり、暴走した実行が自分でブレーキを踏みます。2分を超えるMCP呼び出しが自動で背後に回るので、重いツールが返ってこないあいだも操作を続けられます。加えて、実行中のBashツールにSIGTERMが届いたとき、print/SDKモードでコマンドのプロセス群が親を失って残っていた問題が直り、ターンを中断してプロセス群を落とし、終了コード143で抜けるようになりました。
サブエージェントを深くネストして委譲する運用
委譲を何段も重ねる構成では、サブエージェントの起動上限とトークンの節約が効きます。1つのセッションで起動できるサブエージェントは既定200体までとなり、暴走した委譲が止まります。予算は /clear で戻るため、意図して数多く回すときはクリアで区切れます。エージェント間のメッセージ送受信では、SendMessage の本文が再生履歴とツール結果に二重に積まれてトークンを浪費していた問題が直り、長い連携ほど消費が軽くなります。セッション内でひとつ作業を切り出したいときは、/fork ではなく /subtask が受け持ちます。
会話の複製(/fork)を日常的に使う運用
/fork をよく使う場合は、打ち方の見直しが要ります。従来は会話の中でサブエージェントを立てるコマンドでしたが、本版からは会話ごと新しいバックグラウンドセッションへ複製し、claude agents に別の行として現れます。手元を止めずに枝分かれした会話を進めたいときはこれが向き、セッションの中だけで小さな作業を任せたいときは /subtask に切り替えます。複製は会話のタイトルが無ければ最初のプロンプトから名付けられ、一覧で見分けやすくなります。状態の書き込みに失敗したあとに、/fork で作った背景セッションが親との結び付きを失う問題も直りました。
プランモードで確認しながら進める運用
プランモードで安全を確かめながら進める使い方では、安全側の修正が効きます。プランモードが touch や rm のようなファイルを書き換えるBashコマンドを、権限の確認もSDKの canUseTool コールバックも通さずに自動実行していた問題が直りました。あわせて、.claude/worktrees にリポジトリへコミットされたシンボリックリンクがあると、作業ツリーの作成がそれをたどってリポジトリの外にファイルを作れた問題も塞がれています。確認を前提に組み立てた手順が、勝手にファイルへ及ぶ経路が減ります。
企業ネットワークやWindowsで動かす運用
環境しだいで効く修正も入っています。WindowsでグループポリシーがWindows PowerShell 5.1を止めている場合に、/background や claude --bg が「EUNKNOWN: unknown error, uv_spawn」で失敗していた問題が直り、デーモンがPowerShell 7を優先するようになりました。ホスト管理のセッションでは、リポジトリ側の設定でmTLS証明書や追加のCAバンドル、OAuthスコープが指定されていると起動に失敗していましたが、これらの転送設定は警告を出して無視されます。企業向けの forceLoginMethod は、これまでのターミナルに加え、VS Code拡張・SDK・setup-token・install-github-app のログインにも効くようになりました。
利用形態別の影響早見表
| 利用形態 | 影響度 | 効く理由 |
|---|---|---|
| 無人・常駐でエージェントを長時間運用 | 影響度明確な恩恵あり | 効く理由検索・委譲の上限、MCPの自動退避、SIGTERMでのプロセス群の後始末 |
| サブエージェントを深くネストして委譲 | 影響度明確な恩恵あり | 効く理由起動上限と SendMessage の二重積み解消でトークンが軽くなる |
| プランモードで確認しながら進める | 影響度明確な恩恵あり | 効く理由確認なしのファイル書き換えと作業ツリーの外への書き出しを修正 |
会話の複製(/fork)を日常的に使う | 影響度条件次第 | 効く理由動作が別セッションの複製に変わり、/subtask との打ち分けが要る |
| 企業ネットワーク・Windows・ホスト管理 | 影響度条件次第 | 効く理由PowerShell 7優先や転送設定の無視など環境しだい |
| ローカルで短い対話を回す | 影響度ほぼ影響なし | 効く理由対象が自律・無人・常駐に寄っている |
主な変更点
本版は修正が中心で、新しく加わったのはセッション単位の上限と自動退避のしくみ、claude auto-mode reset、/resume の一覧です。性質で分けると次のようになります。効き先が読み取りにくい項目にだけ、誰に効くかを添えます。
自律実行の上限と退避
- WebSearchの呼び出しにセッション全体の上限を追加(既定200回、
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSIONで調整)。検索が止まらなくなる空回りを防ぐ - サブエージェントの起動にセッション単位の上限を追加(既定200体、
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSIONで調整)。委譲の暴走を止め、予算は/clearで戻る - 2分を超えるMCPツール呼び出しを自動でバックグラウンドへ移動(
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MSでしきい値の変更や無効化が可能)。重いツールでもセッションを操作し続けられる - auto modeの設定を既定へ戻す
claude auto-mode resetを追加(確認プロンプト付き、--yesで省略)
会話の複製とサブタスク、セッションの再開
/forkが会話の複製を新しいバックグラウンドセッションとして走らせるように変更。claude agentsに独立した行として並び、手元の作業を止めない- これまで
/forkが立てていたセッション内のサブエージェントを/subtaskに分離 - タイトルの無い会話では、
/forkの複製を最初のプロンプトから名付けて一覧で見分けやすく変更 - エージェント表示で
/resumeと入力すると、一覧から削除したものも含む過去のセッションを選べる一覧を表示し、選んだものをバックグラウンドで再開 - 停止したバックグラウンドセッションをエージェント表示から開き直す操作を改善。再開するか、できない理由を示して強制再起動を選べる
/forkで作った背景セッションが、状態の書き込み失敗後に親との結び付き(live-parent保護)を失う問題を修正- 素の
/btwが、直近のやり取りに対して脇の質問パネルを開き直すように変更。前の回答をたどれる - 入力待ちが無いあいだに背景エージェントが終わると、←のフッターの案内が「N done」を短く点滅させるように変更
安全性・権限まわり
- プランモードが
touchやrmなどファイルを書き換えるBashコマンドを、権限の確認もSDKのcanUseToolコールバックも通さず自動実行していた問題を修正 .claude/worktreesにコミットされたシンボリックリンクを作業ツリーの作成がたどり、リポジトリの外にファイルを作れた問題を修正continue:falseのフックによる停止が、ツールの失敗や途中完了で握りつぶされ、フック基盤のエラーがユーザーの拒否として誤って報告される問題を修正- print/SDKモードで、実行中のBashツールにSIGTERMが届くとコマンドのプロセス群が親を失って残る問題を修正。ターンを中断してプロセス群を落とし、終了コード143で抜ける
- Taskツールの
modeパラメータを非推奨化(以後は無視)。サブエージェントは既定で親セッションの権限モードを引き継ぐ - 企業向けの
forceLoginMethodを、ターミナルだけでなくVS Code拡張・SDK・setup-token・install-github-appのログインでも適用するように変更
ultrareviewまわり
/ultrareviewが#123・PR 123・貼り付けたPRのURLといった参照を受け付けなかった問題を修正。エラーの助言は実際に打ったコマンド名を示す/ultrareview <branch>が、リモートに存在するブランチをoriginから取得しない問題を修正。打ち間違いには近いブランチ名を提案する/clear後の新しい会話で/ultrareviewが課金の確認を飛ばす問題を修正- Claude Desktopでの
/ultrareviewの「not a git repository」エラーが、ターミナルのコマンドではなくプロジェクトのリポジトリフォルダを案内するように変更
バックグラウンド・エージェント表示の安定化
- WindowsでグループポリシーがWindows PowerShell 5.1を止めているとき、
/backgroundとclaude --bgが「EUNKNOWN: unknown error, uv_spawn」で失敗する問題を修正。デーモンがPowerShell 7を優先する — 企業のWindows環境で背景実行を使う運用に効きます - セッションの途中から参加したRemote Controlのクライアントで、ワークフローのエージェント一覧が空のままになる問題を修正
- ストリーミングモードの制御リクエストが、ハンドラの完了前に「完了」と扱われ、セッション再起動時に取りこぼされる問題を修正
- エージェント表示と
claude agents --jsonで、サンドボックスやMCPの入力、管理設定の確認を待つセッションを「Working」ではなく「Needs input」と表示するように変更 - 背景エージェントへの冷たい接続(cold-attach)で、セッションの起動を待つあいだ整形済みのやり取りをすぐ表示するように改善
- ホスト管理のセッションが、リポジトリ設定でmTLS証明書・追加CAバンドル・OAuthスコープを指定していると起動に失敗する問題を修正。これらの転送設定は警告を出して無視される
- print/SDKモードで
--continue/--resumeにより再開したあと、ExitWorktreeが「no active EnterWorktree session」で失敗する問題を修正 - offset/limit付きで読んだファイルを、セッション再開後に編集しようとすると出る誤った「File has not been read yet」エラーを修正
- エージェントチームで、セッション内でチームの初期化が再度走ると、停止中のチームメイトがリーダーへ重複した待機通知を送る問題を修正
入力・表示まわり
- パスの自動補完のポップアップが開いているあいだ、シェルモード(
!)がファイルパスを含むコマンドを実行しない問題を修正 - auto modeの拒否通知で、長い理由が絵文字の途中で切り詰められ文字化けする問題を修正
- 拡張キー通知に対応した端末で、エージェント表示の送信欄でCtrl+Jが改行を入れない問題を修正。
?のヘルプにも改行の操作を掲載 - プラン承認ダイアログのフッターで、パスが長いと「
ctrl+g to edit in <editor>」が分断される問題を修正 - 幅と高さを同時に変える端末サイズ変更のあと、全画面表示でウェルカムバナーが古いパネル幅を保つ問題を修正
- 狭い表示で差分プレビューが行番号と
+/-の記号を失う問題を修正 - 部分読み込みのあとに@メンションが何も添付しない問題、プラグインのアンインストールが誤ったマーケットプレイスを対象にする問題、終了コード143での誤った「Command timed out」を修正
テレメトリー・ネットワーク・キャッシュ
- OpenTelemetryのHTTPエクスポートが、チャンク転送エンコーディングを受け付けないAzure Monitorなどの宛先に411/400で拒否される問題を修正
- SDK・ヘッドレスで
TRACEPARENTが設定されているとき、OTLPのイベントログにtrace_id/span_idが欠ける問題を修正 - 画像を多く含む会話が誤って「Request too large」で失敗する問題を修正し、実際の原因を説明するエラーメッセージに改善
- Web検索とWeb取得が、APIの過負荷時に「API Error」の文字列を検索結果やページ内容として返す問題を修正
- Web検索とWeb取得の信頼性を改善し、529エラーとレート制限を上限付きのバックオフで再試行する — CIで検索を多用する運用で失敗が減ります
- プロンプトキャッシュを改善し、会話の途中のシステムブロックがLLMゲートウェイやカスタムのベースURL(Bedrock・Vertex・1P)でも効くように変更
その他
- エージェント間メッセージのトークン消費を削減。
SendMessageの本文を再生履歴とツール結果に二重に積まないように変更 - セッションのやり取りに、各アシスタントメッセージの推論の努力レベルを記録するように変更
- ヘッドレス・SDKのセッションで、ターンの途中の
set_model制御リクエストを適用するように変更。次のモデル往復から新しいモデルを使う - 認証状態パネルの見出しを「Cloud authentication」から「Authentication」に変更
- 以前のリリースノート(2.1.200)の訂正。tmuxは3.6系まで同期出力に対応せず、対応する新しいtmuxは自動で検出される
更新は claude update で取得できます。
claude update
claude --versionセッション単位の上限で、確認を挟めないエージェント実行に初めて天井ができる
本版でいちばん芯にあるのは、際限なく走りがちな自律実行に、セッション単位の天井を設けたことです。これまでのガードは「危ない操作を止める」向きが中心でしたが、本版は「同じ操作を延々と繰り返す」経路そのものに数の上限を入れました。検索の空回りも委譲の入れ子も、放っておけばトークンを食い続けます。無人で走らせるほど、この歯止めの有無が費用に直結します。
3つの上限は、それぞれ性格が違います。WebSearchはセッション全体で既定200回、サブエージェントの起動はセッションあたり既定200体で、いずれも環境変数で引き上げも引き下げもできます。MCPの重い呼び出しは、止めるのではなく2分で背後へ回し、セッションを空けます。数で止めるものと、時間で退避させるものを組み合わせた形です。
| 暴走しやすい経路 | これまで | v2.1.212 |
|---|---|---|
| WebSearchの繰り返し | これまで上限がなく走り続けられた | v2.1.212既定200回で停止(環境変数で調整) |
| サブエージェントの起動 | これまで無制限に起動できた | v2.1.212既定200体で停止、/clear で予算が戻る |
| 長いMCPツール呼び出し | これまでセッションが専有され待たされた | v2.1.2122分でバックグラウンドへ自動退避 |
既定値の200という数字は、通常の対話ではまず届かない高さに置かれています。この上限は、人が使う手を縛るためではなく、無人の実行が壊れたときの最後の歯止めとして設けられたものです。効くのは、確認を挟めない経路が事故を起こした場面に限られます。日常の対話でこの天井を感じる場面は、ほとんどありません。
自律実行のガードレールはv2.1.207から本版までどう積み上がってきたか
本版の上限は単発の思いつきではなく、自動で走らせる前提のもとで境界を段階的に締めてきた流れの続きにあります。auto modeや背景エージェント、作業ツリーの隔離が広がるほど、確認を挟めない経路での線引きが問われてきました。時系列で並べると、止め方の重ねがけが見えてきます。
| バージョン | 自律実行まわりの手当て |
|---|---|
| v2.1.207 | 自律実行まわりの手当て非対話実行で同意ダイアログなしに「同意済み」と恒久記録する問題を修正 |
| v2.1.208 | 自律実行まわりの手当て破壊的な削除コマンドのガードを、$(…) やバッククォート経由の書き方にも拡張 |
| v2.1.210 | 自律実行まわりの手当て作業ツリー隔離のgit変更漏れ、ultracode の誤発火、Agentツールの間接プロンプトインジェクションを修正・堅牢化 |
| v2.1.212 | 自律実行まわりの手当てWebSearch・サブエージェントの起動にセッション単位の上限、MCPの自動退避、プランモードの確認なし実行を修正 |
v2.1.207では、人が画面を見られない非対話実行で、同意ダイアログを経ずに管理設定を「同意済み」と恒久記録していた問題が直りました。続くv2.1.208では、破壊的な削除コマンドのガードが、削除対象をサブシェルで組み立てる書き方にも及ぶようになりました。v2.1.210は、隔離したサブエージェントがメインのチェックアウトへgit変更を漏らせた穴などをまとめて塞いでいます。ここまでは、いずれも「危ない一手を止める」方向の手当てでした。
本版はそこに、「同じ手を数えて止める」という別の軸を足しました。危険な操作を一つずつ塞ぐだけでは、無害な操作を無限に繰り返す暴走は止まりません。数と時間で枠をはめる上限は、その隙間を埋める動きにあたります。単発の対話では表に出にくい領域ですが、CIやクラウド経由でエージェントを常用するなら、この一連の版で自律実行の歯止めが一段ずつ形になってきました。
まとめ
本版は、確認を挟めない自律実行に上限と退避のしくみを入れ、/fork を作り直し、安全性まわりを広く直した版です。無人や常駐でエージェントを長く回している場合、サブエージェントを深くネストして委譲している場合、プランモードで確認しながら進めている場合は、更新する価値が見込めます。とりわけ、検索や委譲の暴走に既定200という天井が付いたことと、プランモードが確認なしにファイルを書き換えていた問題の修正は、人が張り付かない経路ほど効いてきます。
/fork を日常的に使っていた場合は、動作が会話の複製に変わり、セッション内の作業は /subtask に分かれた点を確認しておくと、打ち分けで迷いません。企業ネットワークやWindows、ホスト管理のセッションでは、PowerShell 7の優先や転送設定の無視など環境しだいの修正が効きます。一方、ローカルで短い対話が中心なら、体感の変化はほとんどありません。本版が現時点の最新です。更新は claude update で取得でき、自分の使い方が上の早見表のどこに当たるかを見てから、更新の要否を判断する形になります。
関連ガイド
Claude Code全体の中での本バージョンの位置づけはClaude Code完全ガイドで確認でき、2026年7月のアップデート全体の流れは月次アップデートまとめでたどれます。
関連する記事
Claude Code をもっと見る →Claude Codeとは — Anthropicのエージェント型AIコーディングCLI完全ガイド
Claude Code v2.1.211 — ゲートウェイの課金ずれを修正し、承認とエージェント可視化を強化
Claude Code v2.1.210 — 自動運用の信頼境界を締め直し、無人セッションの取りこぼしを修正
Claude Code v2.1.206 — MCPタイムアウト修正、/doctorがCLAUDE.md分割を提案
Claude Code v2.1.205 — 自律実行の安全策が進み、CIの取りこぼしも修正
Claude Code v2.1.202 — /reviewが単一パスに戻り、ワークフローの規模を/configで調整