版本封存

Claude Code v2.1.301：無人值守重試的用量限制等待上限、Vim % 移動指令與分類器遙測

Claude Code v2.1.301 讓無人值守重試模式在用量限制要很久才重置時直接結束請求，新增 vim 的 % 移動指令與 OpenTelemetry 自動模式分類器欄位，並修正 worktree、登入、搜尋與 VS Code 問題。

• 10 min read • 作者：ClaudeWorld

Claude Code v2.1.301 是一個大型版本，變更日誌共列出 51 個項目。此版本讓無人值守重試模式在遇到用量限制時的等待時間可以設定上限、為 vim 模式新增 % 移動指令，並新增可區分自動模式分類器決策與權限規則的 OpenTelemetry 欄位。此外也調整了切換到 context window 較小模型時的處理方式、在 VS Code 加入 LaTeX 數學式渲染，並修正 worktree、登入、搜尋、工作流程與終端機等方面的問題。

新功能

無人值守重試的用量限制等待上限

新的 CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS 變數，讓無人值守重試模式（CLAUDE_CODE_RETRY_WATCHDOG）在遇到要很久才會重置的用量限制時直接結束請求，而不是一直等待重置。

Vim 模式：% 移動指令與 Escape 修正

Vim 模式新增 % 移動指令，可單獨使用或搭配 d/c/y 跳到對應的括號。在緩慢或忙碌的機器上，vim 模式也不再於按下 Escape 後有時仍停留在 INSERT；AskUserQuestion 的自由文字欄位現在支援 vim NORMAL 模式，Esc 只會在 NORMAL 模式下取消，不再丟棄已輸入的答案。

OpenTelemetry 中的自動模式分類器資訊

OpenTelemetry tool_decision 事件現在包含 classifier_verdict 與 permission_mode，可區分自動模式分類器的決策與權限規則。設定 OTEL_LOG_TOOL_DETAILS=1 時，還會包含 classifier_category，指出分類器封鎖所符合的內建規則。

切換到 context window 較小的模型

切換到 context window 較小的模型時，若對話對新模型而言太長，現在會先由先前的模型進行摘要。另一項相關修正則處理了這類切換可能未先詢問就花費使用額度產生摘要的情況。

fable 與 best 別名的備援

當您的組織無法使用最新的 Fable 模型時，fable（以及 best）模型別名在 Anthropic API 上不再出錯；Claude Code 現在會改用前一個 Fable 模型重試一次。

Mod API 變更

  • mod 的 Input 支援 rows，可在終端機中建立多行文字欄位：Enter 送出，Shift+Enter 或在 Enter 前加上反斜線則換行。
  • mod 掛鉤的 .catch 處理器現在只會在掛鉤拋出錯誤或逾時時執行；在掛鉤自身呼叫底下觸發的事件會直接略過該掛鉤，不再詢問其 .catch。
  • $.env.set 現在會在變數設定或取消設定後以 {} 解析；若沒有寫入，則以說明原因的 { deny } 解析。
  • 在 VS Code 以及桌面版與行動版應用程式中，問題對話框上方繪製的樹狀結構現在可包含 Markdown 與最多 48 列；終端機則維持 12 列純文字。

VS Code：LaTeX 數學式與「Get more usage」連結

VS Code 中 Claude 的回應現在會渲染 LaTeX 數學式，包括 $$ 與多行 \[ … \] 區塊，以及行內的 $…$ 與 \(…\) 數學式。Pro 與 Max 方案在 VS Code 與 JetBrains 面板的用量限制橫幅上，也會顯示「Get more usage」連結。

修正與改進

  • Worktree：當 WorktreeCreate 掛鉤建立的 worktree 可能含有尚未推送的 commit 時，結束 Claude Code 不再未經詢問就將其移除。
  • 搜尋與讀取：當搜尋程式在回傳任何結果前意外失敗時，Grep 與 Glob 現在會回傳說明搜尋失敗的錯誤，而不是回報沒有符合項目。Read 工具不再將 .xlsm、.parquet、.epub 與 .heic 等二進位檔案當作文字讀取。
  • 登入：磁碟已滿導致登入無法更新時，錯誤訊息現在會指出是哪個磁碟並建議刪除檔案，而不是顯示誤導的「Please run /login」。claude auth status 或 claude plugin list 等短指令在 token 更新途中結束時，不再造成更新逾時與意外登出。
  • 工作流程：工作流程代理在讀到「其任務文字不具使用者授權」的 harness 說明後，不再有時略過自己的步驟、而整個執行仍回報成功。在同一會話中執行 Bash cd 之後，讀取、編輯或重新執行工作流程腳本時不再要求權限或遭到拒絕。
  • 技能與指令：引數名稱非常多或非常長的技能與指令，在呼叫時不再停頓數秒；現在只會填入前 64 個名稱，每個最多 64 個字元。使用 /rewind 之後，技能也會再次列給模型。
  • 壓縮：在回應所標示的模型與請求的模型不同的 LLM 閘道後方，對話不再以您未選擇的模型反覆壓縮。
  • 權限：在權限檢查期間被回合中途送出的訊息打斷的工具呼叫，不再被當成使用者拒絕而回報給模型；外掛或技能掛鉤的 ask 決定所觸發的權限提示，現在會顯示該掛鉤來自哪個外掛或技能。
  • 模型切換：當供應商不是 Bedrock 時，切換到名稱包含 application-inference-profile 的模型，不再執行您的 awsAuthRefresh 指令並延遲模型切換掛鉤。
  • 終端機：在以 0.53 版之前的 VTE 為基礎的終端機（例如 RHEL 8 上的 MATE Terminal）中，不再出現 >0q、>4m 等雜散字元；在某些版本的 iTerm2 中，啟動時提示列也不再出現雜散的 GOK 文字。
  • 效能：長時間執行的子代理工作時，其進度軌跡現在會以增量方式更新，不再於每次渲染時完整重新處理。
  • claude-api 技能：此技能現在包含 OpenTelemetry 追蹤指引，包括使用 ant CLI 設定追蹤目的地。
  • Self-hosted runner：當受管設定限制 MCP 伺服器時，從 Slack 啟動的會話現在可以找到並附加儲存庫。
  • Windows：已停止的背景 PowerShell 指令，其輸出檔案不再缺少結尾的 [killed] 行。
  • VS Code：導致面板當機或凍結的對話，不再於每次重新載入時被重新開啟；長時間思考期間，聊天面板也不再變慢。

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

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 直接就地更新：claude update
  3. 如果您在受管設定限制 MCP 伺服器的情況下執行 self-hosted runner，從 Slack 啟動的會話現在可以找到並附加儲存庫；若要讓這些工具保持關閉，請使用 deniedMcpServers。

相關連結