Claude Code v2.1.129 發布說明

Claude Code v2.1.129 帶來插件 URL 獲取功能、自動更新能力，以及針對歷史記錄導航的眾多改進和錯誤修復。

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

Claude Code v2.1.129 正式發布，為插件管理、終端機相容性和使用者體驗帶來重大改進。本次更新專注於讓 Claude Code 在不同環境下更加靈活可靠，滿足進階使用者的需求。

新功能

插件管理增強

  • URL 插件獲取：新增 --plugin-url <url> 參數，可直接從 URL 獲取插件 .zip 檔案用於當前會話，大幅簡化插件分發和測試流程
  • 插件清單更新：主題和監控器現在應該在插件清單中的 "experimental": { ... } 下宣告。舊版頂層宣告仍可運作，但 claude plugin validate 會發出警告

自動更新與終端機相容性

  • 背景自動更新：新的 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 環境變數可為 Homebrew 和 WinGet 安裝啟用背景自動升級功能，並提示重新啟動
  • 同步輸出控制：新增 CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 環境變數，可強制啟用同步輸出功能，適用於自動偵測失效的終端機（如 Emacs eat）

歷史記錄與導航改進

  • 增強歷史搜尋：Ctrl+R 歷史選擇器現在預設搜尋所有專案的所有提示，回到 2.1.124 版本之前的行為。使用 Ctrl+S 可縮��搜尋範圍至當前專案或會話
  • 代理程式導航：修復 /agents 資料庫清單箭頭鍵導航功能，確保當清單超出檢視範圍時，已選取的代理程式仍保持可見

設定與探索功能

  • 閘道模型探索：/model 選擇器的 /v1/models 探索功能現在需透過 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 環境變數選擇性啟用
  • 技能覆蓋：skillOverrides 設定現在正常運作，選項包括：off（從模型和 / 隱藏）、user-invocable-only（僅從模型隱藏）、name-only（摺疊描述）

錯誤修復與優化

  • 修復 /clear 未在對話後重設終端機分頁標題的問題
  • 修復權限對話框啟用時會話標題標籤消失的問題
  • 修復子代理程式執行時代理程式面板可見性問題
  • 修復外部編輯器交接（Ctrl+G）清除對話歷史的問題
  • 修復 /context 透過防止 ASCII 視覺化進入對話來避免 Token 浪費
  • 解決系統喚醒後的 OAuth 重新整理競爭條件
  • 修復提示快取 TTL 問題和虛假的快取未命中警告
  • 改進 API 回應和政策拒絕的錯誤處理

第三方部署改進

  • 第三方部署（Bedrock、Vertex、Foundry）不再顯示 Anthropic 專屬的載入提示
  • 透過 claude_code.pull_request.count OTel 指標增強 MCP 工��使用的遙測功能
  • 透過 OAuth 範圍改進，更好地支援企業/團隊使用者

如何更新

使用您偏好的方式將 Claude Code 更新至 v2.1.129：

Homebrew (macOS/Linux)：

brew upgrade claude-code

WinGet (Windows)：

winget upgrade anthropic.claude-code

直接下載： 造訪 GitHub 發布頁面，下載適用於您平台的最新版本。

相關連結