跳至主要內容

Claude Code v2.1.273:閘道提示標頭、分叉 Remote Control 工作階段與受管 MCP 設定修正

Claude Code v2.1.273 新增可選用的 LLM 閘道請求標頭、MCP 中斷連線通知,並可從 Claude 應用程式分叉 Remote Control 工作階段,同時修正受管 MCP 設定被忽略的問題。

Claude Code v2.1.273 是一次兼具新功能與修正的更新,變更日誌共列出 64 個項目。此版本為 LLM 閘道新增可選用的提示標頭,在 MCP 伺服器自動重新連線放棄時發出通知,並可從 Claude 應用程式分叉 Remote Control 工作階段。此外,它撤回了 2.1.268 的一項權限變更,讓 Bedrock、Vertex 與 Foundry 上的自動模式暫時預設使用本機分類器,並修正多個權限、受管設定與錯誤訊息相關的問題。

新功能

LLM 閘道的提示標頭

Claude Code 現在可以向 LLM 閘道傳送 x-claude-code-request-class、x-claude-code-agent-type、x-claude-code-prev-tool-durations、x-claude-code-compaction 與 x-claude-code-context-compacted 請求標頭。這些標頭需要選擇啟用:設定 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 即可。

MCP 中斷連線通知

當 MCP 伺服器在工作階段中途中斷連線且自動重新連線放棄時,Claude Code 現在會顯示指向 /mcp 的通知。另外,MCP 伺服器的登入在工作階段中途過期時,錯誤訊息現在也會說明如何重新驗證(/mcp)。

從 Claude 應用程式分叉 Remote Control 工作階段

以 claude --remote-control 或 /remote-control 啟動的工作階段,現在可以從 Claude 應用程式分叉。分叉出的工作階段會以背景工作階段的形式在你的電腦上執行。

Bedrock、Vertex 與 Foundry 上的自動模式分類器

Bedrock、Vertex 與 Foundry 上的自動模式,目前暫時預設使用本機分類器。若要使用平台的伺服器端分類器,請設定 CLAUDE_CODE_AUTO_MODE_SERVER=1。

撤回對無法分析的 Bash 指令行檢查 deny 規則

2.1.268 中一項針對權限檢查器無法分析的 Bash 指令行(eval、env -C)檢查 Read 與 Edit deny 規則的變更已被撤回。像 time -p make build 這樣的指令會再次顯示提示,而不是直接被拒絕。

遙測、登入與意見回報變更

  • OTEL_LOG_TOOL_DETAILS=1 現在也會在費用與 token 指標中附上實際的代理、技能、外掛與 MCP 伺服器名稱。
  • 使用 Claude 帳號登入時,現在也會要求存取你在 claude.ai 上的外掛。
  • /bug 與 /feedback 回報現在只會包含最後一次 API 請求中與模型行為相關的參數(模型、系統提示、工具),並省略請求中繼資料與 CLAUDE_CODE_EXTRA_BODY 欄位。

