版本封存

Claude Code v2.1.292：claude plugin install --marketplace、子代理的 effort 參數，以及預設採用 MCP 協定 2026-07-28

Claude Code v2.1.292 為 claude plugin install 新增 --marketplace，為 Agent 工具新增 effort 參數與 529 重試延遲環境變數，本機 MCP 伺服器預設改用協定 2026-07-28，並修正多項安全性問題。

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

Claude Code v2.1.292 是一次大型發布，變更日誌共列出 92 個項目。此版本讓 claude plugin install 可以在安裝時一併加入 marketplace，為 Agent 工具新增 effort 參數，新增 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS，並讓本機 MCP 伺服器預設協商 2026-07-28 協定版本。此版本也修正了數個安全性與權限問題，包括從網路（UNC）路徑讀取檔案時會略過權限提示的問題，另有許多外掛、mod、排程任務與雲端工作階段的修正。

新功能

claude plugin install 的 --marketplace

claude plugin install 現在接受 --marketplace <source>。必要時它會先加入該 marketplace（套用與 claude plugin marketplace add 相同的政策檢查），再從中安裝外掛。

Agent 工具的 effort 參數

Agent 工具新增 effort 參數，讓 Claude 以你要求的投入程度執行子代理。

CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS

新的 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS 環境變數可為重試過載（529）請求時的退避設定較長的基礎延遲。

MCP 協定協商與更快的啟動

本機（stdio）MCP 伺服器連線現在在所有安裝環境中（包括 Bedrock、Vertex 與 Foundry）預設協商 2026-07-28 協定版本；設定 MCP_PROTOCOL_NEGOTIATION=legacy 可選擇不採用。忽略新版協定檢查的本機伺服器在經歷一次緩慢連線後會被記住 7 天，之後直接以舊方式連線、不再等待。在 claude -p 與 SDK 工作階段中，第一輪不再等待 HTTP 與 SSE MCP 伺服器回應 resources/list。

Mod API 新增項目

Mods 可以掛接新的 prompt.autocomplete 事件，在提示輸入框的自動完成清單中加入自己的列。$.model.complete 新增提示快取：prompt 與 system 可接受文字區塊，在區塊上設定 cache: true 即可快取到該區塊為止的請求。agent.spawn mod 掛鉤現在也涵蓋工作流程代理，並附上其執行與索引資訊，讓 mod 可以拒絕它們。

更完善的 Ctrl+C 草稿復原

以 Ctrl+C 清除的提示，即使之後執行了斜線指令或送出了訊息，仍可用向上鍵找回。

沙箱自動允許帶環境變數前綴的直譯器指令

在使用者、受管理或 --settings 設定中啟用嚴格沙箱模式時，帶有環境變數前綴的直譯器指令（例如 FOO=bar python3 app.py）在沙箱自動允許下會直接執行，不再提示。

例行工作執行可不經核准發布僅自己可見的 artifact

排程與 Run now 的例行工作（routine）執行，現在可以不經核准就發布一個只有你看得到的新 artifact；要求連接器或其他存取權限的 artifact 仍會詢問。

更嚴格的 claude plugin test 與代理名稱長度限制

在 claude plugin test 中，測試所註冊的掛鉤內 expect 失敗，或引擎拒絕的 stub 回答，現在會讓測試失敗，而不是悄悄通過。代理名稱現在最多 256 個字元：超過的名稱會被拒絕，技能或外掛檔案中超過此長度的 name 會被忽略。

Code Review 分析

Code Review 分析中的 PRs reviewed 圖表，現在會顯示該期間的總數及其相較於前一期間的變化，並提供依儲存庫的細分。

