跳至主要內容

Claude Code v2.1.243:/usage 的 Loops 明細、可自訂的 /model 選擇器,以及提示快取 TTL 設定

Claude Code v2.1.243 在 /usage 新增 Loops 明細,加入 modelPicker、promptCacheTtl 與 modelPricing 設定以及免金鑰的 Console 登入,並縮小原生版本的下載大小與記憶體用量。

Claude Code v2.1.243 是一個大型版本,變更日誌共列出 60 項變更。此版本在 /usage 新增 Loops 明細,加入可自訂 /model 選擇器、設定提示快取 TTL,以及套用組織合約模型價格的新設定,並在 /login 下提供免金鑰的 Console 登入。它也縮小了原生版本的下載大小、降低記憶體用量並改善啟動時間,同時修正了 MCP、自動模式、跨工作階段訊息、Remote Control 與 VS Code 擴充功能的多項問題。

新功能

/usage 的 Loops 明細

/usage 現在包含 Loops 明細,列出每個 loop 的執行次數、總 token 數、每次執行的 token 數與最後一次執行,讓失控或過於冗長的 /loop 任務一目了然。在終端機中,Claude 無事可做的連續 /loop 喚醒現在會收合成一行,而不是逐一印出。

用 modelPicker 自訂 /model 選擇器

新的 modelPicker 設定可用一份有順序、附標籤的模型清單來自訂 /model 選擇器。項目可使用任何 id 寫法(包括 Vertex 與 Bedrock 的 id),清單可以附加在內建的模型陣容之後,也可以完全取代它。

提示快取 TTL 設定

新的 promptCacheTtl 與 subagentPromptCacheTtl 設定,讓使用 API 金鑰與雲端供應商的使用者,可以在主對話上維持 1 小時的提示快取,同時讓子代理維持 5 分鐘。

以 modelPricing 套用合約價格

新的 modelPricing 受管理設定,會讓 /cost、狀態列與遙測中的成本數字改用組織合約中的各模型費率與折扣倍數,而不是牌價。

免金鑰的 Console 登入

在 /login → Anthropic Console 中,除了建立 API 金鑰之外,現在還有新的「Sign in with your Console account」選項(建議使用),讓不允許使用 API 金鑰的組織也能登入。透過 SSH 使用 /login 的體驗也有所改善:登入網址會立即出現,按 c 會回報網址是如何複製的,而不是一律宣稱成功,另有提示說明如何在全螢幕模式中選取文字。

受管理設定的可見性

/status 新增 Skipped sources 一行,列出雖然存在、但因為有更高優先順序的受管理來源生效而未套用的受管理設定來源(例如 managed-settings.json)。在 /mcp 與 /plugins 中,由您的組織管理驗證的 claude.ai 連接器現在會顯示 managed 標記。

Claude Code on the web 的 GitHub 連線狀態

/status 新增一行,顯示 Claude Code on the web(Pro/Max)是否已連接 GitHub,未連接時會指向 /web-setup;尚未為 Claude Code on the web 連接 GitHub 的 claude.ai 使用者,也會看到指向 /web-setup 的提示。當較舊版的 GitHub CLI(沒有 gh auth token)已完成驗證時,/web-setup 也不再反覆要求您登入。

/tasks 顯示子代理的模型與 effort

/tasks 與代理詳細資訊對話框現在會顯示每個子代理所使用的模型(以及 effort 等級)。

更小的下載、更低的記憶體用量、更快的啟動

原生安裝與自動更新所下載的執行檔現在以 zstd 壓縮,在 Linux x64 上約 75 MB,而非 340 MB;由於內建技能與提示文字的儲存方式更精簡,執行檔本身也縮小了約 2 MB。原生版本現在會依需求載入程式碼,而不是讓整個 bundle 常駐記憶體(每個工作階段約少用 40–70 MB 記憶體),在長時間執行的工作階段中,執行環境也會隨著 heap 成長更早進行垃圾回收,改善峰值記憶體用量。啟動時間同樣獲得改善:沙箱與 MCP 的初始化不再阻擋第一個畫面,bare launch 會略過子指令註冊,工作流程探索、設定與信任儲存區(trust store)的處理成本也更低。

沙箱化 Bash 不再列出允許的主機

沙箱化 Bash 工具的提示不再列出允許的網路主機,因此 Claude 會嘗試發出請求(您也可以核准新的主機),而不是假設未列出的主機都已被封鎖。