修正與改進

  • 權限:在啟用 permissions.blockReadsOutsideWorkingDirectories 時,權限檢查器無法完整分析的 Bash 指令不再略過提示;在 bypass 模式下,子 shell 也無法再藏匿危險的 rm。在同一設定下,由儲存庫設定所指定的記憶目錄,不再被載入提示、回想、建立索引或用於記憶擷取。
  • 受管設定:透過 MDM 或 managed-settings.json 設定的 allowManagedMcpServersOnly、deniedMcpServers 與 disableClaudeAiConnectors,在同時存在伺服器受管設定時不再被忽略。
  • 技能:組織關閉 Skills 後,從 claude.ai 同步的技能不再繼續可用,而是移到可復原的垃圾桶。
  • 雲端供應商錯誤:Bedrock、Vertex 與 Foundry 上的 401/403 錯誤,以及 Claude apps gateway 的 403 錯誤,不再要求你執行 /login;訊息現在會指出需要更新的憑證,或請你聯絡閘道管理員。
  • 提示快取:/login、/upgrade 與 /extra-usage 不再捨棄對話中先前的思考內容;先前這會導致下一次請求必須完整重寫提示快取。
  • 上下文計量:上下文計量與自動壓縮不再把 advisor 工具回合計算成約兩倍的實際上下文大小;先前這會讓自動壓縮在大約一半的實際視窗時就觸發。
  • 子代理:當最後的串流回覆缺少 token 用量或沒有模型 id 時,子代理與背景代理不再被回報為失敗且結果始終未送達。子代理在執行中途被移到背景(例如因 CLAUDE_AUTO_BACKGROUND_TASKS)後,SDK 與 --output-format stream-json 的輸出也不再遺漏它剩餘的訊息與最終報告。
  • 自動模式與 artifact:在雲端或 Remote Control 工作階段中,Artifact 工具上傳你附加到對話中的檔案時,自動模式不再停下來等待核准。
  • macOS:Read 不再以「symlink resolution changed after permission was checked」拒絕拖曳進來的螢幕截圖,或系統以第二個路徑回報的任何檔案。
  • Shell 模式:已處於 shell 模式時,主提示不再丟棄開頭輸入的 !,因此可以輸入 ! grep … 這類否定指令。
  • 排程任務與 git:將 .claude/scheduled_tasks.json 複製到其他資料夾(例如新的 worktree)後,已儲存的排程任務不再於錯誤的工作階段中執行;儲存庫的 .git 目錄被移除或移走後,長時間執行的工作階段也不再重新建立空殼 .git/info/exclude。
  • 回應速度:在長時間工作階段中,hook 進度與子代理活動不再於每次更新時重新處理整段對話。
  • Artifact:artifact 資料庫的更新現在可以只移除單一欄位,而不必改寫整份文件;發布時若連線在抵達 claude.ai 後中斷,現在會安全地重送,而不會失敗或建立重複的版本。
  • 更清楚的錯誤訊息:工作階段內的 SSL 憑證與代理連線錯誤,現在會指出錯誤代碼與修正方式,例如針對未受信任的企業 CA 設定 NODE_EXTRA_CA_CERTS。/web-setup、/autofix-pr 與雲端工作階段的 GitHub 錯誤現在會提供具體原因,而非籠統的訊息;因 Claude 登入過期或被撤銷而無法建立雲端工作階段時,也會提示你執行 /login。
  • VS Code:對已停用產品意見回饋的組織,不再顯示「Report a problem」,/bug 與 /feedback 也不再開啟回報表單;在 Windows 上完成回合後,也不再出現紅色的「Claude Code process exited with code 4294967295」橫幅。
  • Windows:以 --add-dir 加入對應的網路磁碟機時,針對 UNC 路徑的網路路徑權限檢查已獲改善。
  • Claude Code on the web:管理員移除並重新加入組織連接器後,routine 不再失去對它的存取權;新增「Discard unsaved changes?」確認以保護你輸入的 routine 編輯;管理員的「Share cloud sessions」設定現在移到 Data and privacy 底下。
  • Claude Tag:Claude 現在會主動開始關注相關的公開頻道,例如對話所依賴的事故頻道。在組織共享的私人 Slack 頻道中設定的排程任務,不再悄悄地完全沒有張貼,現在會在建立時所在的討論串中持續執行;在 Claude 執行任務途中回覆較舊的討論串,也不再偶爾讓它從頭開始。
  • Code Review:若 PR 先前的審查列出「Additional findings」,將基底分支合併進該 PR 時現在只會進行較輕量的後續審查,而非完整重新審查;整份 REVIEW.md 不再因 @ 提及、跨行的程式碼片段或加上反引號的 HTML 標籤而被忽略;/ultrareview --post 在 GitHub 錯誤後重試時,現在只會張貼一次審查結果留言,並註明所審查的 commit。

此版本共包含 64 項變更,完整清單請參閱官方變更日誌。

如何更新

  1. 檢查已安裝的版本:claude --version
  2. 就地更新:claude update
  3. 若你在 Bedrock、Vertex 或 Foundry 上使用自動模式,且想使用平台的伺服器端分類器,請設定 CLAUDE_CODE_AUTO_MODE_SERVER=1。若要傳送新的閘道提示標頭,請以 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 選擇啟用。

相關連結