Claude Code v2.1.199 — サブエージェントの無言の失敗を防ぎ、企業ネットワークと常駐運用を安定化

Claude Code v2.1.199は、修正を中心にした信頼性強化の版です。この版の24項目のうち20項目が不具合修正、4項目が挙動の調整で、新機能の追加はありません。中心にあるのは、複数のエージェントを並行して動かす運用で起きていた「無言の失敗」を減らし、企業ネットワークや一時的なエラーからの回復力を高め、常駐する背景エージェントの安定性を底上げする、という3方向の地固めです。直前のv2.1.198でサブエージェントが既定で背景実行になった(段階的な展開から既定へ移行した)直後だけに、その経路のエラー処理と信頼性を固める版と読めます。この記事では、利用形態別の早見表と背景エージェントの版差分タイムラインで、更新の判断材料を示します。

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

この版で押さえたい変化は、マルチエージェント運用での取りこぼし解消、企業ネットワークと一時エラーへの回復力、常駐する背景エージェントの安定化という3点です。いずれも新しい能力の追加ではなく、既存の運用を止めていた不具合を取り除く方向の変更です。

1つ目は、複数のサブエージェントを動かすときに結果を取りこぼさなくなった点です。これまでは、レート制限やサーバーエラーでサブエージェントが途中で止まると、そこまでの部分的な成果が親エージェントに返らず、外からは何が起きたか分からないまま処理が進むことがありました。本版では、中断されたサブエージェントが部分成果を親へ返すようになり、APIエラー(usage limit reachedなど)を成功結果として報告していた問題も、エラーとして親に伝わる形へ直っています。再び起動したエージェントが前の名前を再利用したときにSendMessageが別のエージェントへ誤ってルーティングされる問題も、不一致を検出して再指定を促すよう変わりました。あわせて、SessionStart / Setup / SubagentStartのフックがexit code 2で標準エラー出力を隠していた問題も直り、失敗の手がかりがトランスクリプトに表示されます。

2つ目は、企業ネットワークや一時的なエラーからの回復力が上がった点です。TLS検査プロキシやNODE_EXTRA_CA_CERTSの欠落、期限切れ証明書によるSSL証明書エラーは、これまでリトライを浪費してから失敗していました。この版では、こうしたエラーを即座に失敗として扱い、修正のヒントを添えて返します。使用量上限とは無関係な一時的な429は、backoff(待ち時間を段階的に延ばす仕組み)を伴う自動リトライの対象になりました。以前はサブスクリプション利用でターンごと失敗していた挙動が変わっています。部分出力のあとにストリーム途中で過負荷(overloaded)やサーバーエラーが起きても、応答を丸ごと破棄せず、部分応答を保持して不完全な応答として通知するようになりました。

3つ目は、常駐する背景エージェントの安定性です。Linuxの背景エージェントデーモン(常駐プロセス、daemon)が、壊れたワーカーレコード(内部の作業記録)を掴むと約50秒ごとに自分自身と全エージェントを強制終了してしまう問題が修正されました。macOSではSSH越しの背景エージェントのコールドスタートがCould not switch to audit sessionで失敗する回帰(regression)が直り、これはv2.1.196で入り込んだ不具合の回収にあたります。claude stopが自動再起動(respawn)と競合して無言で取り消される問題も、再起動がstopを尊重する形へ修正されました。メモリの少ないマシンで背景セッションが汎用的なエラーを返していた挙動は、低メモリであることを明示してリソース解放を促す形に変わっています。

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

本版の効き方は利用形態でかなり分かれます。マルチエージェントを日常的に使う開発、企業プロキシの内側での利用、背景エージェントの常駐運用では手応えが大きく、ローカルでの短い対話利用ではほとんど変化を感じません。

複数のサブエージェントを並行させる開発

サブエージェントに調査や実装を委譲して並行させる使い方では、これまで「返ってきた結果が本当に成功なのか」を人が疑う必要がありました。中断された処理が部分成果を返さず沈黙したり、usage limit reachedのようなエラーが成功として上がってきたりすると、親エージェントはそれを前提に次の手を進めてしまいます。本版ではこうした報告のずれが修正され、途中経過とエラーが親側に届くようになります。名前を再利用したエージェントへのSendMessageの誤配送も検出されるため、指示が意図しない相手に飛ぶ事故が減ります。

