版本封存

Claude Code v2.1.302：可指定自動模式分類器模型、閒置壓縮開關，以及預設啟用 fork 子代理

Claude Code v2.1.302 新增 CLAUDE_CODE_AUTO_MODE_MODEL 與 /config 中的 Idle compaction 開關，在終端機以外也預設啟用 fork 子代理，並修正 MCP、外掛、雲端會話與 Claude Tag 的問題。

2026年10月16日 • 10 min read • 作者：ClaudeWorld

Claude Code v2.1.302 是一個大型版本，變更日誌共列出 63 個項目。此版本新增用來選擇用戶端自動模式分類器模型的 CLAUDE_CODE_AUTO_MODE_MODEL，以及 /config 中的 Idle compaction 列；同時調整了 fork 子代理、子代理前景與背景執行，以及 claude -p 會話起始權限模式的預設值，並為掛鉤的並行數量設下上限。修正涵蓋壓縮、供應商、外掛、MCP、雲端會話，以及一長串 Claude Tag 項目。

新功能

選擇自動模式分類器的模型

新的 CLAUDE_CODE_AUTO_MODE_MODEL 變數可選擇用戶端自動模式分類器所使用的模型；它不會改變伺服器端自動模式的模型。另外，使用伺服器端分類器的自動模式，現在會在對話長到無法進行安全檢查時將其壓縮，而不是拒絕每一個受檢查的工具呼叫。

/config 中的閒置壓縮開關

/config 新增 Idle compaction 列，可關閉或重新開啟閒置壓縮。閒置壓縮後顯示的通知，現在也會說明如何將其關閉。

更多環境預設啟用 fork 子代理

Fork 子代理（subagent_type: "fork"）現在在 claude -p、Agent SDK、桌面應用程式與 VS Code 中預設啟用，與終端機中原本的行為一致。CLAUDE_CODE_FORK_SUBAGENT=0 可將其關閉，而 claude mcp serve 永遠不會提供它們。

子代理的背景與前景預設

桌面應用程式與 VS Code 現在一律在背景執行主對話的子代理（與終端機相同），而不再由 Claude 自行決定。在 claude -p、Agent SDK、桌面應用程式與 VS Code 中，子代理自己發出的 Agent 呼叫現在預設在前景執行。

claude -p 與 Agent SDK 的預設權限模式

未指定權限模式的 claude -p 與 Agent SDK 會話，在使用第三方供應商、關閉遙測或全新安裝時，現在會以 default 模式啟動。使用 --permission-mode auto 則會維持自動模式。

掛鉤並行上限

prompt 與 agent 類型的掛鉤，現在同一事件最多同時執行 12 個，其餘的會排隊等候。

Claude Design 關閉通知

/design-sync 與 /design-login 現在會顯示通知，說明獨立版 Claude Design（claude.ai/design）將於 2026 年 12 月 14 日前關閉。

修正與改進

  • 壓縮：在對話壓縮期間停止一輪，不再導致「Prompt is too long」錯誤。
  • 供應商：在會話中途切換到 Vertex 或 Bedrock 後，請求不再以「diagnostics: Extra inputs are not permitted」失敗。
  • Read 工具：Read 工具不再將任意大小的圖片檔，或名稱看起來像圖片的管道或裝置，整個載入記憶體；超過 128 MB 的圖片來源現在會被拒絕。
  • 外掛：claude plugin 等子指令不再有時在排入佇列的設定或組態寫入完成前就結束，這曾可能導致變更遺失或留下 .tmp 檔案。當 git 預設使用 reftable ref 格式時，外掛市集不再於每次重新整理時重新 clone，新安裝的 git 外掛也不再顯示版本「unknown」。PowerShell 工具現在可以找到外掛 bin/ 資料夾中的指令。
  • 啟動：啟用大量外掛時啟動更快，因為載入外掛指令與代理檔案所需的檔案系統呼叫大幅減少，在 Windows 上尤其明顯。
  • MCP：當伺服器協商的協定版本為 2026-07-28、卻省略 resultType、ttlMs 或 cacheScope 時，MCP 伺服器不再顯示沒有工具，或每個工具呼叫都失敗。
  • OpenTelemetry：大多數自動模式分類器封鎖的 tool_decision 事件不再缺少 classifier_category；當 OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT 設得較低時，新的 tool_decision 屬性也不再擠掉 tool_use_id、tool_source 與 tool_parameters。
  • 使用額度：對於您的方案只能以額度付費的模型，提示建議不再花費使用額度；在以額度計費的回覆之後，提示建議現在會被略過。
  • Worktree：在 git 2.56 或更新版本下，當殘留的 .git 檔案指向不存在的目錄時，worktree 隔離不再拒絕建立或恢復 worktree。
  • Windows：位於 exFAT 或 FAT32 磁碟上的專案，每次寫入檔案不再都被拒絕或詢問，包括以 --plugin-dir 啟動的會話。
  • 雲端會話：「Rewind to here」現在可用於最新訊息以外的訊息（self-hosted runner 需要 Claude Code v2.1.246 或更新版本）。中途失敗的排程 routine 執行，不再於一小時或更久之後從頭再執行一次，這曾可能重複工作，例如把同一份報告發布兩次。Routine 頁面現在會顯示橫幅，說明上次執行為何沒有啟動。
  • Remote Control：電腦離線後，子代理的窗格不再無止盡地轉圈；現在會顯示 Remote Control 已中斷連線。
  • Claude Tag：在 Slack 中附加的 HEIC、SVG、TIFF 與 BMP 圖片，現在會以檔案形式送達 Claude 的工作檔案。當某一次 Slack 查詢停滯時，Claude in Slack 不再有時以「DMs are temporarily unavailable」回覆私訊並將其捨棄，而是會先重試。Claude Tag 管理設定現在將 Claude 的存取權整理為四個分頁：Bundles、Connectors、Skills and plugins 與 Channels。
  • VS Code：當伺服器 URL 含有查詢字串時，從面板登入 MCP 伺服器不再開啟損壞的授權頁面；在無法連上裝有 Claude 擴充功能的瀏覽器時，@browser 橫幅也不再顯示「Browser connected」。

此版本共包含 63 項變更；所有項目請參閱完整變更日誌。

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 直接就地更新：claude update
  3. 如果您在第三方供應商上、關閉遙測時或全新安裝後，於未指定權限模式的情況下執行 claude -p 或 Agent SDK，會話現在會以 default 模式啟動；若要維持自動模式，請傳入 --permission-mode auto。

相關連結