Claude Code v2.1.203：背景代理可靠性全面翻修與效能提升

Claude Code v2.1.203 帶來登入過期警告、手動權限模式徽章、MCP roots 支援額外工作目錄，以及大量背景會話、worktree 和效能修復。

2026年7月7日 • 10 min read • 作者：ClaudeWorld

Claude Code 開發團隊發布了 2.1.203 版本，這是一次以背景代理可靠性為核心的重大更新。除了登入過期警告和可見的手動權限模式徽章等實用新功能外，此版本修復了數十個影響背景會話、git worktree 和 claude agents 檢視的問題，同時縮減了執行檔大小與啟動記憶體用量。

新功能

登入過期警告

Claude Code 現在會在您的登入即將過期時發出警告，讓您可以在背景會話被中斷之前重新驗證。這可以避免長時間執行的工作因憑證過期而悄悄停擺。

手動權限模式可視化

處於手動權限模式時，頁尾現在會顯示灰色 ⏸ 徽章，讓您隨時一眼就能看到目前啟用的權限模式。

MCP Roots 支援額外工作目錄

會話的額外工作目錄現在會納入 MCP roots/list，且當目錄集合變動時會發送 notifications/roots/list_changed 通知。MCP 伺服器現在可以準確追蹤會話的完整工作區範圍。

背景會話可靠性修復

此版本解決了一長串背景代理問題：

  • 在 macOS 上開啟或切換背景代理會話不再因錯誤的低記憶體偵測而停滯 15–20 秒（2.1.196 引入的回歸問題）
  • 當守護程序的會話 token 過期時，背景會話不再永久無法回應附加、回覆和停止操作——現在會自動恢復
  • 返回 claude agents 不再悄悄停止執行中的子代理並從頭重新執行提示——它們的工作現在會延續
  • 背景代理不再從守護程序繼承過時的 PATH，此問題曾導致 Windows 上找不到工具
  • 背景和代理檢視會話不再遺失 shell 匯出的 ANTHROPIC_BASE_URL，該問題曾將 API 金鑰送到預設端點並以 401 失敗
  • 背景代理在工作目錄被刪除、被檔案取代或路徑失效時不再無限重啟——現在會以清楚的錯誤訊息失敗一次
  • 背景守護程序自動升級失敗不再悄悄終止所有執行中的背景會話
  • TaskStop 和 TaskOutput 現在可以找到由其他代理產生的背景代理，錯誤訊息會依 id 和描述列出執行中的代理
  • 透過守護程序 fork 的背景會話現在會遵守 settings.json 中的 effortLevel 變更，附加時也會遵守 CLAUDE_CODE_DISABLE_MOUSE 和 CLAUDE_CODE_DISABLE_MOUSE_CLICKS 停用設定
  • Windows 上的背景任務輸出在 /clear 之後不再被永久替換成空檔案

Git Worktree 修復

  • 在有許多 git worktree 的 repo 中，Bash 不再出現「argument list too long」錯誤
  • worktree 隔離的子代理不再有時在父檢出目錄而非自己的 worktree 中執行 shell 指令
  • worktree 建立不再拒絕多 repo 工作區中的巢狀 repository，此問題曾讓背景會話無法隔離和編輯
  • 設定了 WorktreeCreate 掛鉤時，從非 git 目錄啟動的背景會話現在可以編輯檔案
  • claude agents 中的 @ 目錄選擇器現在會顯示已註冊的 git worktree

Agents 檢視與 UI 改進

  • 當斜線指令在 claude agents 撰寫框中不可用時，不再丟棄您已輸入的訊息
  • 開啟已停止會話（其對話已在另一個會話中開啟）時，代理列表不再崩潰
  • 背景會話在問題已回答後不再顯示「Needs input」，啟動失敗現在會顯示實際錯誤而非僅「exit_with_message」
  • 所有具名代理完成後，/exit 不再錯誤地警告有執行中的背景代理
  • 修復了向上捲動長對話記錄時的內容跳動、在 bash 模式輸入時 shell 歷史建議造成的終端機閃爍，以及重新附加背景會話時印出 ^[[I / ^[[O 逸出碼的問題
  • 空的 claude agents 檢視現在總是顯示分類區塊（Needs input / Working / Completed）與描述，並移除了頁尾中多餘的導覽提示
  • 左方向鍵不再關閉背景任務、diff 和工作流程詳細檢視——請改按 Esc

效能改進

  • 修復了互動會話中的記憶體和每輪 CPU 回歸問題：context 使用量指示器不再於每輪之後重新分析整個對話記錄
  • 透過延遲載入大型內建相依套件而非直接內嵌，執行檔縮小約 7 MB、啟動記憶體減少約 7 MB
  • 改善長回應串流時的回應速度：即時預覽更新不再重繪整個畫面

其他變更

  • 子代理現在較不會將整個任務重新委派給另一個子代理
  • 僅提供 LSP 的外掛在其語言伺服器提供診斷或回應導覽請求時，不再被錯誤標記為未使用
  • 移除了啟動時的「claude command missing or broken」警告——現在改顯示於 /doctor 和 /status
  • VSCode：新增「Enable Remote Control for all sessions」設定開關

如何更新

要更新到 Claude Code v2.1.203：

  1. 檢查目前版本：claude --version
  2. 使用您偏好的方法更新：
    • 套件管理器：依照您發行版的更新流程
    • 直接下載：造訪發布頁面取得平台特定的執行檔
  3. 重新啟動任何活躍的背景會話以受益於可靠性修復
  4. 留意按鍵變更：關閉背景任務、diff 和工作流程詳細檢視請改用 Esc 而非左方向鍵

相關連結