Claude Code 版本彙整：2026/07/08 - 2026/07/11

版本更新摘要

過去三天 Claude Code 維持高頻 patch 節奏，從 v2.1.204 推進到 v2.1.207，更新重心明顯集中在三條主線：背景代理與 agent view 穩定性、權限與安全邊界修正、以及 TUI／遠端控制／雲端供應商體驗改善。其中 v2.1.205 與 v2.1.206 是較大型的修補版本，涵蓋 background agents、worktree、MCP、/doctor、/model、Remote Control 等多個子系統；v2.1.207 則進一步修正終端卡頓、prompt-injection 誤報、managed settings 同意流程、plugin shell injection，以及 Bedrock／Vertex／Foundry 上 auto mode 的預設可用性。

版本詳情

v2.1.204：修正 headless SessionStart hook 串流問題

v2.1.204 是一個非常聚焦的修補版，主要修正：

• SessionStart hooks 在 headless sessions 中未串流 hook events
  • 這可能導致 remote workers 在 hook 執行期間被誤判為閒置，進而被 idle-reaped。
  • 對依賴 headless 自動化、遠端 worker 或 CI-like Claude Code 執行環境的使用者來說，這是穩定性修補。

這個版本雖小，但反映 Claude Code 近期對「非互動式／背景執行」場景的持續補強。

v2.1.205：背景代理、worktree、JSON schema 與 /doctor 大量修補

v2.1.205 是本輪最密集的修補之一，主要變更包括：

• Auto mode 安全規則

  • 新增規則，阻擋對 session transcript files 的竄改。
  • 改善 auto mode 對無法解析變數的 rm -rf 操作：會先詢問，而不是直接執行。

• JSON schema 修正

  • 修正 --json-schema 在 schema 無效時默默輸出非結構化內容的問題。
  • 修正使用 format keyword 的 schema 被拒絕的問題。

• 訊息與背景代理可靠性

  • 修正 Claude 正在工作時送出的訊息，若回合因 --max-turns 結束而被靜默遺失。
  • 修正 background agents 被 SendMessage resume 後，agent list 仍顯示為 failed 或 completed。
  • 修正 background jobs 在沒有可讀文字時，狀態從 needs input 跳回 working。
  • 修正 claude attach 遇到背景 agent 正在升級重啟時直接報錯，現在會等待恢復。

• Windows 與 worktree 資料安全

  • 修正 Windows worktree removal 在 NTFS junction 或 directory symlink 存在時，可能刪除 worktree 外部檔案的嚴重問題。
  • 這類 data-loss 類修補值得特別注意，因為同期 GitHub Issues 也出現多起 worktree／主工作目錄資料受影響的回報。

• MCP 與 plugin/LSP

  • 修正 claude mcp add-from-claude-desktop 在 server name 含不支援字元時卡住。
  • 修正某 plugin LSP server 初始化失敗時，阻止另一個合法 LSP server 處理相同副檔名的問題。
  • 保留 "Claude Browser" MCP server name，為 Claude Desktop pane rename 預作準備。

• Agent view 改善

  • rows 改顯示彩色狀態文字與 classifier-written headline，而非 raw tool call text。
  • blocked sessions 的 peek 會顯示完整狀態與具體等待使用者回答的問題。
  • 編輯、merge、comment、push 到既有 PR 的 session，現在會在 claude agents 中連結該 PR。

• /doctor 擴充

  • /doctor 成為完整 setup checkup，可診斷並修復問題。
  • /checkup 成為 alias。

• Auto-updater 記憶體改善

  • binary download 改為 stream to disk，不再整包 buffer 到記憶體。
  • 官方稱 peak memory usage 約降低 400 MB。

整體來看，v2.1.205 是一次針對「背景工作流程」和「工具鏈可靠性」的大範圍穩定化。

v2.1.206：/cd、/doctor、MCP timeout、背景升級與 auth 修補

