版本封存

Claude Code v2.1.296：gateway 的 code 政策、子代理各自的自動壓縮視窗，以及工作流程子代理模型設定

Claude Code v2.1.296 為 Claude apps gateway 政策新增 code 鍵，為子代理新增 autoCompactWindow，加入 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL 與 Read 工具的 allow_large 選項，並修正受管理掛鉤與 Windows 問題。

• 10 min read • 作者：ClaudeWorld

Claude Code v2.1.296 的變更日誌共有 79 個項目。此版本為 Claude apps gateway 的 managed.policies[] 新增 code 鍵，讓子代理可以設定自己的 autoCompactWindow，並新增 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL、CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS 以及 Read 工具的 allow_large 選項。修正項目涵蓋受管理設定中的掛鉤、Claude apps gateway 登入、以 ← 移至背景、外掛與 mods，以及多個 Windows 問題。

新功能

Claude apps gateway 的 code 政策

Claude apps gateway 的 managed.policies[] 接受新的 code 鍵。它帶有與 cli 相同的設定，並同樣套用到 Claude Desktop 的 Code 分頁；與 desktop 並用時，會開啟 Claude Desktop 的 gateway 模式。當 gateway 後方的 Code 分頁工作階段無法啟動時（包括在未針對 gateway 的 code 設定進行設定的機器上），原因現在會以回覆的形式顯示。

子代理各自的 autoCompactWindow

子代理的 frontmatter 與 --agents 定義接受 autoCompactWindow，讓子代理可以比主對話的視窗更早自動壓縮。

工作流程子代理模型與過載重試延遲

CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL 可讓所有工作流程代理都使用同一個模型，其他子代理則維持各自的模型。CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS 可為重試過載（529）請求時的退避設定較長的最大延遲。

Read 工具的 allow_large

Read 工具新增 allow_large 選項，當 Claude 需要整個檔案且內容空間足夠時，可以在一次呼叫中讀取超過一般大小上限的文字檔。

更大的 MCP 描述上限

預先送出的 MCP 工具描述與 MCP 伺服器指示的預設上限，從 2,048 個字元提高到 4,096 個字元。

費用數字中的 Sonnet 5.5 快取讀取價格

/cost、狀態列、--max-budget-usd 與 SDK 的費用數字，現在以每百萬 token $0.10 計算 Sonnet 5.5 的快取讀取（先前為 $0.20）。

← 會停止移動期間開始的工作

在工作階段移至背景的過程中開始的回合或 ! 指令，現在會被停止，而不是在看不見的地方執行完畢。

更實用的 --debug 輸出

--debug 現在會指出自訂代理檔案中無法識別的 frontmatter 欄位，並提示可能的拼字錯誤。針對工具呼叫、提示、SessionStart 與 Stop 的指令掛鉤，完成時也會記錄其指令、外掛、結果與耗時，方便找出緩慢的掛鉤。

VS Code：Claude in Chrome 會在瀏覽器操作前詢問

在 VS Code 中，Claude in Chrome 現在與終端機一樣，會在每個工作階段（包括以 @browser 連線的工作階段）執行瀏覽器操作前先詢問；在該工作階段允許某個網站後，就不會再重複詢問。

Claude Tag：記憶檔案與回覆頁尾

擁有 Claude Tag Admin 權限的成員，現在可以在 Activity 頁面的 Memory 分頁中建立、編輯與刪除工作區和頻道的記憶檔案。Slack 中的 Claude 現在只會在討論串最新一則回覆上顯示包含工作階段連結、模型與費用的頁尾。

