Overview

這個版本在做什麼

2.1.147 是近期版本中修正規模最大的一次:30 條以上的 bug fix,橫跨 Windows、PowerShell、Plugin、Agent SDK、MCP 等各個子系統。新功能雖然只有幾項,但每一項都是「用了就回不去」那種等級的改善。

核心敘事是兩個方向的成熟:一是讓長時間運行的 agentic 工作流更可靠(背景 session 持久化、Auto-updater 改善);二是讓程式碼品質工具往「真正有用」邁近一步(/code-review 脫離清理模式,變成找邏輯 bug 的分析工具)。

Breaking Change + New Feature

/simplify 改名為 /code-review,行為全面翻新

這是這個版本最值得注意的一個變化。/simplify 指令已經被移除,取而代之的是 /code-review——但這不只是改個名字,連行為都換了。

項目 /simplify(舊) /code-review(新)
核心目標 清理程式碼、自動修正 找出正確性問題、回報 bug
行為 自動 cleanup-and-fix 分析後回報,不自動修改
Effort 等級 /code-review high 等可調
GitHub 整合 --comment 發 inline PR comment
# 預設審查(中等力度) /code-review # 高力度審查,找更多潛在問題 /code-review high # 審查結果直接發成 GitHub PR inline comments /code-review --comment # 高力度 + 發 PR comment 一起 /code-review high --comment

如果你的工作流有用到 /simplify,注意這個指令已不存在。/code-review 的目標是「找問題」而不是「自動修好」,這是一個刻意的設計轉向:分析和修復是兩件事,先把分析做好。

New Feature

背景 Session 可以 Pin 住了

Ctrl+T(在 claude agents 界面裡)可以把一個背景 session 標記為「pinned」。Pinned session 享有三個特權:

特權 1

閒置不回收

一般背景 session 閒置一段時間後會被自動關閉;pinned session 不受這個規則約束,永遠保持存活。

特權 2

就地重啟升級

Claude Code 有更新時,pinned session 會就地重新啟動(而不是被砍掉)來套用新版本,工作狀態不中斷。

特權 3

記憶體壓力下最後才被清除

系統記憶體緊張時,會優先回收非 pinned 的 session,pinned 的最後才動。

使用場景

長時間 Agentic 工作流

需要持續在背景跑的任務(如持續監控、CI 工具、長時間研究 session)特別適合 pin 住,確保不會意外消失。

Improvements

Auto-updater 錯誤處理大改

Claude Code 的自動更新器在這個版本做了明顯改善,主要針對更新失敗的情境:

new
網路暫時失敗時自動重試,不會因為一次連線問題就放棄更新。
new
更新失敗時回報具體的錯誤分類和 OS 錯誤代碼,方便診斷問題(之前只顯示模糊的「更新失敗」)。
new
更新失敗時同時顯示「目前版本是什麼」,讓你知道現在跑的是哪個版本。

此外還有兩個 QoL 改善:大型檔案的 diff 渲染效能提升;Prompt 歷史記錄不再重複記錄連續相同的輸入(用上鍵叫出上一個 prompt 再送出,不會再塞第二筆一樣的記錄)。

Notable Fix

Auto Mode 不再吃掉 AskUserQuestion

這個修正對寫 Claude Code skill/plugin 的開發者很重要。在 Auto Mode 下,如果 Claude 或某個 skill 呼叫了 AskUserQuestion,原本會被 auto mode classifier 抑制掉,導致問題沒有送出去、工作流卡住。

現在修正為:auto mode classifier 會把使用者對 AskUserQuestion 的回答視為「明確的意圖訊號」,不再抑制。換句話說,只要 skill 或指令有需要問使用者問題,就一定問得出去。

Bug Fixes

30+ 修正(精選重要項目)

這個版本的修正清單極長,以下列出影響較大的項目:

sec
修正企業登入限制(forceLoginOrgUUIDforceLoginMethod)對第三方 provider 和 API key session 未正確強制執行的問題。
fix
! 指令輸出中的 & 顯示為 & 的問題已修正,在 headless 機器執行 gcloud auth login 等輸出 URL 的指令時,URL 可以正常複製貼上。
fix
Plugin agents 在 tools: frontmatter 宣告多個 Agent(...) 類型時,只保留最後一個的問題已修正。
fix
Hook if 條件(如 PowerShell(git push*))無法匹配的問題已修正,之前只有 PowerShell(*) 能運作。
fix
MCP server 分頁時,第 2 頁之後的 resources、templates 和 prompts 遺失的問題已修正。
fix
貼上的文字被轉成 [Pasted text #N] 佔位符而非實際內容傳給 agent 的問題已修正。
fix
已在背景執行的 session 在重新連接後,仍會重複詢問「不再詢問」已核准的工具權限的問題已修正。
fix
Shell snapshot 會把名稱以單底線開頭的 user function 過濾掉(導致引用這些函式的 alias 失效)的問題已修正。
fix
CLAUDE_CODE_SUBAGENT_MODEL 環境變數未套用到 agent team 產生的 teammate process 的問題已修正。
fix
Windows:PowerShell 透過 winget 或 Microsoft Store 安裝時,pwsh 執行失敗(exit code 1)的問題已修正。
fix
Windows:附加到背景 session 時,Claude 輸出串流期間全螢幕不停閃爍(strobing)的問題已修正。
fix
Windows:背景工作的 worktree 刪除時,誤跟著 NTFS junction 進入主 repo 的問題已修正。
fix
未知的 slash command 在 headless/SDK 模式下靜默無作為的問題已修正,現在會顯示錯誤訊息。
fix
Agent SDK:streaming session 結束時的未捕獲例外(uncaught exception)已修正。
fix
GNOME Terminal 右鍵和中鍵貼上無法插入文字的問題已修正。