v2.1.206 繼續補強 CLI 體驗與 background agents：

• 路徑與設定體驗

  • /cd 新增 directory path suggestions，行為對齊 /add-dir。
  • /doctor 新增檢查：建議修剪 checked-in CLAUDE.md 中可由 codebase 推導的內容。

• Git／PR 流程

  • /commit-push-pr 現在除 origin 外，也會 auto-allow repo 設定的 push remote，例如 remote.pushDefault，或只有單一 remote 時的該 remote。

• Gateway 與登入

  • Gateway /login 支援 Anthropic-operated public gateway endpoints。
  • 修正 login 過期時，所有模型都顯示誤導性的「There’s an issue with the selected model」，現在會提示執行 /login。

• Worktree 安全

  • EnterWorktree 在進入專案 .claude/worktrees/ 以外的 git worktree 前，會要求確認。

• Background agents 升級

  • Claude Code 更新後，background agents 會在背景自動升級到新版本。
  • 這避免使用者 attach 時才遇到 stale-session upgrade 的延遲。

• 啟動與輸入修正

  • 修正 claude --resume 和 --continue 啟動時不回應鍵盤輸入。
  • 修正 Windows 上 setup prompt 出現時，agents view 忽略鍵盤輸入。

• MCP 修正

  • 修正透過 --mcp-config 或 .mcp.json 設定的 MCP server 忽略 request_timeout_ms，導致新 session 中長時間工具呼叫仍被 60 秒預設 timeout 切斷。
  • 修正 OAuth MCP servers 在一次 token refresh 失敗後，需要手動重新驗證。
  • 修正 --permission-prompt-tool 指向 MCP server 時，cold start 尚未連線完成就因「MCP tool not found」崩潰。

• 模型選擇器

  • 修正 /model picker row 顯示的價格與模型名稱不一致。
  • 修正 server-provided model rows 在 entitlement 或 allowlist restriction 下排序錯位。

• Agent view 與 Remote Control

  • 修正 claude rm 後 daemon roster 仍保留 removed job，導致 row 重新出現。
  • 修正 /remote-control 在登出時只顯示 Unknown command，現在會說明如何登入。
  • agents view 狀態欄使用完整 terminal width，不再截斷於 64 字元。
  • Ctrl+X 現在可永久移除 completed session，且已刪除 background jobs 不再重複出現。

v2.1.206 的重點是「讓背景代理與周邊工具更可預期」，特別是 MCP timeout、OAuth refresh、resume 鍵盤輸入與 agent 列表同步這些長尾問題。

v2.1.207：Auto mode 擴大、終端效能、安全同意與 plugin shell injection 修補

v2.1.207 是本期最新版本，也包含多個值得注意的安全與 UX 修正：

• Auto mode 擴大可用性

  • Bedrock、Vertex AI、Foundry 上不再需要 CLAUDE_CODE_ENABLE_AUTO_MODE opt-in。
  • 可透過 settings 的 disableAutoMode 關閉。
  • 同時，auto mode 不再讀取 repo-resident .claude/settings.local.json 中的 autoMode，改用 ~/.claude/settings.json。

• 終端效能修正

  • 修正串流輸出很長的 list、table、paragraph 或 code block 時，terminal freezing 與 keystroke lag。
  • 修正回應串流結束時 transcript 跳到答案開頭上方的問題。

• Prompt-injection 與 consent

  • 修正 benign system-generated conversation updates 觸發 spurious prompt-injection warnings。
  • 修正非互動式執行（claude -p、SDK）取得的 remote managed settings 被永久記錄為已同意，但實際上從未顯示 security consent dialog 的問題。

• Auto-updater 與 launcher

  • 修正 auto-updater 每次 release 都覆寫 ~/.local/bin/claude 自訂 launcher script 或 symlink。
  • /doctor 現在會回報 externally managed launcher。

