Claude Code 版本彙整：2.1.291 至 2.1.296 的高頻修補週期

過去三天 Claude Code 從 v2.1.291 快速推進到 v2.1.296，整體仍屬 patch 級更新，但更新密度相當高。這一輪重點不在單一大型功能，而是圍繞 subagent、plugin/mod hooks、Claude apps gateway、Remote Control、Desktop Code tab、權限與安全邊界 做大量修補。值得注意的是，v2.1.292 與 v2.1.295 都包含非常長的修正清單，顯示 Anthropic 正在加速整理 2.1.x 系列中因雲端 session、插件系統、背景任務與多端整合帶來的複雜邊界問題。

版本詳情

v2.1.291：修復 2.1.288–2.1.290 的回歸

v2.1.291 是一個小型但重要的穩定性修補版，主要修正兩個回歸：

• 修復 2.1.290 中 cloud sessions 可能遺失 permission prompt 回答的問題。
• 修復 2.1.288 中結束 session 時最後幾則訊息可能遺失的問題。

這類修正雖然範圍不大，但都直接影響使用者對「長 session 是否可靠」的信任。

v2.1.292：插件、市集、Agent effort 與安全修補

v2.1.292 是本期第一個大型更新，重點集中在插件與 agent 能力：

• claude plugin install 新增 --marketplace <source>，可在安裝 plugin 時自動加入 marketplace。
• Agent tool 新增 effort 參數，讓呼叫 sub-agent 時可指定努力等級。
• 新增 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS，可調整 529 overloaded request 的 retry backoff base delay。
• mods 新增 prompt.autocomplete event，可擴充 prompt box 的 autocomplete。
• $.model.complete 支援 prompt caching。
• agent.spawn hook 可看到 workflow agents 的 run 與 index。

修復面則相當廣，包含 sandbox、managed settings、network UNC path、Windows alternate path spelling、PDF/notebook read approval race、plugin hook permission bypass、NO_PROXY、MCP tool name 長度限制、scheduled tasks、background loop、Grep/Glob/Read 行為等。安全相關修補尤其值得注意，例如：

• 修復 PreToolUse hook approvals 與 auto mode 可能繞過 network path file read permission prompt。
• 修復 sandboxed commands 可讀取 /ultrareview 上傳暫存 staged file copies。
• 修復 server-managed settings cache 被竄改時可能停用 built-in policy plugin。

這版看起來像是一次「安全邊界與工具行為一致性」的大掃除。

v2.1.293：Haiku 5.5、MCP 記憶體洩漏與長 session 穩定性

v2.1.293 新增 Claude Haiku 5.5（claude-haiku-5-5），並標示其成為 Anthropic API 的預設 Haiku model。官方描述包含 1M context 與新的價格資訊，對大量背景任務、低成本 agent、工具型工作流有明顯意義。

其他新增項目包括：

• subagentStatusLine payload 新增 agentType。
• $.tool.register 新增 isDeferred。
• 改善 Team / Enterprise 啟動時 policy 與 managed settings 的抓取時機。
• 改善 Claude in Chrome 在 browser 回報 tabs 較慢時的容錯。

重要修復包含：

• 修復 HTTP MCP connection 保留所有已送 request 造成的 memory leak。
• 修復 compaction 前後 Claude 可能把已完成動作重新執行或撤回的問題。
• 修復使用 ← 背景化時訊息可能遺失。
• 修復 /model effort 左右切換 wrap 過頭，可能誤把 Low 存成預設 effort。
• 修復 Windows 停止 status line、hook 或 shell command 時可能終止錯誤 process。

這版的主軸是長 session、MCP 連線、agent 顯示與背景化流程的可靠性。

v2.1.294：修補 instruction-style hooks 的判斷

v2.1.294 是較小的修補版，聚焦 hooks written as instructions：

• 修復 prompt / agent hooks 以自然語言 instruction 撰寫時，可能允許應該阻擋的行為。
• 改善 Stop 與 SubagentStop 上的 prompt hooks 判斷，降低 Claude 過早停止的機率。

這透露出 Anthropic 正在讓 hooks 不只支援程式式規則，也要處理「用自然語言描述政策」時的判斷可靠性。

v2.1.295：gateway、hooks、MCP、background session 的大型穩定性更新

v2.1.295 是本期最大更新之一，新增項目橫跨 hooks、gateway、terminal 狀態與 plugin UX：

• command / HTTP hooks 新增 onFailure: "block"，hook 無法啟動、逾時或非預期 exit code 時可阻擋 action。
• 支援 Program Status Protocol（OSC 7501），終端機可顯示 Claude Code 正在工作、等待使用者或完成。
• /copy picker 支援 quoted text，複製草稿時可去除 > markers。
• gateway 新增 timeouts.upstream_ttfb_ms，可限制 upstream stream 開始時間並 failover。
• gateway upstream 新增 models list，可控制哪些 models 送往指定 upstream。
• 新增 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 控制 unattended retry mode 等待 429 / 529 的時間。
• mods 新增 $.ui.notify。

