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

版本更新摘要

過去三天 Claude Code 從 v2.1.185 推進到 v2.1.187，節奏仍以 patch 版本為主，但內容並不只是小修小補。v2.1.185 聚焦於 API 無回應提示的 UX 調整；v2.1.186 是一次較大的可用性與代理工作流修補，涵蓋 MCP CLI 登入、背景 agent、plugin、workflow、subagent 權限與 TUI 細節；v2.1.187 則明顯轉向安全控管、組織政策、sandbox credentials、structured output、Remote / MCP 穩定性與 worktree 清理。整體看來，Claude Code 團隊正在同時補強三條主線：企業治理、安全邊界，以及多代理 / 遠端工作流的可靠性。

版本詳情

v2.1.185：調整 API 等待提示，降低誤導感

v2.1.185 的變更很小，但對使用體感有意義：

• stream-stall 提示從原本的：
  • No response from API · Retrying in …
• 改為：
  • Waiting for API response · will retry in …
• 觸發時間從 10 秒延後到 20 秒。

這代表 Claude Code 不再過早把暫時無串流輸出描述成「API 沒回應」。在近期 Issues 中，API timeout、rate limit、connection closed、service unavailable 類回報不少，這類措辭調整雖然不等於修復底層連線問題，但能降低使用者誤判：有些情況只是模型或 API 尚未回傳 token，而不是立即進入錯誤狀態。

v2.1.186：MCP、agent、plugin 與背景任務大幅修補

v2.1.186 是本期最密集的一版，功能新增與 bug fix 都集中在 Claude Code 近期快速擴張的工作流上。

主要新增：

• 新增 claude mcp login <name> / claude mcp logout <name>，可直接從 CLI 認證 MCP server，不必進入互動式 /mcp 選單。
• 支援 --no-browser 與 stdin redirect，對 SSH / headless 環境更友善。
• /workflows agent detail view 新增狀態過濾，可按 f 篩選。
• /plugin Installed tab 新增「Skills」區塊。
• 新增 teammateMode: "iterm2" 設定，auto mode 找不到 it2 CLI 時會提出警告。
• /login 在設定 awsAuthRefresh 時新增「Claude Platform on AWS - refresh credentials」選項。
• ! bash commands 現在會讓 Claude 自動回應輸出；若要維持舊行為，可在 settings.json 設定 "respondToBashCommands": false。

重要修復：

• 修復機器從 sleep 喚醒後 streaming request 出現 Content block not found 或 JSON parse error。
• 修復 subagent transcript scroll position 影響主 transcript 的問題。
• 修復背景任務預覽在 agent plan 載入前短暫閃出 raw tool name。
• 修復 concurrent CLI sessions 下 Chrome tab-group isolation 未正確套用。
• 修復 background session recap 重複出現。
• 修復 Agent(type) deny rules 與 Agent(x,y) allowed-types restrictions 沒有套用到 named subagent spawns。
• 修復背景 agent 還在執行時，Esc / Ctrl+C 無法回應的問題。
• 修復 Workflow agent({schema}) 在 schema validation failure 時無限重試，改為 5 次後 abort。
• 改善 malformed SKILL.md YAML frontmatter：不再靜默失敗，而是以空 metadata 載入 skill body。
• 將 CLAUDE_CODE_MAX_RETRIES 上限設為 15；無人值守情境建議改用 CLAUDE_CODE_RETRY_WATCHDOG。
• 背景 subagent 的 permission prompt 改為回到 main session 顯示，而不是自動 deny。

這一版的核心觀察是：Claude Code 的 agent / workflow / plugin / MCP 生態已經複雜到需要更多「失敗可見性」與「權限路由」。特別是背景 subagent permission prompt 不再自動 deny，代表 Anthropic 正在修正多代理工作流中常見的黑箱失敗。

v2.1.187：安全、組織政策、structured output 與 Remote 穩定性

v2.1.187 延續 v2.1.186 的修補方向，但安全與企業治理色彩更重。

主要新增：

• 新增 sandbox.credentials 設定，可阻擋 sandboxed commands 讀取 credential files 與 secret environment variables。
• model picker、--model、/model、ANTHROPIC_MODEL 現在會套用組織設定的 model restrictions。
• 若選到受限制模型，會顯示「restricted by your organization’s settings」。
• fullscreen mode 的 select menus 支援滑鼠點選，包括 permission prompts、/model、/config 等。

重要修復：