企業プロキシやTLS検査下での利用

社内ネットワークがTLS(通信の暗号化)を検査する構成では、証明書まわりのエラーが起きやすくなります。今回の更新では、証明書に起因するSSLエラーがリトライを消費せず即座に失敗し、NODE_EXTRA_CA_CERTSの設定不足など、どこを直せばよいかのヒントが付きます。原因が見えないまま数十秒待たされて失敗する、という体験が避けられます。使用量上限と無関係な429が自動でリトライされるようになったことで、混雑起因の一過性エラーでターンが落ちる頻度も下がります。

背景エージェントを常駐させる運用

claude agentsで背景エージェントを立てっぱなしにする運用では、環境ごとに別々の停止要因がありました。Linuxではデーモンが約50秒ごとに全エージェントを巻き込んで落ち、macOSのSSH経由ではコールドスタートに失敗し、claude stopが効かずに勝手に再起動される、といった症状です。本版はこれらをまとめて手当てしており、該当環境で常駐運用の予見性が上がります。低メモリのマシンでは、汎用エラーの代わりに原因が名指しされるため、リソースの増強か解放かを判断しやすくなります。

計画モード(plan mode)でブラウザツールを使う場合

plan mode(実行前に計画を確認するモード)でブラウザツールを併用しているときは、挙動の変化に注意が要ります。この版では、状態を変えるブラウザ操作は計画中でも確認を求め、読み取り専用のbrowser_batchは自動的に許可されます。計画段階でうっかり状態を書き換えてしまう経路が塞がれる一方、確認プロンプトの出方が変わるため、運用によっては条件次第の影響になります。

利用形態別の影響早見表

主な変更点

この版の24項目は、性質で見ると、背景エージェントの信頼性、サブエージェントの無言の失敗の解消、再試行と回復力、そして唯一の機能改善であるスキルのスタック呼び出しの4テーマに分けられます。

背景エージェントの信頼性

• Linuxのデーモンが壊れたワーカーレコードで約50秒ごとに自分と全エージェントを強制終了する問題を修正 — 背景エージェントをLinuxで常駐させる利用者に効きます
• macOSのSSH越しコールドスタート失敗(Could not switch to audit session)を修正。v2.1.196の回帰の回収 — リモートのmacマシンで背景エージェントを起動する利用者に効きます
• claude stopが自動再起動と競合して無言で取り消される問題を修正(再起動がstopを尊重) — エージェントを明示的に止めたい利用者に効きます
• メモリ不足のマシンで背景セッションが汎用エラーを返す問題を修正(低メモリを明示しリソース解放を提案) — 小さめのインスタンスで動かす利用者に効きます
• 長時間コマンドの実行中に背景ジョブの進捗表示が数分止まる問題を修正 — 長い処理を投げて別作業に移る利用者に効きます
• エージェント完了時にリモートセッションが実行中(Working)と待機中(Idle)を行き来してちらつく問題を修正 — claude.aiからエージェントを眺める利用者に効きます

サブエージェントの無言の失敗の解消

• レート制限やサーバーエラーで中断したサブエージェントが部分成果を親へ返さず沈黙する問題を修正 — 委譲したタスクの中間結果を拾いたい利用者に効きます
• サブエージェントがAPIエラーを成功結果として報告する問題を修正(親にエラー報告) — 結果の真偽を疑わずに済ませたい利用者に効きます
• 再起動したエージェントが前の名前を再利用したときSendMessageが誤ルーティングする問題を修正(不一致を検出し再指定を促す) — エージェント同士でメッセージをやり取りする利用者に効きます
• SessionStart / Setup / SubagentStartフックがexit code 2で標準エラー出力を隠す問題を修正(トランスクリプトに表示) — フックで前処理を差し込む利用者に効きます
• 待機中のサブエージェントがパネルから消える問題を修正(余剰の待機分を折りたたみ、要約行にまとめる) — 多数のサブエージェントを一覧したい利用者に効きます
• サブエージェント表示中の/model・/fastが無言でリードのモデル選択を開く問題を修正(適用先を通知) — 委譲中にモデルを切り替える利用者に効きます

