Claude Code v2.1.203 — macOSで背景エージェントが遅い問題とトークン失効を修正

Claude Code v2.1.203は、修正を中心にした信頼性強化の版です。追加された機能が4項目、不具合の修正が26項目、挙動の改善が3項目、変更・削除が4項目の計37項目で、軸になっているのは背景エージェント(background agent)の安定化です。macOSで起動や切り替えが15〜20秒止まる回帰や、デーモンのトークンが失効すると背景セッションが操作を受け付けなくなる問題が解消しました。番号上の直前はv2.1.202(ワークフローのサイズ設定を追加した版)で、本版はその翌日に出た地固めの更新にあたります。この記事では、利用形態別の早見表と背景エージェントの版差分タイムラインで、更新の判断材料を示します。

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

この版で押さえたい変化は、macOSでの背景エージェントの起動安定化、長時間運用でのトークン失効からの自動回復、そして企業ネットワークやWindows環境での取りこぼし解消という3点です。いずれも新しい能力の追加ではなく、常駐や自律運用を止めていた不具合を取り除く方向の変更が中心になります。

1つ目は、macOSで背景エージェントの起動や切り替えが速くなった点です。これまでは、誤った低メモリ判定によって開閉のたびに15〜20秒ほど画面が止まることがありました。この待ち時間はv2.1.196で入り込んだ回帰(regression)で、本版でその判定が正され、待たされずに切り替えられるようになりました。

2つ目は、長時間立てっぱなしにする運用での回復力です。デーモン(常駐プロセス、daemon)が持つセッショントークンが失効すると、背景セッションが接続にも返信にも停止にも反応しなくなり、事実上動かせなくなっていました。本版ではこの状態から自動で回復するようになり、あわせてログインの有効期限が近いと警告が出るため、中断される前に再認証できます。

3つ目は、企業ネットワークやWindows環境での取りこぼしの解消です。シェルでexportした ANTHROPIC_BASE_URL が背景セッションで失われ、APIキーが既定のエンドポイントに送られて401になる問題や、WindowsでPATHが古いままツールが見つからない問題、/clear のあとに背景タスクの出力が空ファイルに置き換わる問題が、まとめて手当てされています。

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

本版の効き方は利用形態でかなり分かれます。macOSでの背景エージェント常用、トークン失効をまたぐ長時間運用、Windows環境、独自エンドポイントを使う企業プロキシ下では手応えが大きく、ローカルでの短い対話利用ではほとんど変化を感じません。

macOSで背景エージェントを常用する場合

claude agents で背景エージェントを頻繁に開閉するmac利用では、切り替えのたびの数十秒の固まりがなくなります。原因だった低メモリ判定は実際の枯渇ではなく誤検知だったため、メモリを増やしても直らない性質の遅さでした。本版で判定が正されたことで、セッションを行き来する操作の反応が戻ります。

長時間・自律で走らせる運用

エージェントを何時間も立てっぱなしにする使い方では、トークンの失効が静かな停止要因になっていました。失効に気づかないまま接続や停止の操作が通らず、原因の切り分けに時間を取られる場面もあったはずです。本版では失効から自動で回復し、期限が近いうちに警告が出るため、走らせ続ける前提の運用でも予見性が上がります。デーモンの自動アップグレードが失敗して実行中の背景セッションを無言で全滅させる問題も直り、更新をまたいでも処理が消えにくくなりました。

Windows環境での利用

Windowsでは2つの停止要因がまとめて手当てされました。背景エージェントがデーモンから古いPATHを引き継ぎ、必要なツールが見つからない問題と、/clear のあとに背景タスクの出力が空ファイルへ置き換わったままになる問題です。前者はコマンドが突然「見つからない」と言われる混乱を、後者は消えては困る実行結果の喪失を防ぎます。

独自のAPIエンドポイントを使う企業プロキシ下の利用

自社のゲートウェイを経由させるためにシェルで ANTHROPIC_BASE_URL をexportしている環境では、背景やエージェント表示のセッションでこの値が落ち、APIキーが既定のエンドポイントに送られて401で弾かれていました。本版でこの取りこぼしが直り、背景セッションでも指定したエンドポイントが尊重されます。エンドポイントの設定ミスと区別がつかず原因が見えにくかった401が、構成の側の問題として切り分けやすくなります。

作業ツリーやマルチリポでの運用

