Claude Code v2.1.281:可關閉署名、自動模式與 rm 安全性調整,以及 Claude apps gateway 新選項
Claude Code v2.1.281 新增 attribution: false 設定、MCP URL 模式 elicitation 與多項 Claude apps gateway 選項,並調整自動模式與危險 rm 指令的審查方式,另有大量修正。
Claude Code v2.1.281 是一個大型版本。它新增了可一次隱藏 commit 與 PR 署名的設定、MCP 伺服器的 URL 模式 elicitation 與多項 Claude apps gateway 選項,並調整自動模式與危險 rm 指令的審查方式。其餘項目則修正了恢復工作階段、經由代理伺服器與閘道的串流、對話框、vim 模式、VS Code、Claude Code on the web 與 Claude Tag 等方面的問題。
新功能
以 "attribution": false 隱藏署名
在 settings.json 中設定 "attribution": false,即可隱藏所有 commit 與 PR 署名。舊版 CLI 會略過含有此設定的設定檔,因此在跨版本共用的設定檔中,請繼續使用物件形式。
自動模式:伺服器端審查涵蓋更多 shell 指令
當自動模式的分類器審查在伺服器端執行時,唯讀與沙箱中的 shell 指令現在也會等待該審查,並在被標記時遭到封鎖。CLAUDE_CODE_AUTO_MODE_SERVER 現在也適用於直接連線 Anthropic API 的情況:0 表示退出伺服器端分類器(此時本機分類器會計入用量),1 表示加入。在 VS Code 與 JetBrains 面板中,自動模式退回到需計費的分類器請求時會出現 Continue/Stop 提示;/insights 也新增一項建議,估算自動模式在您最近的工作階段中原本可以處理多少次權限提示。
危險 rm 指令的防護
目標僅為命令替換輸出的遞迴 rm(例如 rm -rf "$(pwd)"),在自動模式與 --dangerously-skip-permissions 模式下不再未經詢問就執行;即使有 Bash 允許規則也會詢問,除非設定了 CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1。在這些模式下,危險 rm 的提示現在會等待 2 分鐘,逾時後拒絕該指令並附上改寫提示,讓無人值守的工作階段得以繼續(CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 可關閉此行為)。危險 rm 檢查也會標記更多情況,例如刪除目標為 shell 變數加上頂層目錄名稱。
「立即傳送」會將執行中的工具移到背景
立即傳送(send now,ctrl+enter 或 ctrl+x ctrl+s)現在會將執行中的工具移到背景,而不是取消該回合。
MCP URL 模式 elicitation 與更嚴格的外掛驗證
在使用 2026-07-28 協定的連線上,MCP 伺服器可以透過 URL 模式 elicitation 要求 Claude Code 開啟瀏覽器流程;若伺服器無法確認流程已完成,畫面上不會留下等待中的對話框。claude plugin validate 現在會檢查 MCP 伺服器,回報在載入時會被無聲捨棄的 .mcp.json 項目、未宣告的 ${user_config.*} 參照與不安全的 URL,並在 shell 形式的 hook 未以引號包住 ${CLAUDE_PLUGIN_ROOT} 時發出警告。
Claude apps gateway 新增功能
Claude apps gateway 支援 desktop 政策區塊中較新的 Claude Desktop 鍵,包括 blockReadsOutsideWorkingDirectories 與 disableBypassPermissionsMode。Bedrock 上游新增 assume_role,讓 gateway 以透過 STS 取得的 IAM 角色呼叫 Bedrock(必要時可在另一個 AWS 帳戶中,並可選擇每位開發者一個工作階段),以及 guardrail: {id, version},對經過該上游的每個請求套用 Amazon Bedrock guardrail(須在所有 Bedrock 上游都設定,或都不設定)。新的 telemetry.resource_attributes 設定可為 Claude Desktop 與 /login 工作階段的遙測加上固定標籤。
AGENTS.md 支援更多供應商
AGENTS.md 支援現在也適用於 Amazon Bedrock、Google Vertex AI、Microsoft Foundry、LLM 閘道,以及停用遙測的工作階段。
Self-hosted runner 改以檔案傳遞系統提示
Self-hosted runner 現在以私有檔案而非命令列文字將系統提示傳給 Claude Code,因此大型提示不再導致啟動失敗。會附加 --system-prompt 或 --append-system-prompt 的包裝程式或 command hook,必須改用 --system-prompt-file 或 --append-system-prompt-file。
修正與改進
- 恢復工作階段:恢復的工作階段不再以變動過的形式重新送出先前的回合(這可能導致 API 捨棄對話先前的推理),恢復非常大的工作階段時也不再有時只還原最後幾則訊息。
- 恢復工作階段:若工作階段在工具呼叫期間結束,恢復後 Claude 現在會看到該呼叫並得知其結果未知,手動恢復也不再加入隱藏的「Continue」訊息。讀取大量檔案的長工作階段,以及經過壓縮的超長工作階段,恢復速度也有所提升。
- 代理伺服器與閘道:被正常關閉串流的代理伺服器或閘道截斷的回應,不再在沒有警告的情況下顯示為完成;重複的串流事件也不再讓工具呼叫執行兩次。
- 代理伺服器與閘道:代理伺服器在回應中途丟失串流事件時,回應不再以「Content block not found」失敗;部分回應會被保留,網頁搜尋也會保留已收到的結果。
- 提示快取:在工具搜尋關閉時,無論 MCP 伺服器是在對話中途斷線,還是在恢復後仍在連線中,提示快取都不再遺失。
- 可靠性:修正 API 請求重試期間可能導致工作階段結束的當機(「unrecoverable interface error」),以及模型交替產生無法解析的工具呼叫與輸出長度截斷時,回合可能無視
--max-turns無限重試的問題。 - 啟動:未設定任何 MCP 伺服器或外掛時,互動式啟動不再等待受管理設定的網路請求(約 80 毫秒,網路無法連線時超過 17 秒);git 讀取、啟動遙測與 Bedrock/Vertex 模型升級檢查也不再於第一個畫面出現前執行。
- PDF:讀取或以 @ 提及大於 3 MB 的 PDF 時,不再延遲最多兩分鐘才回應。
- 權限:含有 NUL 位元組的權限規則現在不會匹配任何內容,而不是被展開成萬用字元匹配;權限對話框與附件檢查也不再於核准前讀取 macOS
/.vol、/.nofollow或/.resolve之下的路徑。 - 背景工作階段:在尚未通過工作區信任提示的目錄中,
claude --bg現在會先詢問信任,才啟動背景工作階段並執行其專案 hook;非互動執行時則會直接結束。 - 設定:
--setting-sources(以及 SDK 的settingSources)現在會轉交給衍生的工作階段,因此 teammates、/bg、claude agents工作階段與--worktree --tmux都會沿用上層的限制。 - 沙箱:
excludedCommands項目現在可以匹配git rev-parse --git-dir、名稱與 shell 內建指令相同的程式,以及含有[WIP]或#行的 commit 訊息;設定CLAUDE_CODE_TMPDIR時,沙箱中的 Bash 指令也能寫入$TMPDIR。 - MCP:阻擋型事件(PreToolUse 等)上的
mcp_toolhook,現在會等待其 MCP 伺服器連線(最長到 MCP 連線逾時),而不是被略過。當外掛或 claude.ai 連接器與已設定的伺服器以不同寫法表示同一個 URL 時,同一個 MCP 伺服器也不再被連線兩次。 - 對話框:在其餘的對話框與選擇器(例如
/memory、/hooks、/mcp、/export、/copy和/theme)中連按兩次 Ctrl+C 或 Ctrl+D,現在會關閉它們而不是結束 Claude Code;快速按兩次 Shift+Tab 也不再切到錯誤的權限模式。 - Vim 模式:修正
dj/dk/dG/dgg及其c/y形式只作用於部分行、1G跳到最後一行、d0/c0/y0沒有作用、cw在特定情況下連下一個字一起修改,以及在印地文、孟加拉文等文字中單字移動停在字中間的問題。 - 提示區:排隊中的訊息現在顯示在對話中轉圈指示的上方,而不是下方;提示下方的工作階段 artifact 連結也合併為一個頁尾標籤,點擊會開啟
/artifacts,並優先列出本工作階段的 artifact。 - Windows:寫入
$TMPDIR/…的 Bash 指令不再以「Permission denied」失敗;同時更新的 Claude Code 工作階段也不再互相刪除對方的claude.exe備份。 - macOS:登入鑰匙圈鎖定時(例如剛從睡眠喚醒),寫入憑證不再遺失已儲存的 MCP OAuth token 或刪除鑰匙圈項目。
- VS Code:擴充功能主機重新啟動後,編輯器分頁中的對話不再無聲卡住;無法載入歷史記錄的 claude.ai/code 工作階段現在會顯示錯誤,而不是開啟成空白或不完整的內容。
- Claude Code on the web 與 Claude Tag:當您的方案包含快速模式且所選模型支援時,雲端工作階段的編輯區模型選單會出現 Fast mode 開關。在 Slack 中,Claude 可能永久停止回應討論串內回覆的頻道,現在會在下一則傳給 Claude 的新訊息時自行恢復;Claude 也不再繼續執行您已按 Stop 停止的請求。
此版本共包含 177 項變更,完整清單請參閱完整變更日誌。
如何更新
- 檢查已安裝的版本:
claude --version - 就地更新:
claude update - 若 self-hosted runner 的包裝程式或
commandhook 會附加--system-prompt或--append-system-prompt,請改用--system-prompt-file或--append-system-prompt-file。若您採用"attribution": false,在舊版 CLI 也會讀取的設定檔中請保留物件形式,因為舊版會略過含有此設定的檔案。