再試行と回復力

• 証明書起因のSSLエラー(TLS検査プロキシ / NODE_EXTRA_CA_CERTS欠落 / 期限切れ証明書)がリトライを浪費せず、修正ヒント付きで即座に失敗 — 企業ネットワーク内の利用者に効きます
• 部分出力後にストリーム途中で過負荷やサーバーエラーが起きても、応答を破棄せず部分応答を保持して不完全な応答として通知 — 長い生成の途中で切られたくない利用者に効きます
• 使用量上限と無関係な一時的な429を、backoff付きで自動リトライ(以前はターンごと失敗) — 混雑時にサブスクリプションで使う利用者に効きます
• 起動時のリカバリで壊れた設定をリセットする際、復元不能に破壊する問題を修正(先にバックアップ) — 設定ファイルが壊れた状態から復帰する利用者に効きます

リトライの粘り強さは環境変数で調整できます。数値と役割は次の通りです。

スキルのスタック呼び出し(唯一の機能改善)

• スラッシュ形式のスキルを重ねて呼ぶとき、先頭に並んだ複数のスキル(最大5個)をロードするように(以前は先頭の1個のみ) — 複数のスキルを組み合わせて起動したい利用者に効きます

このほか、claude --dangerously-skip-permissions daemon <subcommand>がチャットプロンプト扱いされる問題、新規メッセージのないセッションの開閉でトランスクリプトが無駄に肥大する問題、←/backgroundで背景化するとエージェント行から/colorが落ちる問題、Claude in Chromeが別ビルドや別設定でreconnectページを繰り返し開く問題、claude agentsのセッション行がPRリンクを冗長な"PR"ラベル付きで表示していた点(素の#N表記に変更)も直っています。

claude update
claude --version

背景エージェントの信頼性はv2.1.195から本版までどう積み上がったか

本版の背景エージェント修正は単発の手当てではなく、数版にわたる調整の続きに位置づけられます。同じ経路で信頼性の改善と回帰の混入、そして回収が交互に起きてきました。時系列で並べると、積み上がりと揺り戻しが見えてきます。

v2.1.195で信頼性を改善した直後、v2.1.196でSSH越しのコールドスタートに回帰が入り込みました。v2.1.198では約52秒周期で再接続中(Reconnecting)が繰り返される症状に手が入り、本版で約50秒周期のデーモン自壊とv2.1.196の回帰の両方が片付いた、という流れです。2つの周期(約52秒と約50秒)は別々の症状で、順に潰されてきた点が読み取れます。なお、この区間でv2.1.194は欠番で、v2.1.195の1つ前はv2.1.193です。

背景で言えば、直前のv2.1.198でサブエージェントが既定で背景実行になりました(段階的な展開から既定へ移行しました)。その経路が常時使われるようになったからこそ、本版でエラー処理と常駐時の安定性を固める必要があった、と見ることもできます。背景エージェントを本格的に常駐させるなら、この一連の版を通して安定度が上がってきた点は判断材料になりそうです。

まとめ

本版は、複数のエージェントを扱う運用、企業ネットワークの内側での利用、背景エージェントの常駐という3つの使い方に効く、修正中心の版です。マルチエージェントで結果の取りこぼしに悩んでいた場合や、TLS検査プロキシの内側でSSLエラーの原因が見えずに困っていた場合、LinuxのデーモンやSSH越しの背景エージェントが不安定だった場合は、更新する価値が見込めます。

起動時のリカバリで壊れた設定を先にバックアップしてからリセットする修正は、設定を失いたくない利用者にとって安心材料になります。一方、ローカルで短い対話利用が中心であれば、体感の変化は小さいと考えられます。更新はclaude updateで取得できます。自分の利用形態が上の早見表のどこに当たるかを確認したうえで、更新の要否を判断する形になります。背景エージェントやサブエージェントの前提から押さえたい場合は、Claude Codeの全体像をまとめた完全ガイドもあわせて参照できます。