• 修復 --resume 在原本 -p run 沒有 model turns 時出現 No conversation found。
• 修復 --json-schema 與 workflow agent({schema}) structured output：
  • 模型不再能在成功後無限 re-call StructuredOutput。
  • follow-up turns 現在能可靠回傳 structured output。
• 修復 remote MCP tool calls 卡住 5 分鐘沒有回應時會無限阻塞；現在會 abort with error。
  • 可用 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 覆蓋。
• 修復 Claude Code Remote sessions 因 agent proxy CA system-trust install 多出約 2.7 秒啟動延遲。
• 修復 Korean / CJK paste 在特定 terminal 中變成 mojibake。
• 修復 /update over Remote Control 因 startup trust dialog 而 hang。
• 修復 agents view 中 background jobs 在 agent 沒有 structured output 時永久停在 working。
• 修復切換 agents view、/bg、/tui、/update 後 channel connection drop。
• 修復 resumed / forked subagent 的 depth tracking。
• 修復 killed agents 遺留 locked .git/worktrees/ entries，現在會自動清理。
• 修復 claude --help 未列出 --bg / --background。
• 修復 /share uploading 時 Esc、Ctrl-C、Ctrl-D 無效。
• /install-github-app 現在可只安裝 GitHub App，略過 GitHub Actions workflow / secret 設定。
• /plugin 會提示近期未使用的 plugin，方便清理。
• VS Code extension 修復 resume large session 時變得無回應。

這一版值得注意的是 sandbox.credentials。在 agent 能執行 shell、讀檔、呼叫 MCP tools 的前提下，credential boundary 是企業採用的關鍵。v2.1.187 把 sandbox 從「限制執行環境」推進到「限制憑證可見性」，是安全模型上較實質的一步。

GitHub Issues 動態

本期 4 天 GitHub 監控共累計 199 個 Issues，量體仍高。Issue 主題大致可分成幾個群組。

1. MCP / OAuth / auth 仍是高頻痛點

多個 Issues 指向 MCP 認證、OAuth flow、HTTP MCP client 與 plugin MCP registration：

• #69758：HTTP MCP server 希望 Authorization header 為空時可 fallback 到 OAuth。
• #69746：VS Code extension 的 MCP OAuth flow 送出 malformed resource parameter。
• #69917：Claude Code MCP OAuth 因 protected-resource path mismatch abort。
• #69035：Atlassian MCP authv2 失敗，但 SSE endpoint 可用。
• #70162：Desktop 中 marketplace plugin 的 HTTP MCP server 被計數但未註冊 connector。
• #70167：ToolSearch load 後 deferred tool regression，MCP Jira tool 被空參數呼叫。
• #70386：HTTP MCP client 遺失 Mcp-Session-Id header，導致 session-aware server 失敗。
• #67194：Streamable HTTP client 將 405 GET SSE response 誤關聯到 pending tools/list。

v2.1.186 新增 claude mcp login/logout，v2.1.187 修復 remote MCP tool idle timeout，顯示官方確實在處理 MCP 操作面與可靠性。但 Issues 顯示 MCP 問題已從「能不能連上」進入更細的 protocol compatibility、OAuth resource handling、session header、plugin registration 階段。

2. Agent / subagent / worktree 問題仍活躍

近期 agent 相關 Issues 包括：

• #69943：subagents 應繼承 worktree cwd 與 permission scope，而不是重設到 main repo。
• #68619：subagent spawning / subagent pattern bugs 造成 infinite recursion、token 浪費與工作遺失。
• #70156：subagents 在 worktree 中等待 MCP server approval 而卡住。
• #70170：背景 agent session 無法用 --resume <id> reclaim。
• #70467：worktree session names 應顯示 task content，而不是 hostname-based branch names。
• #70466：EnterWorktree 未處理 .worktreeinclude。
• #70472：memory instructions 需要釐清 host 已提供 session-level memory 時的 precedence。

v2.1.186 修了 named subagent 權限限制、permission prompts、agent schema loop；v2.1.187 又修 depth tracking、worktree registration leaks、agents view stuck working。這些變更與 Issues 高度對應，代表 Anthropic 正在快速補齊 agent orchestration 的邊界條件。

3. Remote Control / Desktop / iOS 穩定性壓力上升

Remote、Desktop、Cowork 與 mobile app 相關問題也很密集：

