Claude Code 版本彙整：2026/10/11 - 2026/10/14

版本更新摘要

過去三天 Claude Code 的公開版本節奏相對平穩：npm 已出現最新版本 v2.1.299，但本期可取得的完整 CHANGELOG 仍集中在 v2.1.296。從內容來看，2.1.296 不是單一功能導向的小修，而是一個偏「穩定性與平台整合」的大型維護版，重點涵蓋 Claude apps gateway、subagent、plugin / MCP、managed settings、Windows / VS Code / Cloud sessions，以及 Claude Tag、Code Review 等周邊工作流。GitHub Issues 方面，近期討論明顯集中在 權限判斷、MCP / connector、記憶體與長工作階段穩定性、model safeguard 誤判、Remote Control / Desktop 體驗 幾條主線。

版本詳情

v2.1.299

npm 顯示 Claude Code v2.1.299 已於 2026-10-14 發布。不過目前資料中只有發布時間，尚未附上對應 CHANGELOG，因此本期只能確認版本已推進，無法判定 2.1.297 至 2.1.299 之間的具體變更內容。

這種情況在 Claude Code 的快速迭代節奏中並不少見：npm 版本號先行更新，詳細 release notes 稍後補齊，或變更內容沿用前一批維護項目。就目前可見資料而言，真正值得分析的仍是 v2.1.296 的大範圍修補。

v2.1.296

v2.1.296 的變更量相當大，可以分成幾個主要方向：

1. Gateway 與企業管理設定持續補強

本版新增 Claude apps gateway 的 managed.policies[] 中 code key，讓 Desktop Code tab 可以套用與 CLI 相同的設定，並與 desktop 一起啟用 Claude Desktop 的 gateway mode。這顯示 Anthropic 正在把 Claude Code 從「單機 CLI 工具」逐步推向「受組織政策管理的跨端開發環境」。

相關修補也不少，包括：

• 修復 forceLoginMethod=gateway 但沒有 forceLoginGatewayUrl 時，已儲存 gateway 登入被忽略的 2.1.295 regression。
• 改善 cloud session 被拒絕時的錯誤訊息，現在會說明組織政策無法載入的原因。
• 改善 Desktop Code tab 在 gateway 後方啟動失敗時的提示。

2. Subagent 與 workflow agent 控制更細緻

本版新增 autoCompactWindow，可在 subagent frontmatter 或 --agents 定義中設定，讓 subagent 比主對話更早進行 auto-compact。另新增 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL，可讓 workflow agent 統一使用指定模型，而不影響其他 subagent。

這兩項變更都指向同一個方向：Anthropic 正在承認「多 agent 工作流」需要獨立的資源與上下文管理，而不能完全沿用主 session 的設定。

3. Plugin / MCP 修補密度高

v2.1.296 對 plugin 與 MCP 的修補非常多，包括：

• 修復 headless session 在切換目錄或 reload plugin 後，啟動本應停用的 .mcp.json 或 plugin MCP server。
• 修復 plugin served $ methods 使用主 session 工作目錄，而非呼叫 agent 工作目錄的問題。
• 修復 $.http.fetch 對 HEAD request 與大 Content-Length 的錯誤拒絕。
• 修復 marketplace 或 plugin secret 名稱為 constructor / prototype 時造成的內部錯誤或資料遺失。
• 修復 synced skills / plugins 在多 session 共用 config directory 時反覆安裝或錯誤停用的問題。

這批修補顯示 plugin / MCP 生態正進入更複雜的使用情境：多 session、headless、自動同步、marketplace、mod hooks 交錯後，原本邊界不清的地方開始浮現大量 race condition 與狀態污染問題。

4. Hooks、permissions 與 auto mode 的穩定性改善

本版修復多個 hooks 與 permission 相關問題，例如：

