Claude Code 版本彙整：2026/07/22 - 2026/07/25

版本更新摘要

過去三天，Claude Code 從 v2.1.217 推進到 v2.1.220，主要仍屬於 patch 節奏，但更新密度相當高。這一輪變更可分成四條主線：背景 subagent 與 workflow 行為調整、MCP / 權限 / sandbox 的可靠性修補、Windows 與螢幕閱讀器等平台體驗改善，以及新模型 Claude Opus 5 的導入。值得注意的是，v2.1.219 雖然仍是 patch 版號，實際上包含預設 Opus 模型切換、1M context、nested subagent forwarding 等較具方向性的變更。

版本詳情

v2.1.217：穩定性、安全邊界與背景任務控管

v2.1.217 的重點在於補強長時間 session、背景任務與 transcript 保存的可靠性。

主要變更包括：

• 新增 prompt input 的 emoji shortcode autocomplete，例如輸入 :heart: 可插入 ❤️，也可透過 emojiCompletionEnabled 關閉。
• 當 transcript 寫入失敗、磁碟空間不足，或因繼承環境變數導致 session saving 關閉時，現在會顯示警告，避免靜默遺失紀錄。
• 修復 MCP tool output 被截斷後，完整未截斷內容仍保留在記憶體中的 memory leak。
• 修復 Windows auto-update 失敗時可能導致 claude.exe 消失的問題；更新失敗後會自動還原保留的 executable。
• 修復背景 session isolation 未正規化 symlink working directory，可能讓 session 逸出 workspace folder 的問題。
• 修復 Claude Opus 4.8 on Bedrock 下 auto-compact 不觸發、/compact 超限後失敗的問題。
• 修復 Claude Desktop session 中 corporate mTLS、TLS verify、OAuth scope、proxy 設定被忽略的問題。
• 新增 concurrent subagents 上限，預設最多 20 個，可透過 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 調整。
• 預設禁止 subagent 再生成 nested subagents；若需要更深層 nesting，可設定 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH。
• 修復 --max-budget-usd 無法停止背景 subagent 的問題；達到預算上限後會拒絕新 spawn 並停止執行中的背景 agent。

這版顯示 Anthropic 正在積極控制「背景代理自動化」的風險：不只是讓 subagent 更可用，也開始補上成本、深度、併發與 workspace 邊界的防護。

v2.1.218：/code-review 背景化與 TUI / MCP 體驗修補

v2.1.218 的最大變化是 /code-review 改為背景 subagent 執行，讓 review 不再佔滿主對話，同時保留 stacked slash commands 作為 review target。

主要變更包括：

• /code-review 改為背景 subagent 執行。
• --ax-screen-reader 模式新增刪除文字的朗讀提示，涵蓋 Option+Delete、Ctrl+W、Cmd+Backspace、Ctrl+U、Ctrl+K。
• 修復 Windows 路徑中 \u 開頭片段被誤轉為 CJK 字元，導致 C:\Users\unicorn 類路徑無法存取的問題。
• 修復左箭頭可能直接丟棄 conversation 且無法復原的問題；現在會要求確認。
• claude mcp list 與 /mcp 在 server connection 失敗時會顯示 HTTP status 與 error text，並警告 MCP config 中隱藏的前後空白。
• 修復多行貼上在某些 terminal 中把 newline 編成 Ctrl+J 時，內容被壓成單行且出現 j 的問題。
• 修復 /context 在 compact 後仍回報 stale token usage。
• 修復 /ultrareview 對描述式 arguments 處理失敗的問題。
• 修復 /code-review ultra 在 non-interactive session 中靜默跑成本地 review，而非 cloud review 的問題。
• 改善 auto mode：部分危險或可疑 Bash pattern 不再直接開 permission dialog，而是交由 auto-mode classifier 判斷。
• /deep-research 改為只在手動呼叫時啟動，Claude 不再自行發起。
• skills 若設定 context: fork，預設會在背景執行，可用 background: false 關閉。
• agent markdown frontmatter 中，agent name 不再允許 :，避免與 plugin namespace 衝突。

這版的方向很明確：把高成本、長時間、容易污染主對話的任務推向背景，同時改善 MCP 錯誤可觀測性與 terminal 操作安全。

v2.1.219：Claude Opus 5、sandbox allowlist 與 workflow 控制

v2.1.219 是本輪最重要的更新。它加入 Claude Opus 5，並將其設為預設 Opus model，同時帶來 1M context 與 fast mode 定價資訊。

主要變更包括：

