Claude Code v2.1.229:外掛市集 command 來源、VS Code 工作階段群組、更安全的 /commit-push-pr
Claude Code v2.1.229 新增以指令提供的外掛市集來源、VS Code 工作階段群組與閘道 keepalive ping,/commit-push-pr 不再自動核准危險旗標,並修正多項崩潰問題。
Claude Code v2.1.229 是一次涵蓋面廣的版本,變更日誌共有 32 項。此版本為外掛市集新增 command 來源、在 VS Code 側邊欄加入工作階段群組、為閘道串流加入 SSE keepalive ping,並讓自架執行器工作階段支援由伺服器提供的掛鉤;同時 /commit-push-pr 不再自動核准帶有危險旗標的 git 與 gh 指令。修正項目涵蓋多項崩潰、串流輸出異常、停用 attribution 標頭時的自動模式,以及搭配嚴格授權伺服器的 MCP OAuth。
新功能
外掛市集的 command 來源
外掛市集現在可以使用 command 來源:由本機指令(例如 IDE)輸出外掛目錄,該目錄會在每個工作階段重新解析,並且不需重新啟動即可套用。搭配 mode: "link" 時,會直接就地使用該目錄。
VS Code 的工作階段群組與面板更新
VS Code 擴充功能在側邊欄新增工作階段群組:按右鍵即可建立、重新命名或刪除群組,按住 Cmd/Ctrl 或 Shift 點選可一次移動多個工作階段。/btw 旁支提問面板現在可在側邊停駐與堆疊兩種版面中拖曳邊界來調整大小;「Report a problem」與 /bug 現在會開啟內建的意見回饋對話框,而不是已停用的問卷連結。
/commit-push-pr 不再自動核准危險旗標
在 /commit-push-pr 中,帶有危險旗標(--force、--amend、--no-verify 等)的 git/gh 指令不再被自動核准。
自架執行器更新
自架執行器工作階段現在支援由伺服器提供的 Claude Code 掛鉤,與受管環境的行為一致。在 Windows 上,自架執行器啟動時現在必須明確指定 --base-dir,因為 Windows 上沒有預設的檢出目錄。
閘道串流的 keepalive ping
在長時間的思考停頓期間,閘道的串流回應現在會送出 SSE keepalive ping,避免 Vertex 與 Bedrock 上游因閒置逾時而斷線。
錯開啟動工作流程的扇出代理
工作流程扇出(fan-out)時,現在會錯開啟動前綴相同的同層代理,讓後續代理讀取已快取的提示前綴,而不必重新支付其成本。設定 CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0 可停用此行為。
ListAgents 顯示 Remote Control 工作階段狀態
ListAgents 現在會把已中斷連線的 Remote Control 工作階段標示為 offline,並將您的雲端工作階段標示為 cloud。此版本也加入了 claude remote-control --continue 的說明,可用來恢復最近一次的 Remote Control 工作階段。
修正與改進
繪製與崩潰
- 長回應在串流時不再部分消失,也不會在終端機中重複印出兩次。
- 修正工具呼叫的
glob、file_path或command值不是字串時,程式崩潰並進入錯誤畫面的問題(包括對受影響的工作階段執行--resume時)。 - 修正在非常窄的終端機視窗中繪製進度列或 markdown 表格時發生的 RangeError 崩潰(也可能導致
claude --continue/--resume在啟動時崩潰)。
Windows
- 修正工具呼叫或訊息以延伸長度路徑(
\\?\)或 UNC 路徑引用檔案時發生的崩潰。
自動模式與模型
- 透過
CLAUDE_CODE_ATTRIBUTION_HEADER停用 attribution 標頭的使用者(直接連線 Anthropic API)使用自動模式時,不再每次工具呼叫都失敗。 - 對於使用自訂
ANTHROPIC_BASE_URL閘道的 claude.ai 訂閱者,/model不再拒絕 Sonnet/Opus 1M。
MCP 與登入
- MCP OAuth 現在在重新導向 URI 中使用
127.0.0.1而非localhost,因此能與嚴格的授權伺服器搭配運作。 /login在成功登入後,現在會再次顯示CLAUDE_CODE_OAUTH_TOKEN覆寫警告。
GitHub 與 Remote Control
- 由
/install-github-app產生的 Claude Code Review 工作流程,不再於未在 pull request 上張貼審查的情況下就結束。 - 在筆電終端機中輸入斜線指令後,Remote Control 用戶端不再顯示卡住的工作中指示器。
效能
- 修正 IDE 擴充功能連線時,編輯含有數千筆 IDE 診斷的檔案後 UI 停頓數秒的問題。
- 在 CPU 受限的容器中,動態工作流程現在會使用容器的 CPU 上限,而不是主機的核心數。
壓縮與 API 錯誤
- 單憑訊息就超過 API 32 MB 請求上限的對話,在沒有圖片或文件可移除時不再重試壓縮;現在會以清楚的訊息失敗一次。
- 「prompt is too long」錯誤現在會說明自動壓縮為何無法恢復,而不只是建議使用
/compact。 - SDK 與
--input-format stream-json工作階段在送出只含空白字元的訊息時,不再收到 400 API 錯誤。
沙箱
- 網路網域清單中的 IPv6 字面值現在會加上方括號(
[::1]:443),寫法模稜兩可的項目會以預設拒絕(fail-closed)的方式執行,並由/doctor標示出來。
自架執行器與遠端工作階段
- 部署了
managed-mcp.json且伺服器提供 MCP 伺服器時,自架執行器與其他遠端工作階段不再於啟動時結束;這些伺服器現在會被略過並顯示警告。 - 自架執行器準備儲存庫時不再卡在 Git Credential Manager 的提示;缺少憑證時 git 現在會快速失敗。
此版本共包含 32 項變更,完整清單請參閱 Claude Code 變更日誌。
如何更新
- 檢查已安裝的版本:
claude --version - 就地更新:
claude update - 若您在 Windows 上執行自架執行器,請明確指定
--base-dir啟動;Windows 上沒有預設的檢出目錄。