Claude Code 版本彙整：2026/06/24 - 2026/06/27

版本更新摘要

過去三天 Claude Code 維持高頻 patch 節奏，從 v2.1.187 推進到 v2.1.195。這一輪更新沒有大型功能改版，但密集修補了幾個近期使用者明顯感受到的痛點：背景 agent 穩定性、MCP 連線可靠性、fullscreen TUI 互動、hooks matcher、voice dictation，以及企業/受管環境下的權限與模型限制提示。整體來看，Claude Code 2.1.x 仍在快速補齊「多 agent、遠端 session、MCP、plugin、sandbox」這些複雜功能交會處的邊界案例。

版本詳情

v2.1.187：安全、結構化輸出與 Remote/MCP 穩定性

v2.1.187 的重點是安全控制與長時間阻塞修復。

主要變更包括：

• 新增 sandbox.credentials 設定，可阻止 sandboxed commands 讀取 credential files 與 secret environment variables。
• 模型選擇器、--model、/model、ANTHROPIC_MODEL 開始支援組織層級的模型限制，受限模型會顯示「restricted by your organization’s settings」。
• fullscreen mode 的選單開始支援滑鼠點擊。
• 修正 --resume 在原本 -p run 沒有產生 model turns 時回報 No conversation found 的問題。
• 修正 --json-schema 與 workflow agent({schema}) structured output 可能反覆呼叫 StructuredOutput 的問題。
• Remote MCP tool call 若 5 分鐘無回應，現在會 abort，而不是無限卡住；可用 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 調整。
• 修正 Claude Code Remote 啟動因 agent proxy CA system-trust install 額外變慢約 2.7 秒。
• 修正 CJK/Korean pasted text 在部分 terminal 中變成 mojibake。
• 修正 agents view 裡 background job 長時間停在 working 的問題。
• 修正 killed agents 留下 locked .git/worktrees/ registration 的清理問題。
• /install-github-app 現在可只安裝 GitHub App，略過 GitHub Actions workflow/secret 設定。

這版可以視為「多 agent + remote + structured output」的可靠性修補版，尤其對自動化工作流與 MCP 使用者影響較大。

v2.1.190：小型可靠性修補

v2.1.190 release notes 僅列出：

• Bug fixes and reliability improvements

從時間點看，這應是 v2.1.187 到 v2.1.191 之間的快速修補版本，沒有公開細項。

v2.1.191：/rewind、背景 agent 與 MCP retry 改善

v2.1.191 是本輪更新中相當重要的一版，集中處理 TUI、background agents、MCP 與長 session 效能。

主要變更包括：

• 新增 /rewind，可從 /clear 之前的狀態恢復 conversation。
• 修正 streaming response 期間閱讀早期輸出時，scroll position 會跳回底部的問題。
• 修正已停止的 background agents 會「復活」的問題；從 tasks panel 停止後現在會永久停止。
• /voice 若被組織政策停用，會顯示具體限制原因，而不是泛用的「not available」。
• 修正 Windows Terminal 中 /login URL 換行後被截斷的問題。
• 修正 Ghostty over ssh/tmux fullscreen mode 下 Cmd+click links。
• 修正 hooks comma-separated matchers，例如 "Bash,PowerShell"，過去可能完全不觸發。
• /permissions Recently-denied tab 中核准 denial 後，現在會正確持久化。
• MCP capability discovery（tools/list、prompts/list、resources/list）遇到 transient network errors 會短暫 backoff retry。
• MCP OAuth discovery/token requests 遇到 transient network errors 會 retry；headless 環境會直接進入 paste-the-URL flow。
• HTTP 404 MCP error message 現在會顯示 URL 並指向 MCP config。
• streaming responses 的 CPU 使用量約降低 37%。
• 降低 long-session terminal output cache 的記憶體成長。

這版的方向很清楚：Anthropic 正在把 Claude Code 從「功能能用」推向「長時間使用也穩定」。/rewind 對重度使用者尤其重要，因為它降低了 /clear 後無法回頭的風險。

