版本封存

Claude Code v2.1.283：第三方供應商預設自動模式、新的模型管控設定與 /doctor prompt-audit

Claude Code v2.1.283 在第三方供應商或關閉遙測時預設以自動模式啟動工作階段，新增 availableModelsMatch 與 deniedModels 受管理設定，以及 /doctor prompt-audit。

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

Claude Code v2.1.283 是一個大型版本。主要變更包括：在第三方供應商上或關閉遙測時，互動式工作階段採用新的預設權限模式；兩項讓管理員更嚴格控管可用模型的受管理設定；以及檢查為舊模型撰寫之提示寫法的 /doctor prompt-audit。此版本也撤回了 2.1.282 對 claude-ai 名稱的保留，並帶來 MCP、外掛、啟動延遲、VS Code 與雲端工作階段的修正。

新功能

第三方供應商或關閉遙測時預設使用自動模式

在第三方供應商上，或關閉遙測時，若未設定任何權限模式，互動式工作階段現在會以自動模式啟動。permissions.defaultMode 仍可覆寫此行為。

模型管控：availableModelsMatch 與 deniedModels

將新的 availableModelsMatch 受管理設定設為 "exact" 時，availableModels 的項目只允許其指名的模型版本，因此新推出的版本在列入清單前都會保持封鎖。新的 deniedModels 受管理設定則可封鎖特定模型，即使 availableModels 允許它們。

/doctor prompt-audit

/doctor prompt-audit（也可用 /checkup prompt-audit）會稽核您的 CLAUDE.md 檔案、技能、代理與指令，找出為舊模型撰寫的提示寫法。針對 Claude Code 設定執行時，報告會優先列出過時的路徑、過時的指令與互相矛盾的指示檔案，並保留 Claude Code 文件中記載的 thinking 關鍵字。

撤回 claude-ai 名稱保留

2.1.282 對 claude-ai 名稱的保留已撤回：以此命名的技能、指令、工作流程，以及 MCP 伺服器的技能與提示都會重新載入，Skill(claude-ai:*) 規則也恢復為一般的前綴規則。另外，Skill(anthropic-skills:<name>) 拒絕規則現在在 Claude Desktop 以外掛形式提供該技能時也會將其封鎖，Skill(skill:<name>) 拒絕規則則會匹配技能的別名與顯示名稱。

閘道與遙測新增功能

閘道提示標頭現在包含 x-claude-code-prompt-id，讓 LLM 閘道可以將服務同一個使用者提示的請求歸為一組；以 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 選擇加入。Claude apps gateway 新增可選用的 load_test_mode 區塊，會建立並簽署請求但不送往上游，並回傳固定回覆，方便對部署進行負載測試；另新增用於 Amazon Bedrock Mantle 端點的 mantle 上游供應商。設定 OTEL_LOG_TOOL_CONTENT=1 時，tool.output OpenTelemetry span 事件現在也會包含 MCP 工具、WebFetch 與 WebSearch 的輸出。

系統提示文字與檔案可同時使用

--system-prompt 與 --append-system-prompt 現在可同時接受文字與 -file 形式；檔案的文字會排在前面。