修正與改進

  • 受管理的掛鉤：受管理設定中以 "continue": false 拒絕工具呼叫的 PreToolUse 掛鉤，以及封鎖呼叫的受管理 prompt 掛鉤，現在會結束該輪，而不只是拒絕該次呼叫；受管理設定中的 PostToolUse 掛鉤，也不再於部分工作階段中無法套用 updatedMCPToolOutput。
  • 掛鉤的輸入與輸出：在 UserPromptSubmit 掛鉤或 mod 的 prompt.submit 掛鉤執行期間按 Esc 或中斷，不再結束無介面工作階段、清除已輸入的提示，或放行未經檢查的提示；掛鉤輸出含有類似外掛提示標籤的文字時不再被改動；當 CLAUDE_ENV_FILE 只含單純的指派時，PowerShell 指令現在也能看到掛鉤寫入其中的變數。
  • 無介面 MCP：在切換目錄或重新載入外掛後，無介面工作階段不再啟動已針對該資料夾關閉的 .mcp.json 或外掛 MCP 伺服器。
  • Gateway 登入：以 "gateway" 提供 allowedProviders 的 Claude apps gateway，不再把在使用者設定中指定該 gateway 的筆電鎖在外面；在受管理設定將 forceLoginMethod 設為 gateway 但沒有 forceLoginGatewayUrl 的機器上，已儲存的 gateway 登入也不再被忽略（2.1.295 的迴歸問題）。
  • Token 計數：Haiku 5.5 與其他只接受自適應思考的模型，其 token 計數不再於某些閘道後方失敗，也不再在其他地方以預算思考方式計算。
  • 權限：Bash 權限檢查不再自動核准某些指派並使用 BASH_ARGV0 shell 變數的指令；在 Windows 上，Git Bash 中的 rm -rf /c/Users/<name> 在略過權限模式下現在會詢問。功能旗標尚未載入時，雲端工作階段也不再略過自動模式對「已儲存權限允許之 Claude in Chrome 操作」的檢查。
  • 編輯非 UTF-8 檔案：Edit 與 NotebookEdit 不再替換非有效 UTF-8 檔案（Windows-1252、Shift-JIS、GBK）中的所有非 ASCII 字元；這類編輯現在會被拒絕。
  • 以 ← 移至背景：背景服務回應較慢時，在 ← 之後立即送出的提示不再被執行兩次；SessionStart 掛鉤仍在執行時送出的提示，在 ← 移動工作階段時不再消失——它仍不會被送出，但現在可以用 ↑ 找回。
  • 恢復工作階段：無法讀取工作階段歷史時，--teleport 不再開啟空白對話；恢復的子代理不再被告知使用者拒絕了實際上是因工作階段關閉而中斷的工具呼叫；CLAUDE_CODE_RESUME_INTERRUPTED_TURN 也不再重新執行已由 MCP 工具結果結束的回合。
  • 秘密遮蔽：分享的對話記錄與除錯記錄中的秘密遮蔽，不再漏掉某些接在無值鍵之後的值，包括寫在 shell 字串中的 JSON。
  • 外掛與 mods：外掛提供的 $ 方法現在會在呼叫代理的工作目錄中執行；mod 重新載入或移除後仍在執行的掛鉤呼叫 $.agent.register 時會被拒絕；當回應宣告的 Content-Length 超過 4 MiB 的內容上限時，$.http.fetch 不再拒絕 HEAD 請求；名稱類似 constructor 的 marketplace 現在會由 add 明確拒絕，而不是造成內部錯誤。
  • claude.ai 同步：多個工作階段共用設定目錄時，從 claude.ai 同步的技能現在可以完成安裝；當同步外掛宣告的 marketplace 相依項目也是從 claude.ai 同步時，該外掛不再被停用。
  • 工作流程：工作流程腳本不再悄悄截斷巢狀超過約 20,000 層的結果、代理選項與其他值；Workflow 工具也接受使用 CRLF 換行的腳本檔案。
  • /code-review：在雲端工作階段、Agent SDK 與 IDE 整合中，/code-review 不再以原始 JSON 陣列結尾，發現的問題現在會以編號清單列出。
  • 終端機：在 MATE Terminal 等較舊的 VTE 系終端機中複製後，不再於畫面上印出多餘的 52;c;… 跳脫序列；開啟 /diff 面板或對話框時，toast 與通知不再一直等待而看不到；全螢幕模式下滑鼠指標所在的連結會加上底線；在大量程式碼的對話中，對話記錄切換（ctrl+o）的反應也更快。
  • Windows：長度超過約 1 KB 的 PowerShell 指令不再總是要求權限（允許規則與唯讀偵測現在適用到 32 KB）；stdio MCP 伺服器在關閉時不再被強制終止；在沒有 GitHub SSH 金鑰的機器上，claude plugin install 會改用 HTTPS 重試 GitHub owner/repo 來源。
  • Self-hosted runner：註冊被拒絕時，claude self-hosted-runner 不再印出誤導性的錯誤；在 --capacity 大於 1 的 runner 上，同一儲存庫的另一個工作階段啟動時，工作階段的 git fetch、pull 與 push 也不再失敗。
  • 對話記錄：CLAUDE_CODE_TRANSCRIPT_LOCAL_GC 不再從已儲存的對話記錄中捨棄文字含有 Unicode 行分隔符或段落分隔符（U+2028、U+2029）的訊息，也不再於只能釋放不到 10% 空間時重寫大型對話記錄檔；claude purge 也不再把這類提示留在歷史檔案中。
  • VS Code：claudeCode.spinnerVerbs 現在會出現在擴充功能的設定中，settings.json 可以自動完成並驗證它；以完整 Windows 路徑撰寫的聊天連結現在可以開啟檔案；當作業系統、VS Code 或 prefersReducedMotion 設定開啟減少動態效果時，工作中指示器不再持續動畫。
  • Code Review：審查完成後，pull request 上的 Code Review 檢查不再偶爾停留在「in progress」；管理設定現在會說明某項設定無法儲存的原因，而不是顯示籠統的失敗訊息。

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

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 就地更新：claude update
  3. Edit 與 NotebookEdit 現在會拒絕編輯非有效 UTF-8 的檔案（例如 Windows-1252、Shift-JIS 或 GBK），而不是替換其中的非 ASCII 字元；Claude 嘗試編輯這類檔案時，請預期會被拒絕。

相關連結