v2.1.193：auto-mode、OpenTelemetry、bash autocomplete 與背景任務修補

v2.1.193 的主軸是安全分類、可觀測性與背景任務管理。

主要變更包括：

• 新增 autoMode.classifyAllShell，可讓所有 Bash/PowerShell command 都經過 auto-mode classifier，而不只針對 arbitrary-code-execution patterns。
• auto-mode denial reasons 現在會出現在 transcript、denial toast 與 /permissions recent denials。
• 新增 claude_code.assistant_response OpenTelemetry log event，可記錄 model response text。預設會依 OTEL_LOG_USER_PROMPTS 行為而定；若不想記錄 response，可設 OTEL_LOG_ASSISTANT_RESPONSES=0。
• bash mode（!）新增 live file path autocomplete。
• MCP servers 需要 authentication 時，啟動時會提示並指向 /mcp。
• 新增 idle background shell commands 的 memory-pressure 自動 reaping，可用 CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 關閉。
• 修正 /model 等 client-data-gated UI 在 /login 後顯示 stale/empty state。
• 修正 backgrounding 主回合時，可能產生 phantom general-purpose (resumed) subagent 並重跑主 conversation。
• 修正 pinned background agents 在每次 auto-update 後反覆被要求 Continue from where you left off。
• 改善 background agents：launch result 不再要求 Claude 「end your response」，而是讓主流程可繼續處理其他工作。
• MCP headersHelper auth 遇到 401/403 時會自動重跑並 reconnect。
• marketplace plugin rename maps 現在會自動套用，更新 settings 到新名稱。

值得注意的是 OpenTelemetry response logging 的變更：對企業或受監管環境而言，這是需要仔細檢查的項目。若既有部署已記錄 user prompts，升級後可能也開始接收 assistant response content；這是實務上需要在 release rollout 前確認的隱私與合規設定。

v2.1.195：滑鼠控制、hyphenated hook matchers、voice 與 plugin 修補

最新 v2.1.195 主要修補 v2.1.19x 中仍然活躍的互動與背景任務問題。

主要變更包括：

• 新增 CLAUDE_CODE_DISABLE_MOUSE_CLICKS，可在 fullscreen mode 停用 mouse click/drag/hover，但保留 wheel scroll。
• 修正 hyphenated hook matchers，例如 code-reviewer、mcp__brave-search，過去可能被 substring match；現在改為 exact match。若要匹配 hyphenated MCP server 的所有 tools，需使用 mcp__brave-search__.*。
• 修正 macOS voice dictation 在長 session 中，預設輸入裝置改變後會錄到 silence 的問題。
• 修正日文、中文、泰文等不以空格分詞的語言中，voice dictation auto-submit 不觸發的問題。
• 修正只透過 project .claude/settings.json 啟用的 external plugins，在某些 loader path 下未要求 explicit install consent 的問題。
• 修正 /plugin Enable/Disable 在 plugin.json name 與 marketplace entry name 不同時失效。
• 修正由較新版 Claude Code 寫入的 background jobs，在 claude agents 中消失或遺失資料。
• 修正 crashed background task 重新開啟時短暫 blank screen。
• 修正 background agent daemons 在 control socket 啟動失敗後變成 unreachable，並阻擋 restart。
• Linux voice mode 現在可區分「沒有 microphone」與「SoX 未安裝」。
• claude agents completed list 會更充分利用 terminal 高度。
• Remote session startup 加入 provisioning checklist。

這版對 TUI 使用者有一個實用緩解：如果近期 mouse click 在 selection prompt 中誤觸，現在可以透過 CLAUDE_CODE_DISABLE_MOUSE_CLICKS 關閉點擊而保留滾輪，避免把 fullscreen scrollback 一起犧牲掉。

GitHub Issues 動態