• #69807：Desktop 更新後 Cowork / Code sessions hang on load。
• #69764：Phone/app session transcript 未 persist，造成 data-loss。
• #70165、#70182、#70288：iOS app 開啟或連接 Remote Control session 崩潰。
• #70471：Windows Dispatch 顯示「Can’t reach your desktop」。
• #70468：Windows ARM64 Surface Pro 上 CoworkVMService 被 auto-update kill。
• #70461：Desktop SSH remote 經 JumpServer/Koko bastion 時 SFTP upload 失敗。
• #53717、#69003：Windows desktop session / sidebar history / message content 遺失，帶有 data-loss 性質。

v2.1.187 修了 Remote session 啟動延遲、Remote Control /update hang、channel connection drop，以及 VS Code large session resume unresponsive。這些修補有幫助，但 mobile / desktop / cowork 跨平台狀態同步與 session persistence 看起來仍是主要風險區。

4. API / rate limit / streaming 錯誤仍大量出現

本期仍有多個 API 層問題：

• #69358：2.1.181 / 2.1.183 持續 No Response From API。
• #69945、#70082、#70183、#53915：rate limited / temporarily limiting requests。
• #69942：Service Unavailable。
• #69944：Insufficient Context。
• #69336：Connection closed mid-response。
• #70171：API timeout / retry loop with zero-second delay。

v2.1.185 將等待提示延後並改字眼，v2.1.186 修 sleep 後 streaming JSON parse / content block 問題。這顯示官方同時在做兩件事：一是改善錯誤呈現，二是修復特定生命週期事件（例如 sleep wake）造成的 streaming 狀態損壞。不過 Issue 數量顯示 API 穩定性在使用者端仍是可見痛點。

5. 安全、權限與組織治理開始成為主題

本期有幾個值得特別標出的安全 / governance 類 Issues：

• #70184：共享 / HPC infrastructure 需要不可被 user org settings 覆蓋的 machine-level policy。
• #70181：server-managed settings 為空時清空 local managed-settings，導致 deny / allow rules 不生效。
• #69946：prompt guidelines 缺少 security documentation。
• #21531：BeforeModel / AfterModel hooks 作為 LLM request / response interception。
• #10223：default cloud environment 的 network behavior 與 UX 不清楚。
• #57153、#30944、#31675：permissions / settings / docs 相關缺口。

v2.1.187 加入 sandbox.credentials 與 org-configured model restrictions，正好回應企業管理者關心的兩件事：模型可用範圍與憑證外洩面。這可能是 Claude Code 從個人 CLI 工具走向團隊 / 企業級 agent runtime 的必經階段。

總結與觀察

本期 Claude Code 的更新雖然版本號只前進三個 patch，但方向相當清楚：Anthropic 正在把產品從「互動式 coding assistant CLI」推向更完整的 agent orchestration platform。這也帶來新的穩定性與治理挑戰。

幾個趨勢值得注意：

1. MCP 已成為核心戰場
   新增 CLI login/logout、修 idle timeout、處理 plugin MCP 與 OAuth 問題，顯示 MCP 已不再是周邊功能，而是 Claude Code 擴充能力的主幹。不過 Issues 顯示各家 MCP server 的 OAuth、session、HTTP streaming 行為仍有不少相容性落差。

2. 背景 agent 與 structured output 正在快速成熟
   v2.1.186 / v2.1.187 都大量修補 agent、workflow、schema、permission prompt、depth tracking、worktree cleanup。這些不是單一 UX bug，而是多代理系統要可靠運作所需的基礎工程。

3. 安全與企業政策開始進入產品核心
   sandbox.credentials、org-configured model restrictions、server-managed settings 相關 Issues，都指向同一個方向：Claude Code 需要在「能幫你動手做事」與「不能讀到不該讀的秘密」之間建立更清楚的邊界。

4. Desktop / Remote / mobile 的跨平台狀態同步仍是高風險區
   iOS crash、Remote Control hang、CoworkVMService、session persistence、data-loss 類 Issues 還不少。Claude Code 的遠端與桌面整合正在擴張，但可靠性仍需要時間追上 CLI 核心。

整體而言，v2.1.185 到 v2.1.187 不是功能爆炸式更新，而是一次針對「長時間、多代理、遠端、企業化使用」的基礎修補週期。若你主要使用 Claude Code 的單機 CLI 流程，本期最直接感受到的可能是提示更準確、TUI 細節更穩；若你重度使用 MCP、background agents、Remote Control、plugin 或 workflow，這幾版則值得盡快更新，因為不少修復都直接針對卡死、權限、structured output 與 session 狀態問題。