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與PermissionRequesthook 會放行工具呼叫。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 條;每一條的原文請見官方變更日誌。
如何更新
- 檢查已安裝的版本:
claude --version - 直接就地更新:
claude update