過去四天監控到約 199 個 issue，主題高度集中在幾個區塊：背景 agents、MCP/auth、cost/token usage、TUI/fullscreen、Desktop/Cowork、模型選擇與長 context。

1. 背景 agents 與 agent view 仍是高活躍區

多個 issue 指向 background agents 在不同 host/session 下仍有不一致行為：

• #71644：Subagents going idle
• #71723：Agent tool name parameter 可能切到 teammate protocol，導致 background agent results 遺失
• #69691：run_in_background:false 在不同 session host 下不一定可靠
• #71292：希望 Agent/Task-tool-spawned subagents 有 dispatch-time stable label
• #71709：swarm/multi-agent 希望顯示 session name，而不是 raw tmux command，並自動清理完成的 agents
• #69829：高併發 agent harness 下出現 random text insertion

對照 v2.1.191、v2.1.193、v2.1.195 的 changelog，可以看出 Anthropic 正在快速修補 background agents 的生命週期問題，例如停止後復活、phantom resumed subagent、crashed task blank screen、jobs disappearing 等。但 issue 動態也顯示，多 agent 執行模型仍是 Claude Code 當前最複雜、也最容易出現邊界案例的區域。

2. MCP 與 auth：可靠性改善，但 connector 問題仍多

本輪 release 對 MCP 做了不少改善：timeout、capability discovery retry、OAuth retry、HTTP 404 訊息、401/403 後 headersHelper reconnect 等。不過 GitHub Issues 中 MCP/auth 仍非常活躍：

• #70386：HTTP MCP client drops Mcp-Session-Id header
• #67194：Streamable HTTP client mis-correlates JSON-RPC error body
• #70639：MCP GetLiveContext schema serialized as invalid JSON
• #71725：GitHub MCP Server connection failed
• #71711：Gmail connector 在 CLI 不出現，但 Calendar/Drive 正常
• #71675：/mcp 要求 authenticate Gmail server，但選項未列出
• #71649：claude.ai managed connector 無法從 CLI re-attach
• #60252：--strict-mcp-config 搭配 empty config 仍 fetch registry（已關閉）

這些問題透露出 MCP 不只是 protocol client 的問題，也牽涉 connector lifecycle、OAuth state、managed connector 與 CLI/desktop/web 之間的狀態同步。v2.1.193 的 headersHelper 401/403 自動重跑，是往正確方向前進，但 connector recovery path 仍可能是接下來幾版的重點。

3. cost/token usage 與長 context 仍是使用者最敏感議題

近期 issue 中，cost 與 usage limit 相關討論仍然密集：

• #16157：Max subscription usage limits 異常快速耗盡，已有大量留言
• #38335：Max plan session limits 自 3 月後異常快速耗盡
• #42249：Extreme token consumption
• #70459：Auto-compaction 造成高 token 成本的複合問題
• #71478：VS Code extension resumes huge sessions without warning，快速耗盡 Max usage
• #71476：Team subscription 被計到 API credits
• #71474：相似工作負載下 token usage reporting 不一致
• #71461：Fleet mode 在簡單 type-checking task 上消耗過多 token

v2.1.191 降低 streaming CPU 與 long-session memory growth，v2.1.193 加入 idle background shell reaping，但這些並不直接解決 token governance。從 issue 量來看，使用者期待更透明的 token attribution、session resume warning、compact lifecycle control，以及更可預期的 Max/Team 計費行為。

4. TUI/fullscreen：滑鼠、scrollback、輸入法與多語系問題浮現

TUI 相關 issue 延續高頻：

• #71468：selection prompts 被 accidental mouse clicks 誤觸，但 mitigation 會破壞 fullscreen scrollback
• #71465：Terminal.app v2.1.193 mouse clicks 不回應
• #71713：fullscreen mode auto-scroll 阻止 manual scrolling
• #70309：長 scrollback 無法快速 seek/jump
• #71712：貼上 Thai/multibyte UTF-8 造成 mojibake
• #67576：Windows copy-on-select OSC 52 無法進入 RDP clipboard redirection
• #21867：希望可隱藏 token counter 與 version display