修復項目非常多，幾個值得標出的方向：

• MCP 穩定性：修復 remote MCP outage 後不重連或 tight loop、pagination cursor 重複、MCP resource list 等待導致 interrupt 延遲等。
• 工具與權限：修復 command_description 導致 Bash tool call 失敗、--tools / --restricted 未套用到晚註冊 built-in tools、for-loop glob permission check 準確性。
• 背景任務與 session：修復 CLAUDE_AUTO_BACKGROUND_TASKS 可能讓 edit / shell command 在 subagent 完成前開始、背景 /loop wakeup 遺失、background session 繼承 FORCE_COLOR=3。
• plugin/mod 系統：修復 deeply nested tool input 被截斷但 guard 不知道、hot reload race、plugin options 叫 constructor / prototype 的問題、hooks worker restart 期間 guard 被繞過等。
• Desktop / VS Code / Cloud sessions：修復 VS Code rewind/fork、keyboard focus、cloud session unarchive 後無回覆、cloud catch-up 等。

這版也修復了「web searches 和 agent hook evaluations 在 xhigh / max effort 下變慢」的問題，對重度使用高 effort agent 的使用者很關鍵。

v2.1.296：managed policy、auto-compact、Read large file 與更多安全邊界

v2.1.296 延續 v2.1.295 的方向，新增項目包括：

• Claude apps gateway 的 managed.policies[] 新增 code key，可將類似 cli 的設定套用到 Claude Desktop Code tab，並啟用 Desktop gateway mode。
• subagent frontmatter 與 --agents definitions 新增 autoCompactWindow，允許 subagent 比主 conversation 更早 auto-compact。
• 新增 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL，可讓 workflow agents 固定使用同一模型。
• 新增 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS，控制 529 retry backoff 最大延遲。
• Read tool 新增 allow_large option，可在 context 足夠時一次讀取超過通常限制的大型文字檔。

修復重點包括：

• managed-settings PreToolUse / prompt hooks block 後沒有正確結束 turn。
• headless sessions 在切換目錄或 reload plugins 後，啟動已被 folder 關閉的 .mcp.json 或 plugin MCP server。
• secret redaction 在 shared transcripts / debug logs 中漏掉部分 key-value 形式。
• Bash permission checks 可能因 BASH_ARGV0 被 auto-approve。
• Edit / NotebookEdit 對非 UTF-8 檔案將非 ASCII 字元替換掉；現在會拒絕此類 edit。
• Windows PowerShell 長命令 permission check 擴展到 32KB。
• Windows Git Bash 下 rm -rf /c/Users/<name> 在 bypass permissions mode 不詢問的問題。
• CLAUDE_CODE_TRANSCRIPT_LOCAL_GC 在含 U+2028 / U+2029 時可能丟 transcript message。
• /code-review 在 cloud sessions、Agent SDK、IDE integrations 中輸出 raw JSON array 的問題。

另外，v2.1.296 更新了 Sonnet 5.5 cache reads 的成本計算：/cost、status line、--max-budget-usd 與 SDK cost figures 改為每百萬 tokens $0.10，而非 $0.20。這對成本觀察與預算限制有實際影響。

GitHub Issues 動態

本期四天監控共累計 193 個 Issues，數量仍偏高。議題分布顯示使用者回報集中在幾個主軸：權限 / auto mode、Desktop 與 Remote Control、Windows 穩定性、plugins / hooks、model 行為與成本顯示。

權限與 auto mode 仍是高頻痛點

多個 issue 指向 auto mode classifier、permission prompts 與使用者授權之間的落差：

• #100730：auto mode classifier 阻擋帳號擁有者自己的 scheduled task 與自己機器間的 file transfer。
• #100941：auto mode classifier 阻擋 user-approved posts，且 permission rule 被視為 bypass。
• #29214：Remote Control mobile app 在 --dangerously-skip-permissions 下仍顯示 permission prompts。
• #100091：要求新增 disable classifier 選項。
• #92279：希望 auto mode classifier block 可 fallback 到 permission prompt，而非 hard deny。

這與 release notes 中多次修補 auto mode、permission hooks、managed settings、tool denial 的方向一致。Anthropic 正在讓自動化更安全，但使用者也明顯感受到安全分類器與實際授權意圖之間仍有摩擦。

Desktop / Remote Control / Cloud sessions 的多端同步問題持續

近期 Issues 中，Remote Control 與 Desktop session lifecycle 問題非常突出：

