版本封存

Claude Code v2.1.267：maxEffortLevel 設定、--system-prompt-snapshot off 與提示快取修正

Claude Code v2.1.267 新增 maxEffortLevel 設定與 --system-prompt-snapshot off，修正一系列與工具、模型切換及恢復有關的提示快取中斷問題，並強化受管設定的檢查。

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

Claude Code v2.1.267 是一次大型更新，變更日誌共有 53 個項目。此版本新增可跨供應商限制 effort 上限的 maxEffortLevel 設定，以及方便反覆調整提示文字的 --system-prompt-snapshot off 旗標。許多修正針對工具變動、模型切換或工作階段恢復時的提示快取重複使用，另外也修正了 Remote Control、VS Code、Claude Code on the web 與 Claude Tag 的問題。

新功能

maxEffortLevel 設定

新的 maxEffortLevel 設定可設於最上層，或在 modelSettings 下針對個別模型設定，會在所有供應商（包括 Bedrock、Vertex 與 Foundry）上限制 effort 等級的上限。使用者仍可選擇較低的等級。

--system-prompt-snapshot off

--system-prompt-snapshot off 會在每次請求時重新產生系統提示，而不是重複使用對話中已記錄的提示，適合用於反覆調整提示文字。

self-hosted runner 與閘道變更

  • self-hosted runner：--use-anthropic-git-proxy 現在會在註冊時回報給伺服器，並對仍透過舊版 git 代理伺服器進行 clone 的每個工作階段印出警告。
  • 閘道：forward_user_identity 上游現在會將 429 原封不動地回傳給電子郵件已被轉送的開發者，而不是容錯移轉到下一個上游，讓代理伺服器的每位使用者限制得以維持。

Claude Tag：自訂連接器連結

Claude Tag 管理設定中的預設連線表單新增「Use a custom connector」連結，讓您不必從頭開始，就能切換為自訂連線。

修正與改進

提示快取

  • 使用 /model 切換模型時，不再重新送出所有工具定義（會造成提示快取未命中）；commit 與 PR 的署名文字現在改以對話備註的形式送達，並會隨模型變更而更新。
  • 在沒有 ToolSearch 的工作階段中，工作階段中途出現的 MCP 與外掛工具不再被加入工具清單（先前會破壞提示快取的重複使用）；支援的模型現在會以延遲定義的形式接收它們。
  • 對話途中因 MCP 伺服器中斷連線或升級而消失的工具，不再改寫工具清單並捨棄先前的思考內容。
  • MCP 連接器重新連線的時間點與先前不同時，恢復的工作階段不再改寫內嵌的工具集，也不再於連接器重新連線前改寫先前的 MCP 工具公告。
  • 以互動方式恢復列印模式（-p）的對話時，系統提示前綴不再改變而中斷提示快取。
  • 以 --system-prompt 或 --append-system-prompt 啟動的子代理與工作階段，現在只會記錄一次系統提示與工具定義，而不是每次重新產生。

安全性與受管設定

  • 受管的 allowedHttpHookUrls、httpHookAllowedEnvVars 與 allowedChannelPlugins 無法讀取時，現在會一律不允許，而不是全部允許。
  • 在 macOS 與 Linux 上，含有反斜線的市集項目路徑不再能繞過已擷取市集的範圍限制檢查。

工作階段與恢復

  • 在預設 effort 仍被固定的模型上（Opus 4.7、Opus 4.8、Fable 5），自訂指令、技能與子代理 frontmatter 中的 effort: 不再被忽略。
  • 恢復大型工作階段（對話記錄超過 5 MB）時，平行工具呼叫及其 hook 輸出不再從重新載入的對話中遺失。
  • 透過 -p --resume 執行 /compact 或其他斜線指令後再恢復工作階段時，不再插入多餘的「Continue from where you left off.」回合。

Remote Control 與雲端

  • claude remote-control 的伺服器憑證過期時（約在啟動 30 天後），不再結束並中斷所有已連接的工作階段；主機現在會重新註冊並繼續運作。
  • 加入 Claude Desktop 或 VS Code 工作階段的 Remote Control 用戶端，不再在權限模式再次變更之前持續顯示過時的權限模式。
  • 對於受管設定要求使用沙箱的組織，雲端中的 Cowork 排程任務不再於啟動時失敗。
  • 在 Claude Desktop 等主機應用程式下，過期的 AWS 或 Google Cloud 憑證不再先以籠統的「request failed」重試十次，才顯示重新驗證的錯誤。

VS Code

  • 在已儲存對話記錄含有循環父連結的對話中進行分支、編輯先前訊息或回溯時，擴充功能主機不再卡在 100% CPU。
  • 聊天中的 diff 區塊現在會套用目前的 VS Code 色彩佈景主題（包括高對比），而不是一律以深色編輯器主題顯示。
  • @-mention 不再遺漏路徑含有空格的檔案；在使用 Windows（CRLF）換行字元的檔案上，於 diff 檢視中接受編輯也不再以「String not found in file」失敗。

Claude Code on the web 與 Claude Tag

  • Claude Code on the web：在沒有 Claude GitHub App 的組織中，gh 與 GitHub API 呼叫不再失敗；現在會使用您已連結的 GitHub 帳號，若尚未連結也會加以說明。
  • Claude Tag：組織的用量額度用盡時，Claude 不再回覆「The API rejected the request as invalid」，而會說明額度已用盡，並解釋如何增加額度。

v2.1.267 共包含 53 項變更，完整清單請參閱完整變更日誌。

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 就地更新：claude update
  3. 管理員請注意：受管的 allowedHttpHookUrls、httpHookAllowedEnvVars 與 allowedChannelPlugins 無法讀取時，現在會一律不允許而非全部允許，請確認這些設定可以正常讀取。

相關連結