修正與改進

  • Windows：PowerShell 工具不再允許 cmd /c rd、rmdir、del 或 erase 刪除磁碟根目錄、家目錄，以及其他 Remove-Item 會拒絕刪除的資料夾。
  • MCP：長時間執行的 MCP 工具呼叫移到背景後，進度通知不再被捨棄；背景任務現在會顯示最新進度。
  • MCP：無狀態的遠端 MCP 伺服器短暫回傳 HTTP 404（例如代理伺服器重新部署途中）時，該伺服器不再於工作階段剩餘時間內無法使用卻仍顯示為已連線；工作階段結束時仍在啟動中的 stdio MCP 伺服器，也不再被留著繼續執行。
  • MCP：MCP 工具回傳的圖片現在也會存成檔案，讓 Bash、Read 等工具可以開啟；/context 現在會將 MCP 伺服器指示列為獨立一列並計入總數。
  • MCP：當使用者或本機設定檔無法寫入時（例如在沙箱中），claude mcp add、add-json 與 remove 不再回報成功。
  • 模型：當 ANTHROPIC_DEFAULT_HAIKU_MODEL 固定為其他模型時，/model 選擇器不再顯示寫死的 Haiku 版本與價格；Haiku 為工作階段主要模型時，DISABLE_PROMPT_CACHING_HAIKU 現在也會生效。
  • 模型：在 Opus 已具備 1M context window 的情況下，/model 選擇器的 Opus 列與 Default 模型名稱不再顯示「(1M context)」；context window 本身沒有變更。
  • 外掛：claude plugin validate 現在會讓 Claude Code 無法安裝的外掛或市集名稱驗證失敗，outputStyles、themes、monitors 或 lspServers 路徑不存在或指向外掛目錄之外的外掛也不會通過驗證。
  • 外掛：claude plugin uninstall 不再誤刪兩個 ID 僅大小寫不同的已安裝外掛中的另一個；installed_plugins.json 含有此版本無法讀取的記錄時，也不再被改寫而遺失記錄。
  • 外掛：家目錄或設定目錄移動後（例如在 bind mount 的 devcontainer 中），使用者安裝的外掛與市集不再以「cache-miss」載入失敗。
  • 沙箱：單一巢狀值無效時，受管理的 sandbox 設定不再整個被忽略；無效的值會以安全方向處理（fail closed），區塊的其餘部分仍會套用。
  • Remote Control：以 DISABLE_TELEMETRY 或 DO_NOT_TRACK 關閉遙測時，付費方案現在也可以使用 Remote Control。
  • 效能：改善了第一個回覆與第一個請求的延遲；啟動時，claude -p 與 Claude Code Remote 不再載入互動式介面，自動模式分類器的規則與 Artifact 工具也改為首次使用時才載入。
  • 清單：/help、/hooks、/copy、/memory、/rewind、/diff、/plugin 與其他選擇器支援翻頁鍵、滑鼠滾輪與點擊；/tasks 的每一列現在會顯示狀態圖示、名稱與完整資訊。
  • 提示建議：終端機中的提示建議在連續 20 次未被使用後會較少出現；使用其中一個即可恢復。
  • self-hosted runner：生命週期 hook 中的 git 現在會略過 repo 的 Git LFS pre-push hook、忽略可寫入的系統 core.hooksPath，且未使用 --configure-git 時不簽署 commit。在 Anthropic 管理的 git 下，GIT_SSL_CAINFO 與 GIT_SSL_NO_VERIFY 的處理也有所變更：runner 自身的 git 一律會驗證 Anthropic 的 git 路由，並以警告行說明各設定的適用範圍。
  • VS Code：自動切出 auto 或 bypass 模式失敗後，權限模式指示不再顯示為 Default、實際上卻仍以原模式執行，現在會重試切換直到成功；從網頁 teleport 過來的工作階段，也不再遺失 Claude 工作期間送出的訊息。
  • 雲端工作階段：從伺服器端重新啟動中恢復後，雲端工作階段不再偶爾重做已完成的步驟，例如重複發表留言或重複推送。
  • Claude Tag：新的「Channels Claude can search」管理設定可將 Claude 的 Slack 搜尋限制在它已加入的公開頻道，並可依組織、工作區或頻道設定。
  • Code Review：因達到時間上限而停止且沒有驗證任何內容的審查，現在會顯示為未完成、不收費，並會重試一次。

此版本共包含 94 項變更，完整清單請參閱完整變更日誌。

如何更新

  1. 檢查已安裝的版本：claude --version
  2. 就地更新：claude update
  3. 若您使用第三方供應商或關閉遙測，且尚未設定權限模式，互動式工作階段現在會以自動模式啟動；如需其他預設值，請設定 permissions.defaultMode。

相關連結