跳至主要內容

Claude Code v2.1.310:Monitor 支援 Bedrock、gateway 重試

Claude Code v2.1.310 讓 Monitor 工具支援 Bedrock、Vertex 與 Foundry,被部分 gateway 拒絕的請求會改為重試,讀取權限提示顯示符號連結目標,Enterprise 自訂角色也新增雲端 session 與 Remote Control 權限。

Claude Code v2.1.310 共有 26 條變更:14 條修正、6 條改進、3 條新增、3 條行為變更。Monitor 工具與 plugin monitor 現在可以在 Bedrock、Vertex 與 Foundry 上使用,關閉遙測或非必要流量時也能用。部分 gateway 會因為 effort-2025-11-24 beta 值或對話中途的 system 訊息而拒絕請求,現在 Claude Code 會拿掉這些內容後重試;Enterprise 自訂角色也新增了雲端 session 與 Remote Control 權限。另有兩條修正收緊了權限提示與 hook:檔案讀取提示現在會顯示符號連結指向何處,Windows 上 hook 會放行工具呼叫的一種情況也已修正。

Monitor 工具支援 Bedrock、Vertex 與 Foundry

Monitor 工具與 plugin monitor 現在可以在 Bedrock、Vertex 與 Foundry 上使用,停用遙測或非必要流量時也可以。在這些環境中,長時間的前景 sleep 現在也會被擋下。

被 gateway 拒絕的請求改為重試

部分 gateway 與相容伺服器會拒絕 effort-2025-11-24 beta 值或對話中途的 system 訊息,導致請求失敗。Claude Code 現在會在不帶這些內容的情況下重試。如果你透過這類 gateway 或相容伺服器使用 Claude Code,也遇過這種失敗,請更新。

Enterprise 自訂角色支援雲端 session 與 Remote Control

Enterprise 自訂角色現在包含 Claude Code 雲端 session 與 Remote Control 的權限,Owner 可以依角色分別控制兩者的存取。在管理設定中開啟 Cloud sessions 或 Remote Control 時,現在會先要求確認,並列出擁有該權限的自訂角色。

權限提示與 hook

  • 讀取提示會顯示符號連結的目標。 檔案讀取的權限提示現在會顯示符號連結指向何處。
  • 缺少 Git Bash 時的 Windows hook。 在 Windows 上,缺少 Git Bash、且 hook 的命令只有加引號的字串(例如加引號的路徑)時,PreToolUse 與 PermissionRequest hook 會放行工具呼叫。v2.1.309 修正過一個相關情況:未安裝 Git for Windows 時,PowerShell hook 會 fail open。
  • auto 模式與工作目錄外的讀取。 auto 模式在第一次讀取工作目錄以外的內容之前會先提示;如果封鎖這類讀取會讓 shell 命令改為詢問權限,這個提示現在會說明這一點。

值得注意的行為變更

  • 更多環境會擋下長時間的前景 sleep。 隨著 Monitor 工具一起,Bedrock、Vertex、Foundry,以及停用遙測或非必要流量的環境,現在也會擋下長時間的前景 sleep。
  • 非互動 session 中的 MCP elicitation 逾時。 在非互動 session 中,若 MCP 工具呼叫在伺服器的 elicitation 尚未得到回答時逾時,錯誤訊息現在會告訴 Claude 沒有收到回答,而且不要重複這次呼叫。
  • 雲端環境對話框現在從各自的列(row)開啟網路存取、設定腳本與環境變數,不再一次列出所有編輯器。

Session、壓縮與清理

  • cleanupPeriodDays。 當 cleanupPeriodDays 設為非常大的值時,背景清理會刪除部分近期檔案,例如貼上的圖片。
  • 「Prompt is too long」之後的壓縮。 對於含有 base64 或 SVG 等密集文字的對話,壓縮後保留了太多內容,導致下一個請求可能再次失敗。
  • 非互動 session 的記憶體用量。 對話記錄檔非常大時,非互動 session(-p、Agent SDK)在壓縮期間的記憶體用量有所改善。
  • 提問的自動繼續逾時。 用外部編輯器長時間編輯後,提問的自動繼續逾時會在編輯器關閉的那一刻觸發。

Linux sandbox 警告與 mod 圖片

  • Linux。 當 Ubuntu 對 user namespace 的 AppArmor 限制讓 bubblewrap 無法啟動 sandbox 時,/sandbox 與 sandbox 啟動警告現在會指出這項限制,以及如何解除。
  • mod。 mod 的 Image 現在可以在開啟 allow-passthrough 與 focus-events 的 tmux 內繪製,適用於 kitty、Ghostty 與 iTerm2 3.5+(使用 fullscreen rendering 時);過去在這些環境中只會顯示它的 alt 文字。

雲端 session、VS Code、Claude Tag 與 Code Review

  • 雲端環境設定腳本。 新增 Choose file 按鈕,可以從檔案載入雲端環境的設定腳本;session 啟動檢查清單現在會在可捲動的方框中顯示設定腳本的輸出。
  • 雲端 session 的錯誤顯示。 雲端環境編輯對話框中儲存或封存失敗時,現在會在對話框內顯示錯誤;routine API token 操作失敗時,錯誤也會顯示在 routine 編輯對話框中,而不只是一則 toast 通知。
  • VS Code 的計畫審查。 在計畫審查卡片的「Send feedback and keep planning」按鈕上按 Enter,會直接核准計畫,而不是把你的意見送回去。
  • VS Code 與雲端 session。 從 Session history 的 Web 分頁開啟雲端 session 後,按下「Switch branch & continue」,面板會顯示「Something went wrong」。
  • Claude Tag。 以粗體、斜體或刪除線送出的 !restart、!help 等 ! 命令,不再被當成一般訊息。bundle 清單的背景重新整理失敗時,管理用的頻道與 workspace 頁面不再被載入錯誤取代;管理設定的 spend limits 頁面也不再於頻道名稱仍在載入時,回報沒有符合篩選條件的頻道。
  • Code Review。 儲存庫清單重新整理失敗後,管理區塊不再隱藏其儲存庫與開關;現在首次載入會重試,若仍失敗則只顯示一個 Try again 橫幅。

以上已摘要全部 26 條;每一條的原文請見官方變更日誌。

如何更新

  1. 檢查已安裝的版本:claude --version
  2. 直接就地更新:claude update

相關連結