• 新增 Claude Opus 5（claude-opus-5），成為新的預設 Opus 模型；支援 1M context，fast mode 定價為 $10 / $50 per Mtok。
• 新增 sandbox.network.strictAllowlist，sandboxed commands 可直接拒絕非 allowlisted hosts，而不再提示使用者。
• 新增 DirectoryAdded hook，當 /add-dir 或 SDK register_repo_root 在 session 中途加入 working directory 時觸發。
• headless stream-json init event 新增 mcp_server_errors，列出因 config validation 被略過的 --mcp-config entries；terminal 啟動時也會顯示警告。
• 新增 workflowSizeGuideline settings key，可從任意 settings file 設定 Dynamic workflow size guideline。
• stream-json 支援 nested subagent forwarding；depth-2 以上 subagent 在 --forward-subagent-text 開啟時也會出現，並以 spawning Agent 的 tool_use id 分組。
• 修復 claude -p text output 在 mid-stream API error 發生時丟失已產生回答的問題。
• 修復 self-hosted runner 重啟時，已批准的 permission 被 session resume 丟失的問題。
• 修復 Fable model row 對已包含 Fable 的 plan 顯示「Requires usage credits」的 stale cache 問題。
• self-hosted runner spawn 與 session failure 新增 structured failure categories，方便區分 hook error、runner crash 與 config error。
• 修復 GNU screen 中 copy-on-select 印出 base64 而非複製選取內容的問題。
• 修復 Windows CLAUDE_CODE_GIT_BASH_PATH 指向非 bash/sh binary 時被誤用；現在會忽略並警告。
• 修復 screen-reader mode 每次 keystroke 都重寫整行 input 的問題。
• dynamic workflows 預設改為 medium size guideline，目標少於 15 agents。
• /fast 現在適用於 Opus 5 與 Opus 4.8，Opus 4.7 移出 fast mode。
• subagents 預設可生成 nested subagents 到 depth 3；若要關閉 nesting，可設定 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1。

這版一方面推進模型層升級，另一方面也顯示 Claude Code 正在把 workflow、subagent、sandbox 與 MCP 可觀測性做成更完整的平台能力。

v2.1.220：npm 已發布，但 release notes 資訊有限

v2.1.220 已於 2026-07-24 23:11:21 UTC 發布到 npm，最新版本號為 v2.1.220。不過目前提供的資料中尚未包含完整 release notes，因此本次彙整不對其功能變更做延伸解讀。

GitHub Issues 動態

本期間 GitHub 監控涵蓋 4 天，共累計 198 個 issues。議題量依然偏高，且集中在幾個反覆出現的主題。

1. MCP / Claude Desktop 工具呼叫問題仍是主線

多個 issue 指向 Claude Desktop 或 MCP connector 的工具呼叫失敗：

• #79986：Windows MSIX 中 Claude Desktop 對 MCP server 從未送出 tools/call，導致 Filesystem tools 全部失敗。
• #79971、#79926：Claude Desktop chat-initiated tools/call 無法送達健康的 local MCP stdio server。
• #80002、#79992、#80189、#80016：macOS / Windows 上 Filesystem extension 或 filesystem-class MCP tool call 在 handshake 成功後仍被丟棄。
• #80996：--resume 後 stdio MCP server 卡在 disconnected / cycling，headless session 缺乏恢復路徑。
• #81020：OAuth-backed MCP connectors 沒有 re-authenticate action，只能 disconnect / reconnect。

這與 v2.1.218、v2.1.219 對 /mcp error text、mcp_server_errors、config validation warning 的補強相呼應：官方顯然正在提高 MCP 問題的可診斷性，但使用者端仍有不少 connector dispatch 與 auth recovery 痛點。

2. 權限、安全分類與 safeguard false positives 爭議升溫

近期 issues 中，安全分類與 permission 行為的投訴非常密集：

• #79980、#80378、#80371、#80368、#80363：使用者回報 safeguard / safety filter 對正常開發、數學研究、email infrastructure、security research 過度攔截。
• #80723、#80703：已明確承認風險後，Claude 仍反覆拒絕或重新標記風險。
• #80730：使用者聲稱 permission system 未能阻擋 destructive Bash commands。
• #80729、#80728：涉及 destructive operation guideline 與資料覆寫未確認的嚴重回報。
• #39523：bypass permissions mode 長期被認為存在根本性問題，已有大量重複案例。

v2.1.218 對 auto mode 的調整，以及 v2.1.219 新增 sandbox.network.strictAllowlist，顯示官方正嘗試把「靜態 permission analyzer」、「auto-mode classifier」與「sandbox policy」分工得更細。但 issues 反映出另一個問題：使用者需要的不只是更嚴格或更寬鬆，而是更可預期、可解釋、可配置的安全行為。

3. Fable / Opus 模型可用性與帳務狀態混亂

模型與 plan entitlement 相關問題在這幾天非常突出：