• managed settings 中 PreToolUse hooks 回傳 deny 且 continue: false 時，現在會拒絕工具呼叫但不結束整個 turn。
• PostToolUse hooks 在部分 session 未套用 updatedMCPToolOutput 的問題已修復。
• 修復 UserPromptSubmit hook 或 mod prompt.submit hook 中按 Esc / interrupt 導致 headless session 結束、prompt 清空或未檢查 prompt 送出的問題。
• 修復 Bash permission checks 對設定 BASH_ARGV0 後再使用的命令誤自動批准；現在會要求核准。
• auto mode 若檢查沒有可用答案，現在以灰色「Not run」呈現，而不是紅色錯誤。

這些修補的共同意義是：Claude Code 正在把 permission / hook 從「附加功能」提升為核心可靠性邊界。尤其在 auto mode、headless、background session 越來越常見後，任何 permission 判斷錯誤都可能直接影響安全與信任。

5. Windows、VS Code、Cloud sessions 持續補洞

Windows 相關修補包括 PowerShell 長命令權限判斷、stdio MCP server shutdown、GitHub plugin install fallback 到 HTTPS、Git Bash 下 rm -rf /c/Users/<name> 的危險命令提示等。

VS Code 方面則修復：

• claudeCode.spinnerVerbs 設定缺失。
• Windows path / file:///C:/... chat link 無法開啟。
• reduced motion 設定下 working indicator 仍動畫。
• prompt cache clock 顯示不準。

Cloud sessions 方面新增 self-hosted Activity tab 的 status filter，並修復 queue position 與訊息排序問題。

這些都是偏「產品化」的修補：不是新增核心能力，而是讓 Claude Code 在各平台上的日常使用少踩坑。

6. 成本與 token 計算調整

本版更新 /cost、status line、--max-budget-usd 與 SDK cost figures，將 Sonnet 5.5 cache reads 價格從每百萬 token $0.20 調整為 $0.10。同時也修復 Haiku 5.5 與其他 adaptive thinking 模型在部分 gateway 後方 token count 不準的問題。

這對重度使用者尤其重要，因為 Claude Code 的成本觀測越來越依賴本地與 SDK 顯示是否準確。隨著 background agents 與長 session 增加，成本顯示不準已不只是資訊問題，也會影響工作流決策。

GitHub Issues 動態

本期 GitHub Issues 數量相當高，4 天累計監控到 199 個 issue。雖然其中包含不少 stale close、duplicate、invalid 或資訊不足的項目，但仍能看出幾個明顯趨勢。

1. 權限與 auto mode 仍是高摩擦區

多個 issue 指向 permission 判斷與 auto mode 的不一致：

• #101912：read-only Bash search 被判定為 Self-Modification。
• #101900：Remote Control sessions 即使已批准，仍持續阻擋動作。
• #99899：sub-agent 觸發 dangerous-rm prompt 後沒有 auto-deny timeout，導致 unattended bypass-mode run 無限卡住。
• #100374 / #97914 / #100974：auto mode classifier 對已批准或 read-only 操作仍可能錯判。
• #88698：PermissionRequest hook 在 --bg sessions 中決策被丟棄，session 卡在 permission prompt。

這顯示 Claude Code 的權限系統正在面對一個核心難題：它要同時服務本地 CLI、Desktop、Remote Control、background agents、cloud sessions 與 browser extension，但不同入口對「誰批准了什麼」的狀態同步仍不夠穩定。

2. MCP / connector 問題仍大量出現，但也有大量舊案關閉

10 月 12 日出現一批 MCP 相關 issue 關閉，包括 OAuth、schema、connector visibility、draft-07 outputSchema、tool parameter serialization 等問題。這可能代表 Anthropic 正在集中整理 MCP 積壓問題。

不過新問題仍持續出現：

• #101843：claude.ai connector transient 403 被快取成 needs-auth，之後 session 跳過 connector，重新授權也無法清除。
• #101839：Microsoft Learn MCP 回傳 negotiated 2025-06-18，但 tool call 被拒絕為 missing required resultType。
• #101117：connector-list 初次 401 後沒有 retry，導致整個 session connector 消失。
• #101376：Windows Desktop idle / closed Code sessions 保留 MCP servers，造成大量 node processes 與約 10GB RAM 使用。

