發生什麼事
Claude Code 在 GitHub 釋出 v2.1.327,發布頁時間為 2026 年 11 月 17 日(UTC 23:17)。發布說明很長,新增項目約十來項,其餘是大量錯誤修正與行為調整。以下只挑與一般使用者較相關的部分。
新增
claude mcp add-json <name> -可從 stdin 讀入伺服器的 JSON,讓 token 不用寫在指令列上;不能在 Claude Code 工作階段內使用。/status新增清單,列出壞掉的 agent、skill、command 與 output style 檔案、快捷鍵錯誤、無法使用的沙箱、被忽略的權限設定,以及永遠對不上的 hook matcher。/config在某一列被其他設定覆蓋時會加註說明。/install-github-app在修改儲存庫之前會先請你確認。- 新增
attributionProject設定,可替 Claude apps gateway 指定工作階段的計費群組(需 gateway 設定admin.billing_group_tag)。 - 新增
/tui classic指稱非全螢幕的繪製模式,/tui default仍可用。 - 閘道提示標頭新增
x-claude-code-managed-settings-checksum。 - 恢復工作階段時,若先前訊息無法載入,會顯示一行說明。
- VS Code 擴充功能:檔案總管右鍵選單新增「Claude Code: Add to Chat」,可把選取的檔案與資料夾 @ 進對話。
權限與安全行為變更
- 路徑檢查會拒絕部分符號連結,「工作目錄內」的判定範圍也改了,因此有些路徑現在會詢問權限。
permissions.blockReadsOutsideWorkingDirectories在 bypass 與 auto 模式會對更多 Bash 指令詢問,auto 模式下有些會直接拒絕;指向 Read 或 Edit 拒絕規則下路徑的指令也更常被拒。- auto 模式會忽略更多「執行任意套件」的允許規則,例如
Bash(pnpm dlx *),以及這類規則的路徑或版本寫法,改由安全檢查決定。 - auto 模式退回計費分類器請求的提示改為說明:即將釋出的版本會移除這個退回機制,原本要檢查的動作會改成詢問或拒絕。
- 變數展開成超長文字的 Bash 指令會被拒絕;PowerShell 工具多了一種會先詢問的指令。
ExitWorktree在移除可能有未儲存內容的 worktree 前會詢問。claude mcp add --scope project遇到.mcp.json把伺服器放在最上層、沒有mcpServers鍵時會停止,不再覆寫檔案。- Claude in Chrome 會拒絕上傳部分憑證檔,需要的話得自己附加到頁面。
值得注意的修正
claude mcp add與claude mcp remove在專案範圍下,不再刪掉.mcp.json裡$schema或其他工具的servers等頂層鍵。- Remote Control 在 worktree 模式停止伺服器時,不再刪除執行中工作階段的 git 忽略檔案(例如
.env)。 - 使用
--use-anthropic-git-proxy的自架 runner,不再在啟動時刪除GIT_CONFIG_GLOBAL指向的非空目錄,改為保留、忽略該變數並警告。 /export不再未經詢問就覆蓋既有檔案。- 按下 Stop 之後,因重新啟動才到達的核准而繼續執行已允許指令的問題已修正(雲端與自架 runner 工作階段)。
- 多項恢復工作階段時遺失訊息或任務的問題,以及遠端 MCP 伺服器因 VPN 中斷等較長斷線後一直無法重連的問題,也在這一版處理。
- 另有許多終端機顯示問題(Ghostty、Windows Terminal、tmux 等)與
/plugin、/mcp介面細節的修正。
其他
- 新增環境變數
CLAUDE_CODE_DISABLE_SHELL_HEAD_START=1:這一版讓第一個 Bash 指令更快,shell 啟動檔可能在指令被核准前就執行,這個變數可關掉此行為。 - 新增提示:在較新模型與 PowerShell 下 commit 時,會告知 Claude 不要提交可能含密鑰的檔案。
- Anthropic 託管的雲端工作階段會忽略更多儲存庫端的旗標與外掛派送設定。
- VS Code:移除 IDE 連線中未使用的工具(openFile、saveDocument、getOpenEditors 等)。

對你的影響
- 如果你在腳本或 CI 裡註冊 MCP 伺服器,現在可以改用 stdin 傳入含 token 的 JSON,避免金鑰留在 shell 歷史或行程清單。
- 若你依賴 auto 或 bypass 模式,並設了
permissions.blockReadsOutsideWorkingDirectories或pnpm dlx之類的允許規則,升級後可能多出詢問或拒絕;發布說明也預告之後會移除計費分類器的退回機制,建議先檢查設定。 - 使用 project scope 的
claude mcp add/remove的團隊,這版修正了會誤刪.mcp.json其他欄位的問題,升級前如果遇過設定遺失,值得對照版本控制。