v2.1.195 新增 CLAUDE_CODE_DISABLE_MOUSE_CLICKS 明顯是針對這一波 mouse-related regression 的緩解。另一方面，v2.1.187 修 CJK paste、v2.1.195 修 voice dictation 的中文/日文/泰文 auto-submit，顯示多語系與 terminal input path 正在被逐步補強。

5. Desktop/Cowork 與 Windows ARM64 仍有長尾問題

Desktop 與 Cowork 相關 issue 仍集中在 Windows、ARM64、auth、更新與 process lifecycle：

• #50674：Snapdragon X ARM64 Cowork fails，即使 readiness check 通過
• #70468 / #71475：CoworkVMService 與 Windows update/MSIX 更新互相影響
• #71424：Desktop local-agent Cowork sessions leak claude-code node processes
• #54179：同一 remote host 多個 Desktop GUI SSH session 互相 invalidates auth token
• #71722：Open in desktop app blank window 並 hang app
• #54461：Desktop app 無法 change primary working directory 或 open new chat
• #53247：Windows Desktop orphaned Silo / Job Object 導致 launch failure

這些問題多半不只是 Claude Code CLI 本身，而是 Desktop app、Cowork VM、Windows app packaging、remote auth token 與 local agent process management 的交界。短期內可能仍會以小步修補為主。

6. 模型選擇、1M context 與 model behavior 爭議持續

模型與 context window 相關 issue 也很顯眼：

• #36351、#68287、#69109、#69444：1M context / Opus 4.8 options 在 Desktop 或 model picker 中消失
• #68780、#70267：使用者回報 Opus 4.8 reasoning degradation 或速度退化
• #70469、#63879：tool invocation markup / XML namespace 相關模型輸出問題
• #71671、#71716、#71714：模型忽略 memory/user instructions、過度複雜化回應等行為回報

v2.1.187 新增 org-configured model restrictions 顯示 Anthropic 正在強化 model picker 與組織政策整合；但 model availability、context window entitlement、Desktop/CLI 顯示一致性，仍是目前使用者最容易困惑的地方之一。

總結與觀察

這三天的 Claude Code 更新呈現出三個趨勢。

第一，Claude Code 正在從單一 CLI 工具變成多介面、多 agent、多 connector 的平台。背景 agents、Remote sessions、Desktop/Cowork、MCP、plugins、OpenTelemetry、受管設定與組織政策都在同時演進。這帶來更強的自動化能力，也讓狀態同步、權限、auth、長 session 穩定性變得更難。

第二，Anthropic 正在優先處理「長時間使用會壞掉」的問題。例如 background agents 停止後復活、jobs disappearing、phantom resumed subagent、memory growth、idle shell reaping、MCP hanging、Remote startup checklist 等，都是重度使用者才會頻繁碰到的問題。這說明 Claude Code 的使用場景正在往長時間、多任務、半自主化工作流前進。

第三，企業與安全導向功能變得更明顯。sandbox.credentials、org-configured model restrictions、auto-mode shell classification、denial reasons、OpenTelemetry assistant response event、plugin install consent、MCP auth startup notice，都是面向治理、稽核與受控環境的改動。不過 OpenTelemetry response logging 的預設互動值得管理者注意，升級前應確認 OTEL_LOG_ASSISTANT_RESPONSES 與既有 prompt logging 策略是否一致。

總體而言，v2.1.187 到 v2.1.195 不是功能爆發期，而是平台穩定化期。對一般使用者來說，最有感的是 /rewind、TUI scroll/mouse 修補、MCP 連線改善與 voice dictation 修正；對重度自動化使用者來說，background agents 的修補與 OpenTelemetry 變更更值得關注。短期內，Claude Code 的下一波重點很可能仍會圍繞 agents lifecycle、MCP/auth recovery、token usage transparency，以及 Desktop/Cowork 的跨平台穩定性。