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 項變更,完整清單請參閱完整變更日誌。
如何更新
- 檢查已安裝的版本:
claude --version - 就地更新:
claude update - 如果您執行非互動式工作階段(使用 stream-json 輸入的
-p、Agent SDK 或雲端工作階段),請注意cd現在會跨回合保留,不再於每則新的使用者訊息時重設。