Claude Code v2.1.284:Claude Sonnet 5.5、所有方案預設自動模式,Ultracode 改為獨立開關
Claude Code v2.1.284 新增 Claude Sonnet 5.5 並設為 Anthropic API 上的預設 Sonnet 模型,所有方案的互動式工作階段預設以自動模式啟動,Ultracode 也改為 /effort 中的獨立開關。
Claude Code v2.1.284 是一個大型版本:新增 Claude Sonnet 5.5 並設為 Anthropic API 上的預設 Sonnet 模型,並讓自動模式成為所有方案與供應商上互動式終端機與 VS Code 工作階段的預設權限模式。Ultracode 改為 /effort 中的獨立開關,新增 /mcp reconnect all,Claude apps gateway 也加入支出上限的金額顯示與新的驗證選項。其餘項目修正了回應串流處理、MCP、外掛、VS Code 與 Claude Tag 等問題。
新功能
Claude Sonnet 5.5 成為新的預設 Sonnet 模型
Claude Sonnet 5.5(claude-sonnet-5-5)現已推出,並成為 Anthropic API 上的預設 Sonnet 模型。根據變更日誌,它提供 1M context,定價為每百萬 token $2/$10,快取讀取為每百萬 token $0.20。
所有方案與供應商預設使用自動模式
未設定權限模式時,互動式終端機與 VS Code 工作階段現在會在所有方案與供應商上以自動模式啟動;permissions.defaultMode 仍可覆寫此行為。自動模式在讀取工作目錄以外的內容前所顯示的提示,也新增了「Yes, but ask again next time」選項,可允許這一次讀取,之後的讀取仍會再次詢問。
Ultracode 改為獨立開關
Ultracode 現在是 /effort 中的獨立開關(按 Tab,或使用 /effort ultracode [on|off]);它不再強制使用 xhigh 努力程度,在任何努力程度下都能保持開啟。新的 effortSlider:decreaseEffort、increaseEffort 與 toggleUltracode 按鍵綁定動作,讓您可以在 keybindings.json 中重新綁定滑桿的方向鍵與 Tab 鍵;在 VS Code 中,Effort 滑桿下方新增的 Ultracode 開關取代了滑桿上的 Ultracode 檔位。
/mcp reconnect all 與 /rate-limit-options
在互動式終端機中,/mcp reconnect all 會一次重試所有連線失敗或需要驗證的 MCP 伺服器。對 claude.ai 訂閱者而言,/rate-limit-options 現在會出現在 /help 與指令選單中,讓提及它的用量上限通知指向一個找得到的指令。
Claude apps gateway:支出金額與驗證選項
當 gateway 執行此版本或更新版本時,/usage 與狀態列中的支出上限會顯示金額(例如「$271.40 / $500.00 spent this month」),狀態列的 rate_limits.spend_limit 也新增 used_usd、limit_usd 與 period。Gateway 另新增與身分識別提供者之間的憑證用戶端驗證(private_key_jwt),以及用於 telemetry.forward_to 目的地的 auth: { google: {} },可使用 gateway 的 Google Cloud 憑證將遙測直接匯出到 Google Cloud 的 OTLP 端點。當受管理政策的 availableModels 為空,或在未設定 model 或 enforceAvailableModels 的情況下遺漏了 Claude Code 啟動時使用的模型,gateway 現在會在啟動時發出警告。
VS Code:訊息時間戳記與外掛錯誤
VS Code 可以在每個提示與回應上方顯示時間,並在日期變更處加入日期列(Claude Code: Show Message Timestamps 設定,預設關閉);Manage plugins 的各列現在也會顯示外掛載入錯誤與附註,並提供停用、解除安裝或複製錯誤的彈出視窗。claudeCode.environmentVariables 設定中的 CLAUDE_CONFIG_DIR 現在只有在為絕對路徑時才會套用,並會傳給接續該對話的終端機。
修正與改進
- 回應串流:損壞的回應串流不再顯示「JSON Parse error」或「undefined is not an object」等原始錯誤,也不再把「undefined」一字寫進回答;現在會重試,或回報為中斷的回應。
- 重試:緊接在 thinking 區塊之後出現的過載或伺服器錯誤,現在會重試,而不是以錯誤結束回合;回應途中連線中斷後的重試,現在也與該請求的其他重試共用同一個額度,讓持續失敗的請求更快放棄。
- 壓縮:壓縮後的請求仍然過長時,Claude Code 現在會再壓縮一次並保留較少的近期對話,而不是持續出現「Prompt is too long」錯誤。
- 模型:在以
ANTHROPIC_DEFAULT_OPUS_MODEL或modelOverrides固定 Opus 模型的工作階段中,Anthropic API 上的安全相關模型切換,現在會切換到 API 針對各類標記所選的模型,而不是固定的模型。Sonnet 模型的安全防護標記訊息時顯示的通知,現在也會說明原因並提供編輯與重試選項。 - Explore 子代理:當工作階段使用 Claude Code 無法辨識的模型 ID(例如代理伺服器後方的自訂模型)時,Explore 在 Claude API 上不再切換到 Opus,而會沿用該模型。
- MCP:在恢復的工作階段中,MCP 工具呼叫不再於伺服器仍在連線時以「No such tool available」失敗,而會等待伺服器最多 10 秒。即使
CLAUDE_CODE_MCP_STARTUP_WAIT_MS為0,非互動模式的第一個回合仍會為--allowedTools或mcp_toolhook 所指名、正在連線的 MCP 伺服器等待最多 2 秒。 - MCP:當受管理設定將 MCP 伺服器限制為只能來自外掛時,
claude mcp add現在會拒絕並說明該怎麼做,而不是回報成功並儲存一個永遠不會載入的伺服器。 - 規則與匯入:從專案外部以符號連結放入
.claude/rules的規則,不再於未顯示外部匯入核准提示的情況下被略過;從專案外部以符號連結建立的.claude目錄,現在也會要求同樣的核准。 - 受管理設定:在受管理的
allowManagedPermissionRulesOnly之下,來自市集、claude.ai 與 npm 的外掛不能再透過allowed-tools預先核准自己的工具;只有來自 Anthropic 官方來源或受管理設定所擔保之來源的外掛,才保有這項預先核准。 - Foundry:
ANTHROPIC_FOUNDRY_RESOURCE不再未經驗證就被插入 Foundry 端點主機名稱;不是單純資源名稱的值現在會被拒絕。 - 自動記憶:
MEMORY.md與回想出的記憶筆記中的隱形字元,以及模仿 Claude Code 自身標記的標籤,會在送達 Claude 前被無害化。 - 外掛與 hook:
/plugin設定畫面中的布林選項現在是 true/false 選擇,數字選項會拒絕無效輸入;Elicitation 與 ElicitationResult hook 回傳的{"decision":"block"}現在會拒絕 MCP elicitation,與結束碼 2 的效果相同。 - 用量上限:用量上限警告不再向已使用最高等級 Max 方案的使用者建議
/upgrade;可使用/usage-credits時,警告與/upgrade本身都會改為指向它。 /recap:從聊天討論串(包括您自己的)或從例行工作、webhook 轉送而來的/recap,現在會以簡短通知婉拒;在終端機、Claude 應用程式、Remote Control、-p或 SDK 主機中輸入時,則照常執行。- 全螢幕:向上捲動時若回覆串流結束,捲動位置不再跳到上一則訊息或最底部;在 macOS 與 Linux 上,對話記錄模式中的
[也不再清除工作階段上方的終端機輸出。 - Windows:啟用大量外掛時 Bash 工具不再失敗:不存在的外掛
bin/目錄不再加入 PATH,繼承的項目也不再重複加入。 - VS Code:沒有回合在執行時,按 Escape 不再停止所有背景代理;輸入
/model再按 Enter 現在會開啟模型選擇器,而不是在聊天中印出用法說明。 - Claude Tag:討論串、頻道預設與私訊現在可以選擇「Opus (latest)」等模型家族選項,讓選擇自動跟隨該家族的最新模型。
此版本共包含 100 項變更,完整清單請參閱完整變更日誌。
如何更新
- 檢查已安裝的版本:
claude --version - 就地更新:
claude update - 未設定權限模式的互動式終端機與 VS Code 工作階段,現在會在所有方案與供應商上以自動模式啟動;如需其他預設值,請設定
permissions.defaultMode。Ultracode 現在是/effort中的獨立開關,不再強制使用 xhigh 努力程度。