跳至主要內容

Claude Code v2.1.265:--plugin-dir 支援外掛資料夾、工具結果 1 GB 上限與閘道遙測變更

Claude Code v2.1.265 讓 --plugin-dir 可載入整個外掛資料夾、將存到磁碟的工具結果上限設為 1 GB、調整 Claude apps 閘道的登入與遙測,並修正提示快取與恢復相關問題。

Claude Code v2.1.265 是一次大型更新,變更日誌共有 50 個項目。此版本讓 --plugin-dir 可以載入整個外掛資料夾,將存到磁碟的工具結果上限設為 1 GB,並調整 Claude apps 閘道工作階段的登入與遙測匯出方式。其餘變更大多是修正,涵蓋提示快取重複使用、工作階段恢復、外掛路徑檢查、MCP 連線與 Remote Control。

新功能

用 --plugin-dir 載入外掛資料夾

--plugin-dir 現在可以指向一個存放多個外掛的資料夾:每個含有 manifest 的子資料夾都會被載入,Claude Code 執行期間新增或移除的子資料夾也會被偵測到。

存到磁碟的工具結果上限為 1 GB

存到磁碟的工具結果現在上限為 1 GB;若存下的檔案遭到截斷,對話中的預覽會加以說明。

Claude apps 閘道的登入與遙測

  • 受管設定中有 forceLoginGatewayUrl 的機器,現在從啟動起就是 Claude apps 閘道工作階段,與 forceLoginMethod: "gateway" 相同;殘留的 claude.ai 登入或 API 金鑰不會被使用。
  • Claude apps 閘道工作階段現在會將 OpenTelemetry 直接匯出到閘道受管設定在 OTEL_EXPORTER_OTLP_ENDPOINT 中指定的收集器,而不再經由閘道的中繼;沒有指定收集器的工作階段仍會使用中繼。
  • Claude Desktop 與 Cowork 透過 Claude apps 閘道送出的遙測資料,現在會包含 user.email 與 user.groups,與終端機工作階段一致。

--worktree 啟動與提示中途的斜線指令

  • 在大型儲存庫上,--worktree 的啟動有所改善:新的 worktree 現在會以平行方式檢出(需要 git 2.32 以上)。
  • 在提示中途輸入的斜線指令,現在會以清單顯示符合的項目(非全螢幕時按 Tab 開啟),而不是只顯示單一建議;外掛技能現在也能只用名稱找到。

其他變更

  • 在 Installed 分頁與 claude plugin details 中,外掛的顯示資訊現在優先採用市集項目,而非 plugin.json,缺少的部分再由 plugin.json 補足。
  • 圖片處理改用執行環境內建的圖片支援,CLI 不再將原生圖片模組解壓縮到暫存目錄。
  • .claude 資料夾的權限選項現在會說明它實際允許的內容:在該工作階段中編輯專案 .claude 資料夾(或 ~/.claude)內的檔案。

VS Code:自動封存工作階段

新的「Archive inactive sessions」設定會自動封存閒置一段時間的工作階段,預設為 14 天。

修正與改進

安全性與權限

  • 在 macOS 與 Linux 上,含有反斜線的外掛路徑不再能繞過符號連結的範圍限制檢查。
  • Claude Code 自身執行的 git status 與 diff 探測,不再執行工作樹中巢狀儲存庫所設定的 clean 過濾器。
  • Windows:在 AppContainer 或受限權杖沙箱中執行時,Read、Write 與 Edit 不再拒絕所有檔案(「symlink resolution changed after permission was checked」)。
  • 對於需要登入的遠端 MCP 伺服器,Claude Code 在您實際完成驗證之前,不再向其註冊 OAuth 用戶端。
  • Artifact 工具讀取他人撰寫的 artifact 時,摘要現在會將頁面視為不受信任的內容,並標示其中嵌入的指示,而不是加以轉述。

提示快取與恢復

  • 恢復於前景產生的子代理時,不再改變其工具清單與系統提示前綴;先前這會讓該代理無法重複使用提示快取。代理隊友與恢復的子代理,也不再於之後的回合將 SubagentStart hook 上下文與預先載入的技能移出提示前綴。
  • 前一個程序在工具執行期間意外結束後再恢復時,不再改寫最後一則提示;被中斷的工具呼叫會保留並標示為已中斷。
  • 恢復讀取過大量檔案的長工作階段,所需時間縮短了。

工作階段與指令

  • 非互動式工作階段(使用 stream-json 輸入的 -p、Agent SDK、雲端工作階段)不再於每則新的使用者訊息時重設 shell 工作目錄;cd 現在會跨回合保留。
  • /model opusplan[1m] 不再以「Model not found」被拒絕。
  • 設定檔無法寫入時,/model 不再聲稱模型已「saved as your default」,而會說明儲存失敗及其原因。
  • 兩段式鍵盤快速鍵在第二個按鍵晚於一秒才送達時(在 tmux 中就會發生)不再悄悄取消;現在會等待 3 秒,逾時時也會顯示通知。
  • 在閒置逾時前剛好收到訊息時,背景(--bg)工作階段不再偶爾於回合進行中被淘汰。
  • 容器重新啟動後恢復工作流程執行時,若執行日誌遺失,現在會以清楚的錯誤失敗,而不是重新執行所有代理。

MCP、連接器與 Remote Control

  • 設定為 http、但只支援舊版 HTTP+SSE 傳輸的 MCP 伺服器現在可以連線,因為 Claude Code 會依 MCP 規格改用 SSE。
  • 雲端工作階段中的部分 claude.ai 連接器,即使已在 claude.ai 中連線,也不再顯示為需要驗證。
  • Remote Control 工作階段不再在回覆的最後一則訊息之前送出回合結束訊號;先前這可能讓 Claude 應用程式在回覆的最後部分送達前,就顯示回覆已完成。
  • 工作階段在更新權杖時被關閉後,VS Code 與 SDK 工作階段不再偶爾需要重新登入。

閘道遙測

  • Claude apps 閘道的 OTLP 遙測中繼,不再於收集器以格式錯誤或過大為由拒絕少數資料後,暫停對該收集器的所有轉送 30 秒。

v2.1.265 共包含 50 項變更,完整清單請參閱完整變更日誌。

如何更新

  1. 檢查已安裝的版本:claude --version
  2. 就地更新:claude update
  3. 如果您執行非互動式工作階段(使用 stream-json 輸入的 -p、Agent SDK 或雲端工作階段),請注意 cd 現在會跨回合保留,不再於每則新的使用者訊息時重設。

相關連結