MCP 的問題已經不只是「能不能接上工具」，而是牽涉 auth cache、session lifecycle、schema negotiation、connector scoping 與資源回收。

3. 長 session、compaction 與記憶體問題升溫

近期 issue 對長 session 穩定性的關注明顯增加：

• #101402：Mac M4 上 memory leak 成長到 28–30GB。
• #101901：Windows VS Code extension host 在啟動 2 個以上 parallel background Agent subagents 後 OOM crash。
• #101648：Linux x64 在「Compacting conversation…」期間 JSC JIT 發生 SIGILL。
• #100277：Opus 5.5 1M context window 下 Auto-Compact 過早觸發。
• #100710 / #75759 / #70555：auto-compact 或 compaction 後工作記憶遺失、長 session 變笨、需要更好的 working-state continuity。

v2.1.296 新增 autoCompactWindow 可視為對這一類問題的直接回應之一，但 issue 顯示使用者真正想要的不只是「更早 compact」，而是 compact 後不要遺失任務脈絡與工作狀態。

4. Model safeguard 誤判成為使用者信任問題

多個 issue 都與 model safeguard 或安全分類器誤判有關：

• #101655：benign agent message-analysis coding 被 safeguard 阻擋。
• #101653：/compact 被 safety classifier 擋下。
• #101913 / #96118 / #101647：reasoning_extraction、shellcheck analysis、合法安全分析被誤判。
• #101898：Claude Code 將遠端機器 troubleshooting 誤判為 cyber attack。
• #101397：Claude 對 firmware update request 過度 second-guess。

這類問題的傷害不只在於單次失敗，而是會讓開發者難以預測 Claude Code 什麼時候會拒絕正常工作。對 CLI 開發工具而言，「可預測性」幾乎和能力本身一樣重要。

5. Desktop / Remote Control / VS Code 體驗仍有不少邊界問題

近期 issue 也反映 Claude Code 跨端體驗正在快速擴張，但狀態同步仍有缺口：

• #101915：同機器 current-version peers 仍被 SendMessage 判定可能是舊版本，導致 agent 重複發送。
• #101909：Windows Desktop Code tab 中 Ctrl+Enter 在 text-only response 期間排隊而非立即送出。
• #101862：/desktop 搭配 Remote Control 會留下兩個 sidebar rows。
• #94743：VS Code extension host restart 後 Claude panels 無法 re-attach。
• #101140：VS Code split terminals 間 session tool uses 與 diffs 洩漏。
• #101652：Claude Code Web 權限 approval prompt 不可見。

這些問題共同指向一件事：Claude Code 已經不是單一 terminal app，而是跨 Desktop、VS Code、Web、Mobile、Remote Control 的多端系統。多端之間的 session identity、permission state、UI focus 與 lifecycle 管理會是接下來的重要穩定性戰場。

總結與觀察

本期 Claude Code 的版本動態不像是「新增一個大功能」，而更像是一次面向大型使用者群與多端場景的基礎設施整理。v2.1.296 對 gateway、managed settings、hooks、plugin、MCP、subagent、Cloud sessions、VS Code 與 Windows 都做了大量修補，顯示 Claude Code 的產品重心正在從 CLI 原型工具，轉向企業可控、跨端可用、可擴充、可觀測的開發平台。

不過 GitHub Issues 也清楚顯示，目前最痛的地方仍集中在三個層面：權限系統的一致性、長 session / 多 agent 的資源管理，以及 safeguard 誤判造成的工作中斷。這些問題都不是單點 bug，而是架構壓力測試後浮現的系統性挑戰。

v2.1.299 已經發布，但尚未看到完整變更說明。若接下來幾個版本延續 v2.1.296 的方向，最值得觀察的是 Anthropic 是否會進一步處理 background agents 的成本上限、MCP server lifecycle、Remote Control 權限同步，以及 compaction 後的工作記憶保存。對重度使用 Claude Code 的團隊來說，這些穩定性改善可能比任何單一新功能都更關鍵。