git作業ツリー(worktree)を多用する構成やマルチリポのワークスペースでは、細かな不整合が複数直っています。作業ツリーが多いリポジトリでBashが「argument list too long」で失敗する問題、作業ツリーで分離したはずのサブエージェントが親のチェックアウトでシェルを走らせてしまう問題、作業ツリーの作成が入れ子のリポジトリを拒む問題です。分離の前提が崩れると影響が読みにくいだけに、該当構成では地味に効いてきます。

利用形態別の影響早見表

主な変更点

本版の37項目は、性質で見ると、追加された4つの機能、背景エージェントの信頼性、作業ツリーと企業ネットワークの手当て、そして表示・操作と内部改善に分けられます。ここから各項目を、誰の体験に効くかを添えて挙げます。

追加された機能

• ログインの有効期限が近づくと警告が出るように — 背景セッションを止めたくない常駐運用の利用者に効きます
• 手動の権限確認モードのあいだ ⏸ バッジをフッターに表示し、有効なモードを常時見えるように — 権限モードの状態を見失いたくない利用者に効きます
• セッションの追加作業ディレクトリをMCPの roots/list に反映し、集合が変わると notifications/roots/list_changed を送信 — MCPサーバーに作業範囲を正しく伝えたい利用者に効きます
• VSCode拡張の設定に「全セッションでリモート操作を有効化」トグルを追加 — VSCodeから複数セッションを遠隔操作する利用者に効きます

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

• macOSで起動や切り替えが誤った低メモリ判定で15〜20秒止まる回帰(v2.1.196で混入)を修正 — macマシンで背景エージェントを頻繁に開閉する利用者に効きます
• デーモンのセッショントークンが失効すると背景セッションが接続・返信・停止のいずれも受け付けなくなる問題を修正(自動で回復)— 長時間立てっぱなしにする利用者に効きます
• claude agents に戻ると実行中のサブエージェントが無言で止まり、プロンプトを最初からやり直す問題を修正(作業を引き継ぐ)— 委譲した処理を中断したくない利用者に効きます
• コンテキスト使用量の表示がターンごとにトランスクリプト全体を再解析し、メモリとCPUを浪費する回帰を修正 — 長いセッションを続ける利用者に効きます
• デーモンの自動アップグレード失敗が実行中の背景セッションを無言で全滅させる問題を修正 — 更新をまたいで背景処理を走らせる利用者に効きます
• 作業ディレクトリが削除・置換・無効になると背景エージェントがクラッシュを繰り返す問題を修正(明確なエラーで一度だけ失敗)— 作業場所が動きやすい環境の利用者に効きます
• 別のエージェントが起動した背景エージェントを TaskStop / TaskOutput が見つけられない問題を修正(実行中のエージェントをidと説明付きで一覧)— 入れ子でエージェントを動かす利用者に効きます

このほか、claude agents の入力欄でスラッシュコマンドが使えないときに打った文が捨てられる問題、別のセッションで開いている停止済みセッションを開くとエージェント一覧がクラッシュする問題、回答済みの質問なのに背景セッションが「Needs input」と表示し続ける問題、起動失敗が実際のエラーではなく「exit_with_message」だけを見せる問題、デーモン経由でフォークすると settings.json の effortLevel の変更が無視される問題、接続中の背景セッションが CLAUDE_CODE_DISABLE_MOUSE / CLAUDE_CODE_DISABLE_MOUSE_CLICKS を無視する問題、名前付きエージェントがすべて完了した後も /exit が実行中の背景エージェントを警告する問題、WorktreeCreate フックを設定したとき非gitディレクトリから始めた背景セッションがファイルを編集できない問題、claude agents の @ ディレクトリ選択に登録済みの作業ツリーが出ない問題も直っています。

作業ツリー(worktree)まわりの修正

• 多数のgit作業ツリーを持つリポジトリでBashが「argument list too long」で失敗する問題を修正 — 作業ツリーを大量に切る利用者に効きます
• 作業ツリーで分離したサブエージェントが親のチェックアウトでシェルコマンドを実行することがある問題を修正 — 分離の前提で並行実行する利用者に効きます
• マルチリポ構成で作業ツリーの作成が入れ子のリポジトリを拒否する問題を修正 — 複数リポジトリをまとめて扱う利用者に効きます

企業ネットワークとWindows環境

