Claude Code v2.1.327:新增 /status 診斷清單與 mcp add-json 讀 stdin

Claude Code v2.1.327 於 11 月 17 日釋出,新增設定問題診斷、從 stdin 讀入 MCP 設定,並收緊部分權限檢查、修正大量工作階段與終端機問題。

重點

  • v2.1.327 在 GitHub 發布頁顯示於 2026-11-17(UTC)發布,以錯誤修正為主,另有數項新增功能。
  • `claude mcp add-json -` 可從 stdin 讀入伺服器 JSON,token 不必出現在指令列。
  • `/status` 會列出壞掉的 agent、skill、command 檔、快捷鍵錯誤、沙箱不可用與無效的權限設定。
  • 多項權限檢查變嚴:部分符號連結、工作目錄外路徑與 PowerShell 指令會改為詢問或拒絕。

發生什麼事

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 等)。

Claude Code v2.1.327 釋出,新增 /status 診斷清單與 MCP 從 stdin 讀入。

對你的影響

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