• #100114 / #100940：Windows Desktop 重啟或 auto-update 後 Remote Control 不會恢復，mobile 端顯示 archived 或沉默。
• #100362：Remote Control restart 後持續 HTTP 403，重新登入也無法恢復。
• #100359：Desktop SSH remote messages 卡在 “Delivering to user@host…”。
• #100106：Desktop auto-update relaunch 會中斷 Remote Control sessions。
• #100545：Linux thread/process creation fail 時 Claude Code SIGABRT，Desktop live background tasks 遺失。

這些問題反映 Claude Code 正從單機 CLI 工具快速擴展成多端、雲端、桌面、mobile、remote-control 混合系統，而 session 狀態同步與恢復是目前最難穩定的層面之一。

Windows 平台仍有大量 process、permission 與 Desktop 問題

Windows 相關 issue 數量顯著，包括：

• #97752：timed-out git status 留下 orphaned git.exe，最終耗盡記憶體。
• #96299：Windows claude.exe session processes 累積不終止。
• #91763：Windows/MSIX update 因 git fsmonitor process file lock 阻擋 relaunch。
• #100939：CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1 對 Windows git subprocess polling 無效。
• #100936：Windows Bash tool commands 約 8,191 字元被截斷。
• #100630：Windows MSYS /d/... path 形式可繞過 dangerous rm safety check。

v2.1.295 與 v2.1.296 已包含多個 Windows process 與 permission 修補，但 issue 仍顯示 Windows 路徑、AppX/MSIX、PowerShell、Git Bash、process job object 等平台差異仍是 Claude Code 的主要挑戰。

Plugin / hooks / mods 生態正在快速成長，也帶來新故障模式

本期 release notes 對 plugin/mod hooks 的修補非常密集，而 Issues 也同步反映出 plugin UI 與 hooks 的大量邊界問題：

• #91870：Mods extensibility 討論仍高度活躍，已有 248 則 comments。
• #100651：Plugin Pane 在 redraw 時 press 失敗。
• #100924：Desktop pane redraw 約每 200ms 導致 Buttons click 無效。
• #99211：Desktop app 任意 state change 會 redraw every mod render site，破壞 Buttons 與 SVG animations。
• #100926：$.config.list() / $.config.set 在某些 session 中直到 /reload-plugins 才有 userConfig rows。
• #100929：claude plugin test 中 plugin 自己的 $.ui.focus 找不到 implementation。

這表示 plugin/mod API 已經進入較多人實測的階段，問題也從「能不能掛 hook」進入「hook lifecycle、hot reload、UI redraw、test harness 與 permission guard 是否一致」的成熟度挑戰。

Model 行為與成本感知問題增加

幾個 issue 指向模型行為、成本與安全誤判：

• #100927：使用者回報 Claude Code 在 5 分鐘 CSS task 上浪費數小時。
• #100925：compaction 後把 summary 中的 count 當事實，未重新檢查。
• #100942：部署是否移除 broken links 的陳述與自身 notes 矛盾。
• #100606：Opus model quality degraded 的疑慮。
• #100943 / #100934 / #100095：usage reset、quota、成本顯示不準或引發抱怨。
• 多個 cyber safeguards false positive issues，例如 #100639、#100649、#100350、#99264。

這類 issue 不一定都是 CLI bug，但會直接影響 Claude Code 作為 agentic coding tool 的可信度：使用者不只關心功能能不能跑，也在意模型是否會錯誤自信、浪費 quota、或被安全分類器誤擋。

總結與觀察

這三天的版本節奏顯示 Claude Code 2.1.x 正處於「功能擴張後的穩定化密集期」。新增功能方面，Agent effort、Haiku 5.5、subagent autoCompactWindow、workflow subagent model override、gateway policy code key、Read allow_large，都在強化 Claude Code 作為多 agent、多環境、多端平台的能力。

但更大的訊號其實在修補清單：Anthropic 正大量處理 permission 邊界、hook lifecycle、plugin reload、MCP reconnect、background wakeup、cloud / desktop session recovery、Windows path safety。這些不是表面功能，而是 agentic tool 真正要可靠運作時最容易出問題的基礎層。

短期來看，使用者應把 v2.1.296 視為值得更新的穩定性版本，尤其是使用 gateway、Desktop Code tab、plugins/mods、workflow agents、Windows 或 Remote Control 的團隊。不過 Issues 顯示 auto mode 權限判斷、Desktop/Remote Control 恢復、Windows process 管理與 plugin UI redraw 仍是未完全收斂的區域。Claude Code 的發展方向很明確：它正在從 CLI 編碼助手變成完整的自動化開發平台；而這也意味著未來幾週的 patch 版，仍很可能繼續圍繞「安全地自動化」與「跨 session 可靠性」做高頻修補。