修正與改進

  • 安全性：PreToolUse 掛鉤的核准與自動模式，不再於從網路（UNC）路徑讀取檔案時略過權限提示。沙箱中的指令不再能讀取 ~/.claude/seed-admin 下 /ultrareview 上傳的暫存檔案副本；透過讀取途中被替換的連結，macOS 與 Windows 上的筆記本或 PDF 讀取不再能回傳核准範圍以外的檔案；在設定擷取失敗期間，遭竄改的伺服器管理設定磁碟快取也不再能關閉或取代內建的政策外掛。
  • Windows 路徑：對家目錄或磁碟機的 8.3 短檔名或其他 Windows 替代寫法執行 rm -rf，現在會被視為刪除該資料夾或磁碟機。
  • 自動模式與計畫模式：設有 permissionMode: auto 的子代理定義，在自動模式無法使用時不再進入自動模式；在某一輪中途離開自動模式或計畫模式後，技能或斜線指令的 allowed-tools 規則不會在之後的回合中重新生效；重複出現 /name 的壓縮摘要也不再能讓 Claude 呼叫保留給使用者的技能。
  • 代理伺服器：設定 HTTPS_PROXY 時，Claude Code 自身的 API 請求（登入、政策、意見回饋、artifacts）不再忽略 NO_PROXY。
  • MCP：名稱超過 128 個字元的 MCP 工具不再讓所有請求失敗；該工具會被排除，並由 MCP 錯誤指出其名稱。
  • 受管理設定：首次執行時，marketplace add、install 等 claude plugin 指令不再於組織的受管理設定載入前就執行。
  • 無介面執行：單次的 claude -p 與 Agent SDK 執行不再於最終結果後 5 秒停止背景指令，單次 claude -p 執行也不再遺失排程喚醒；兩者現在都會等待完成。
  • 恢復工作階段與排程任務：從 claude --resume 工作階段選擇器或以 /resume 恢復時，會還原計畫模式。在 /resume、/branch 或 /clear 之後建立的已儲存排程任務現在會正常觸發；背景工作階段的程序重新啟動時，其 /loop 也不再悄悄停止。
  • 搜尋與讀取工具：Grep 與 Glob 在指定的檔案或資料夾無法讀取時，不再回報沒有符合項目，Claude 會重試一次或告知你。當 PDF 的 pages 為「6,9,15」這類清單時，Read 工具現在會回傳錯誤，而不是悄悄只回傳第一項；超過 256KB 的 @ 提及文字檔也不再被悄悄略過。
  • 工具輸入：Grep 接受以 file_path 代替 path，Write、WebFetch 與 Read 會忽略少數多餘的參數，而不是讓呼叫失敗。
  • 掛鉤：掛鉤輸出中寫入的 <system-reminder> 標籤，現在會在送達 Claude 前先跳脫。
  • 畫面繪製：冗長的項目符號或編號清單回覆，在串流、調整大小與於對話記錄（ctrl+o）中重新開啟時都快得多；偵測到 iTerm2 時，全螢幕模式也不再於每次調整視窗大小與按 Ctrl+L 時送出整個畫面的清除指令。
  • 提示輸入：Vim 模式不再讓游標停在行尾之後，j/k 在較短的行上也不再失去欄位；f/t/F/T/;/, 不再跳到其他行的符合項目。重疊的多次貼上不再有部分內容以輸入文字的形式送給 Claude；選取提示頁尾列時，快速輸入、輸入法文字與分解形式的重音字元也不再遺失。
  • 外掛與 mods：外掛的 tool.check 掛鉤回答允許時，不再於未顯示對話框的情況下執行需要你回答的工具（問題、計畫核准）；外掛掛鉤 worker 重新啟動期間的工具呼叫，不再在沒有外掛權限掛鉤的情況下被回覆；外掛的 tool.call 掛鉤現在看到的是工具實際執行時的參數。透過單一 const 大量呼叫 $.state 的外掛，載入或驗證也不再需要數分鐘。
  • 組織外掛：當組織的外掛回傳了使用者安裝的 mod 所加入的 $ 名稱時，該外掛不再於自身重新載入或其他外掛當機後被卸載；現在改為卸載該 mod。
  • 雲端工作階段：對話記錄很大的雲端工作階段，不再於權限核准後再次詢問；重試或編輯訊息時，排程任務與其他佇列中的通知不再遺失；在用戶端選擇的思考設定在容器重新啟動後也會保留。SVG、HEIC、TIFF 等較少見的圖片檔現在會以一般檔案附加；對於組織設定為需要核准的連接器工具，核准提示也不再提供無效的「Always allow」。
  • Claude Tag：Claude 仍在處理 Slack 討論串中的第一個請求時送出的回覆，不再被擱置或漏掉；@Claude !status 現在會說明 Claude 何時、為何停止讀取頻道中未標記的訊息；Allowed domains 卡片上新增 Edit 按鈕，讓 Enterprise 管理員可以開啟設定該頻道網域的存取套組。
  • Code Review：當 pull request 移到新的基底分支且舊分支已刪除時，佇列中的審查不再失敗（該 commit 會重新排入審查）；審查會修改 CLAUDE.md 的 pull request 時，現在會使用基底分支版本中的規則。

此版本共包含 92 項變更，完整清單請參閱完整變更日誌。

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 就地更新：claude update
  3. 本機（stdio）MCP 伺服器現在預設協商 2026-07-28 協定版本；若你的某個伺服器需要先前的行為，可設定 MCP_PROTOCOL_NEGOTIATION=legacy 選擇不採用。

相關連結