/model、/fast 與 /effort 在更多環境中立即執行

在 Bedrock、Vertex 與 Foundry 上,以及停用遙測時,/model、/fast 與 /effort 現在也會立即執行,而不是排隊等到回合結束。

macOS 上的電腦操作需要授權 Finder

在 macOS 上使用電腦操作(computer use)時,點擊桌面、Dock 或 Finder 視窗現在需要透過存取權對話框授權 Finder,就和其他任何 app 一樣。

修正與改進

  • MCP:非互動式(-p)與 SDK 工作階段中的遠端 MCP 伺服器,在連線中斷後不再永遠無法恢復,現在會自動重新連線,或回報為失敗。從桌面版 app 發起的 MCP 伺服器登入,在支援用戶端 ID 中繼資料文件(client ID metadata documents)的伺服器(例如 Linear)上,不再以「Invalid redirect URI」失敗。
  • 自動模式:當快取了暫時性的伺服器端停用、而之後的旗標擷取又失敗時,自動模式不再於啟動時一直無法使用。當 API 短暫過載並要求用戶端重試時,自動模式的工具呼叫不再於等待約一分鐘後被以「temporarily unavailable」拒絕。
  • API 無回應:當 Anthropic API 始終沒有開始回應時,工作階段不再沉默 10 分鐘以上;請求現在會在約 3 分鐘後逾時、重試一次,然後顯示 API Error: No response from API。
  • /model 選擇器:在 /model 選擇器中選擇 Ultracode 不再被默默忽略,現在會套用到目前的工作階段。選擇器與內建的 claude-api 技能現在會將 Sonnet 5 每百萬 token(Mtok)$2/$10 的價格顯示為標準牌價,而不是限時優惠。
  • 恢復工作階段:/resume 不再只列出最近的 50 個工作階段;選擇器現在會在您捲動時載入更多。
  • 背景子代理:背景子代理現在會在其最後一個背景 Bash 任務完成時被喚醒。
  • 跨工作階段訊息:在 2.1.232 的 socket 目錄強化之後,跨工作階段訊息在使用者命名空間(user namespaces)與 rootless 容器中不再默默停用。收件匣 socket 現在會關閉在 30 秒內未送出完整一行的連線。
  • Remote Control:當伺服器在工作階段中途捨棄其環境時,claude remote-control 不再退出並讓已附加的 Remote Control 工作階段被困住,現在會自行恢復。
  • 掛鉤:當指令包含 $() 或反引號命令替換、且後面還有其他參數時,像 Bash(cat *) 這樣的掛鉤 if 條件不再對不相關的 Bash 指令觸發。
  • 代理定義:--agents 不再默默忽略無效的 JSON 或無效的代理定義,現在會像 --mcp-config 一樣以清楚的錯誤結束。
  • CI 驗證:在 CI 中使用工作負載身分聯合(workload identity federation)時,同一個 job 中的程序現在會共用已交換的 token,而不是重新交換只能使用一次的 token;交換遭拒時會立即失敗並顯示伺服器的訊息。
  • 沙箱:當被封鎖的指令仍以 0 結束時(例如 curl 印出 proxy 的 403 頁面),沙箱網路違規的詳細資訊不再從 Bash 工具結果中遺失。
  • 速率限制:工作階段閒置期間速率限制視窗重設後,狀態列的 rate_limits 欄位與 /usage 不再繼續顯示重設前的用量百分比。
  • 輸入歷史:當 ~/.claude/history.jsonl 含有格式錯誤的項目時,Ctrl+R 歷史搜尋與向上鍵歷史不再失效。
  • Claude in Chrome:自動更新清除 Claude in Chrome 設定時所用的版本後,它不再與 Claude Code 失去連線;原生主機(native host)現在會透過穩定的 claude 啟動器啟動。
  • VS Code:在首次擷取功能旗標之前啟動的工作階段(例如剛安裝完時),現在會以自動模式或您設定的預設模式開啟,而不是以預設的權限模式開啟。

此版本共包含 60 項變更,完整清單請參閱下方連結的官方變更日誌。

如何更新

  1. 檢查已安裝的版本:claude --version
  2. 就地更新:claude update
  3. 若您有會傳送資料到跨工作階段訊息收件匣 socket 的腳本,請讓它們在資料準備好之後再連線,因為該 socket 現在會關閉在 30 秒內未送出完整一行的連線。

相關連結