• 權限與 shell command 判斷

  • 修正含 cd 的 compound commands 在唯一 output redirect 是 /dev/null 時仍要求 permission。
  • plugin hooks／monitors／MCP headersHelper 中，shell-form commands 使用 ${user_config.*} 現在會被拒絕，這是 shell-injection 修補。
  • Hooks 應改用 exec form（args array）或 $CLAUDE_PLUGIN_OPTION_<KEY>；monitors 與 headersHelper 則應在 script 內讀 config 或 server env。

• Worktree 與 ignore pattern

  • 修正 extensions.worktreeConfig 在最後一個 worktree.sparsePaths worktree 移除後仍殘留於 repo .git/config，導致 go-git tools 如 tea 出問題。
  • 修正 rules globs、skill paths、.ignore、.worktreeinclude 中 malformed bracket patterns 造成 file reads、file suggestions、worktree creation 失敗。

• Background agents 與 agent teams

  • 修正 malformed teammate mailbox message 導致 agent teams 每秒重複錯誤的 crash loop。
  • 修正 background sessions 接受 plan 後自動命名，但 agent-view row 未顯示名稱。
  • 修正 background sessions 進入 git worktree 後，從 agent list cold reopen 會恢復成空白歷史。
  • blocked session peek 現在優先顯示問題，並以 waiting 3m 這類文字顯示等待時間。

• Remote Control

  • 修正網路中斷或 credential refresh 後，Remote Control task status updates 遺失。
  • 修正 Desktop-hosted Remote Control sessions 在 mobile/web 不顯示 background agent 與 workflow progress。