• シェルでexportした ANTHROPIC_BASE_URL が背景・エージェント表示のセッションで失われ、APIキーが既定エンドポイントに送られて401になる問題を修正 — 独自エンドポイントを経由させる企業利用者に効きます
• 背景エージェントがデーモンから古いPATHを引き継ぎ、Windowsでツールが見つからない問題を修正 — Windowsで背景エージェントを使う利用者に効きます
• Windowsで /clear のあと背景タスクの出力が空ファイルに置き換わったままになる問題を修正 — 出力を残したいWindows利用者に効きます

表示・操作まわりの修正

• 長いトランスクリプトの履歴を上にスクロールすると内容が飛ぶ問題を修正 — 過去のやり取りを読み返す利用者に効きます
• bashモードで入力中にシェル履歴の候補が出ると、ターミナルがちらついて飛ぶ問題を修正 — bashモードを多用する利用者に効きます
• 背景セッションに再接続すると ^[[I や ^[[O のエスケープコードがそのまま表示される問題を修正 — 背景セッションを行き来する利用者に効きます
• 言語サーバー専用のプラグインが、診断や移動を提供しているのに未使用と誤判定される問題を修正(LSP) — 言語サーバー系プラグインを入れている利用者に効きます

改善された3項目

• ストリーミング表示の反応が良くなり、ライブプレビューが画面全体を再描画しなくなりました — 生成を目で追う利用者に効きます
• サブエージェントが自分のタスク全体を別のサブエージェントへ丸ごと再委譲しにくくなりました — 多段の委譲が暴走するのを避けたい利用者に効きます
• 大きな同梱依存を遅延読み込みにし、バイナリサイズを約7MB、起動時メモリを約7MB削減しました — 起動の軽さを重視する利用者に効きます

変更・削除された項目

• 背景タスク・差分・ワークフロー詳細の各ビューは左矢印で閉じなくなり、Escで閉じる方式に変更 — キー操作に慣れた利用者は指の運びが変わります
• 空の claude agents 画面が、常に「入力待ち・作業中・完了」のセクションに整理され、説明付きで並ぶように
• 起動時の「claudeコマンドが見つからない・壊れている」警告を削除し、/doctor と /status に集約
• claude agents のフッターから重複した操作ヒントを削除

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

claude update
claude --version

macOSの背景エージェントはv2.1.196の遅延回帰をどう回収したか

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

v2.1.195で信頼性を改善した直後、v2.1.196でmacOSの起動と切り替えに遅延の回帰が入り込みました。その間のv2.1.199ではLinuxデーモンが約50秒ごとに全エージェントを巻き込んで落ちる問題やmacOSでのSSH越しの起動失敗が片付き、本版でv2.1.196由来のmacOSスタールが回収されています。トークン失効からの自動回復やデーモン自動アップグレードの巻き添え防止も加わり、常駐の前提を支える部分がまとめて固められた版と読めそうです。なお、この区間でv2.1.194は欠番です。

記事化された直前のv2.1.201から本版までを通して見ると、修正の重心は一貫して背景エージェントの常駐運用に置かれています。番号上の直前のv2.1.202でワークフローまわりの調整が入り、本版でその翌日に信頼性の地固めが続いた流れは、背景エージェントを日常的に立てっぱなしにする使い方が主要な運用形態になりつつあることの表れとも読めそうです。

まとめ

本版は、macOSでの背景エージェント常用、トークン失効をまたぐ長時間運用、Windowsや企業プロキシ下での利用という使い方に効く、修正中心の版です。切り替えのたびに数十秒待たされていた場合や、立てっぱなしのセッションが失効で動かなくなっていた場合、独自エンドポイントで401に悩んでいた場合は、更新する価値が見込めます。

ANTHROPIC_BASE_URL の取りこぼしやWindowsの出力消失など、原因が見えにくかった不具合が名指しで解消されている点は、切り分けの手間を減らす材料になります。一方、ローカルで短い対話利用が中心であれば、体感の変化は小さいと考えられます。更新は claude update で取得でき、自分の利用形態が上の早見表のどこに当たるかを確認したうえで、要否を判断する形になります。

関連ガイド

背景エージェントを含むClaude Codeの全体像はClaude Code完全ガイドで押さえられ、2026年7月のアップデート全体の流れは月次アップデートまとめでたどれます。