• #79337：Fable 5 在 Max plan 上仍提示需要 usage credits，留言數持續增加。
• #79360、#79969、#80355、#80382、#81017：Fable availability、usage credits、DISABLE_TELEMETRY 與 Max plan 的矛盾訊息。
• #80381、#80376、#79979：session restart 或 tool-only task 中出現 model downgrade。
• #81025：session 預設到 claude-opus-5[1m]，但 org 無法使用，隨後 silent fallback 並覆寫 saved model preference。
• #80737：model picker 顯示 $0 usage credits 且要求購買，即使使用者有 active Max plan。
• #81001：false-positive risk classification 自動升級到已退休的 claude-opus-4-8，造成 turn 中斷或 loop。

v2.1.219 修復 Fable row stale cache 與 /model picker 顯示問題，但 issues 顯示 entitlement、fallback、saved preference 與 model availability 仍是高度敏感區域。隨著 Opus 5 成為預設 Opus，這類問題短期內可能會增加。

4. Background subagents / workflow 仍在快速演進，也暴露新問題

本輪 release notes 大量觸及 subagent、workflow、background session；issues 也同步反映出邊界情境：

• #80375：背景 worker 被 recycled spare worker 服務時，EnterWorktree isolate 錯 repo。
• #80727：named background subagents 完成後未把 final message 傳給 parent。
• #80733：LSP tool 在 background subagents 中被靜默移除。
• #81018：claude-security scan 在 208-file scope 生成 95 agents，跑超過 2.5 小時。
• #81030：/tasks panel 過早清除已完成 subagents。
• #81029：Advisor tool 影響主 session auto-compact counter，導致 spurious compaction。
• #81002：/simplify 等待 subagents 時 hang，並意外 spawn /loop。

這些問題說明 Claude Code 正進入「agentic workflow 平台化」階段，但 scheduling、budget、visibility、parent-child result propagation 與工具繼承規則仍需要打磨。

5. Windows、TUI、Accessibility 持續修補

平台體驗方面，Windows 與 terminal UI 問題依然多：

• #76357、#81003、#81004：Windows updater / installer 相關問題，包括 MSIX self-update loop、EEXIST mkdir、檔案被占用導致更新失敗。
• #49985、#80364、#80734：terminal rendering、interactive text streaming、chat input selection 等 TUI 問題。
• #61021、#69234：Windows / VSCode 下文字選取、圖片貼上問題。
• #69996 與 release notes 中多項 screen-reader 修補顯示 accessibility 正在持續改善。
• #80357：Hebrew RTL 顯示語言下 navigation buttons 與 OS window controls 重疊。

v2.1.217 至 v2.1.219 都有 screen-reader、Windows path、copy-on-select、GNU screen、Git Bash path 的修補，顯示跨平台品質仍是 Claude Code 的主要工程負擔之一。

總結與觀察

這三天的 Claude Code 更新看似是連續 patch release，但實際上透露出產品重心的明顯轉移。

第一，Claude Code 正從單一 CLI 工具走向「多代理工作流執行環境」。/code-review 背景化、skills context: fork 預設背景執行、nested subagent depth 調整、workflow size guideline、stream-json subagent forwarding，這些都不是單點功能，而是在建立可觀測、可控、可串接的 agent runtime。

第二，MCP 已成為核心整合層，但也是當前最脆弱的部分。release notes 新增更多 MCP 錯誤資訊與 config validation 曝光，是必要且正確的方向；不過大量 Desktop / Filesystem / OAuth connector issues 顯示，使用者遇到的問題常跨越 CLI、Desktop、connector、local server、auth cache 與 transport，多層堆疊讓除錯成本偏高。

第三，安全與 autonomy 的拉扯會繼續存在。v2.1.217 引入 subagent caps，v2.1.219 加強 sandbox allowlist；同時 issues 中又充滿 safeguard false positives、permission bypass、destructive operation 等互相拉扯的投訴。Claude Code 接下來需要更清楚的 policy observability：為什麼被擋、誰做的判斷、哪個設定可以改、哪些行為永遠不允許。

第四，Opus 5 的導入是本輪最具指標性的變更。它讓 Claude Code 的高階模型路線進一步轉向 1M context 與 fast mode，但也帶來 org availability、fallback、pricing、plan entitlement 的複雜性。從 Fable 相關 issues 可看出，模型列、帳務狀態與實際可用性只要有一點 stale cache 或 fallback 不透明，就會迅速變成使用者信任問題。

整體來看，v2.1.217 到 v2.1.220 是一輪「把 agentic workflow 做大，同時補安全與可靠性護欄」的更新。短期內，Claude Code 的功能面會更強，但真正決定體驗的，將是背景代理、MCP、模型 entitlement 與 permission system 能否變得足夠可預期。