• Deep research 與 pasted text

  • Deep research Fetch-phase agents 不再全部標成 unknown，chips 會顯示來源 hostname。
  • agent view 中重複貼上相同文字，現在會展開 collapsed [Pasted text #N] placeholder，而不是新增第二個 placeholder。

• Bedrock／Vertex／AWS

  • Bedrock、Vertex、Claude Platform on AWS 預設模型改為 Claude Opus 4.8。
  • 修正 Bedrock 每次 API request 都向 IAM Identity Center 重新要求 AWS SSO credentials。
  • 修正 Windows 上 AWS credential resolution 卡住時無限等待，現在 60 秒 stall guard 會生效。

• Usage credits

  • /usage-credits 金額輸入不再默默把 malformed value（例如 timestamp）剝成數字。
  • malformed amounts 會直接報錯。
  • 超過 $1,000 的金額需要 typed confirmation。

v2.1.207 的訊號很明確：Claude Code 正在把「安全同意」、「本機設定與 repo 設定邊界」、「plugin 注入面」、「agent team crash loop」這些複雜風險往更保守、更明確的方向收斂。

GitHub Issues 動態

本期 GitHub 監控共涵蓋 4 天、約 199 個 issues。從標題與標籤來看，討論熱點集中在以下幾類。

1. Worktree 與資料安全仍是高風險區

多個 issue 指向 worktree、desktop app、背景 session 對工作目錄的處理仍有風險：

• #75490：Desktop app worktree mechanism wiped gitignored directories from MAIN working tree。
• #75911：Desktop app 的 worktree pool 可能在 session 仍使用時 reclaim／re-lease 目錄，甚至影響 main clone。
• #75929：進入 worktree 的 background session cold reopen 後恢復為空白歷史。
• #76221：subagent identity confusion，點擊 agent chip 可能把輸入導向 subagent，且環境與 parent session 近乎相同，造成身份邊界混淆。
• #76218：crash + --resume 後 task store 分裂，idle dispatcher 重新把 stale tasks replay 給 subagents。

v2.1.205 至 v2.1.207 已修正一部分 worktree 與 background session 問題，但從 issue 量來看，這仍是 Claude Code 目前最需要謹慎使用的區域之一，尤其是在 Desktop、background agents、Remote Control、worktree isolation 混用時。

2. 成本、token usage 與 session limit 爭議持續

成本相關 issues 仍大量活躍：

• #41506：Max Plan token usage 自 3 月底起增加約 3–5 倍。
• #38029：resume session 後 usage consumption 異常。
• #42249：正常使用下 quota 幾分鐘內耗盡。
• #67636：parallel agent spawning 導致 token consumption 暴增後崩潰或 hit limits。
• #66023：Workflow tool 一次 invocation 產生 46 個 Opus subagents，約 3M tokens，且缺少 cost confirmation。
• #38335：Max plan session limits 異常快速耗盡，討論數高達數百則。
• #76546：Claude Code 與 Claude App 顯示的 Fable subscription end dates 不一致。

這些回報與版本更新中的 /usage-credits 修正、/model picker 價格顯示修正、背景代理狀態修復形成呼應。Claude Code 的 agentic workflows 越強，成本可預測性就越重要；目前社群仍明顯希望看到更細緻的 usage analytics、per-session spend cap 與 agent spawning confirmation。

3. Model／safeguard false positives 仍頻繁

本期多個 issue 指向安全防護或模型判斷過度敏感：

• #75489、#75488、#75491：合法 reverse-engineering 或 repo analysis 被 cybersecurity safeguard 阻擋。
• #75932：Fable 5 safeguards 過度寬泛，阻擋例行 coding tasks。
• #75909、#76539、#76533、#76531：多起 security flag false positive。
• #74713：plan mode 被誤判為 prompt injection。
• #73909：合法 cryptography operations 被 safeguard 阻擋。

v2.1.207 修正了 benign system-generated conversation updates 引發 spurious prompt-injection warnings，這是正向訊號。不過 issues 顯示，模型層與政策層的 false positives 仍是影響開發者信任的重要問題，尤其是在資安、逆向工程、commerce debugging、license validation 等高敏感詞領域。

4. Agent view、background agents 與 Remote Control 是主要不穩定來源

本期大量 issue 與 agent view 或 background execution 有關：

• #74529：/resume 無法重新開啟有 live background tasks 的 sessions。
• #75043：nested subagents completion notifications 不會回到 parent，TaskStop resume 後出 ownership errors。
• #75928：agents-view composer 中「Paste again to expand」缺失。
• #75927：ultracode 未傳遞到 dispatched sessions。
• #76220：所有 sessions 顯示為 background agents，subagents 100% stall。
• #76534：gateway auth 下 background jobs 間歇性出現 synthetic “Not logged in”。
• #76530：Remote Control worker 死亡未 unregister，造成 phantom running 狀態且無恢復路徑。
• #76543：Claude Code web task list 依日期排序時缺少 project name。

版本更新確實大量集中在這一區：agent row 狀態、blocked session peek、stale session upgrade、background restart、Remote Control status updates、mobile/web progress forwarding 都被修補。這表示官方正在快速處理 agent workflow 的可觀測性與狀態一致性問題。

5. TUI、輸入、終端與可用性問題仍多

TUI 類問題也相當活躍：

• #75482：fullscreen 洩漏 OSC11/DA1 terminal query replies 到 stdout，污染 piped output 與 pager navigation。
• #75484：shell mode ! sticky re-entry 時游標位置錯誤。
• #75899：左箭頭意外導航到 agents screen，返回後破壞主 session view。
• #75182：AskUserQuestion 同回合前的 assistant text 未顯示。
• #74260：assistant text blocks 被靜默丟棄，未 render 也未寫入 transcript JSONL。
• #76536、#76537：使用者要求 sticky prompt／sticky todo list，以改善長輸出閱讀。
• #70539、#76528：希望有 scroll-only mouse mode 或可調 mouse interaction levels，避免 click 直接提交 prompt／permission dialog。

v2.1.207 修正長列表／表格／段落／code block 串流時 terminal freeze 與 keystroke lag，這對重度 CLI 使用者會很有感。但 AskUserQuestion、mouse interaction、文字區塊遺失與 terminal escape sequence 類問題仍值得追蹤。

6. MCP、plugins、skills 生態逐漸成為複雜度來源

MCP 與 plugin issues 也明顯增加：

• #75481：Zapier MCP OAuth loop。
• #75915：PreToolUse hook 的 updatedInput 在 sibling hook 回傳 ask 後被丟棄。
• #71792：development channels inbound notifications 未註冊。
• #76535：installed_plugins.json 缺失時，LocalPluginsReader 在 sendMessage 中 throw。
• #68936：marketplace.json 的 metadata.pluginRoot 被忽略。
• #76211：Always allow 將 $VAR references persist 成 literal __TRACKED_VAR__，導致 rule 永遠無法 match。
• #76541：Desktop /code-review ultra 靜默跑 local review，而不是 cloud ultrareview。

v2.1.206 修正多項 MCP timeout、OAuth refresh、permission-prompt-tool cold start 問題；v2.1.207 則加入 plugin shell injection 防護。這顯示 Claude Code 的擴充系統正在進入「功能成熟但安全與相容性成本上升」的階段。

總結與觀察

這一輪 v2.1.204 到 v2.1.207 的更新，表面上都是 patch release，但實際涵蓋範圍相當廣。Claude Code 目前的發展重心已不只是「CLI 會不會回答問題」，而是整個 agentic development environment 的穩定性：background agents、worktrees、Remote Control、MCP、plugins、managed settings、雲端 provider、usage credits、auto mode 都被納入同一套操作體驗。

幾個趨勢值得注意：

1. 背景代理正在成為核心能力，也成為主要 bug 來源
   從 agent view row 狀態、resume、cold reopen、nested subagents、Remote Control progress，到 cost explosion，background agents 是本期最密集的修補區。這代表 Anthropic 正積極推進長時間、多代理、自動化工作流，但狀態同步、身份邊界、成本控制和復原能力仍在快速迭代。

2. 安全邊界正在從「模型拒答」擴展到「工具與設定層」
   v2.1.207 的 plugin shell injection fix、remote managed settings consent 修正、auto mode settings 來源調整，都顯示 Claude Code 不再只依賴模型層防護，而是在 CLI、plugin、settings、updater、permission parser 層面建立更細的安全邊界。

3. Worktree 與資料安全會是企業採用的關鍵觀察點
   worktree isolation 是 parallel agent workflows 的基礎，但任何 data loss、main working tree 受影響、session 身份混淆都會降低信任。v2.1.205 的 Windows worktree removal 修正與 v2.1.207 的 worktree config cleanup，是重要改善，但 GitHub issues 顯示這一塊仍需要保守看待。

4. 成本可預測性仍落後於 agent 能力成長
   parallel agents、workflow scripts、背景 resume、model auto-switch、Fable／Opus usage attribution 等問題，讓許多使用者難以預估每次操作的 token 成本。/usage-credits 與 /model picker 修正有幫助，但更完整的 usage analytics、spend cap、agent fan-out confirmation 仍是社群持續要求的功能。

5. Claude Code 正在往多環境一致性前進
   Bedrock、Vertex、Foundry auto mode 開放，Gateway login 改善，AWS credential stall guard，MCP timeout 與 OAuth refresh 修補，都顯示 Claude Code 不只面向本機 npm CLI，而是在雲端、企業、桌面、web、mobile、Remote Control 間追求一致的開發體驗。

整體而言，這三天的更新不像單純的小修小補，而像是 Claude Code 在進入更大規模 agentic workflow 後的一次「穩定性補課」。對一般使用者來說，v2.1.207 值得更新，尤其是受 terminal 卡頓、background session blank resume、prompt-injection 誤報、Remote Control status loss、plugin shell injection 風險影響的人。不過若工作流高度依賴 worktree、nested subagents 或大規模 parallel agents，仍建議保持備份與明確成本監控，並密切留意後續版本是否繼續處理相關 issues。