跳至主要內容

Claude Code v2.1.316:Opus 4.8 fast mode 棄用、新增環境變數

Claude Code v2.1.316 棄用 Opus 4.8 的 fast mode:2026 年 11 月 30 日移除後請求會回傳錯誤,要保留加速請改用 Opus 5.5。另新增 subagent effort、ultrathink 環境變數與 Claude apps gateway 群組共用預算。

Claude Code v2.1.316 共有 55 條變更:34 條修正、10 條新增、5 條改進、5 條行為變更、1 條棄用。最需要採取行動的就是那條棄用:Opus 4.8 的 fast mode 將於 2026 年 11 月 30 日移除。這一版也新增三個環境變數,為 Claude apps gateway 管理者帶來群組共用預算、分層 policy 與 Bedrock guardrail 標記,改變 Team 與 Enterprise 登入時伺服器管理設定的套用方式,並補上幾個權限缺口。如果你在 Opus 4.8 上使用 fast mode、營運 gateway,或替組織管理設定,請先讀前三節。

Opus 4.8 的 fast mode 已棄用

Opus 4.8 的 fast mode(快速模式)自 2026 年 10 月 30 日起棄用,並將於 2026 年 11 月 30 日移除。

日期變化
2026 年 10 月 30 日Opus 4.8 的 fast mode 棄用
2026 年 11 月 30 日Opus 4.8 的 fast mode 移除

移除之後,Opus 4.8 上的 fast mode 請求會回傳錯誤,而且不會退回一般的 Opus 4.8。也就是說,那天之後仍在 Opus 4.8 上要求 fast mode 的請求都會失敗,而不是改由一般模型執行。變更日誌的指示是:要保留加速效果,就遷移到 Opus 5.5。

如果你在 Opus 4.8 上使用 fast mode,請在 11 月 30 日前完成切換。本站的 Opus 4.8 fast mode 遷移指南 說明了怎麼移轉。

新功能

三個環境變數

  • CLAUDE_CODE_SUBAGENT_EFFORT 設定 subagent 在沒有其他地方指定 effort 時使用的 effort 等級,取代沿用 session 等級的做法。可以設定 effort 的其他地方,整理在本站的 effort 等級指南。
  • CLAUDE_CODE_DISABLE_ULTRATHINK 關閉 ultrathink 關鍵字。
  • CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP 保留彼此循環互相認證的系統交叉憑證(cross-certificate),適用於私有 CA 需要這類憑證的伺服器。

憑證問題也更容易排查:SSL 憑證錯誤現在會指出可能的原因(其中包括伺服器沒有附上中繼憑證),以及各自的修正方式。

Claude apps gateway

gateway 管理者有三項新增:

  • 群組共用預算(pooled group budget)。 一個由群組成員共用的每月預算,疊加在每位成員自己的上限之上,透過 spend limits 管理 API 的 pooled_budget 設定。
  • managed.policy_mode: layered。 所有符合某位開發者的 policy 都會生效,每一條都合併覆蓋在列於其下方的 policy 之上,而不是只套用第一條。
  • Bedrock 上游的 guardrail.input_tagging。 會把 prompt 包進 Amazon Bedrock guardrail 的 prompt attacks 過濾器所需的 input tag;使用 all_messages_and_system 時,system prompt 也會一併標記。

搭配的還有兩項 gateway 修正與一項 VS Code 新增:

  • 更嚴格的模型檢查。 gateway 現在會把請求中指定的每一個模型,都拿去比對 availableModels、deniedModels 與 models。指定了被封鎖模型的請求,會收到指明欄位的 400 錯誤。
  • claude auth login 在受管理設定要求使用 Claude apps gateway 的環境中不再拒絕執行;在終端機裡,它現在會顯示 gateway 的登入畫面。
  • VS Code 現在可以直接從聊天面板登入 Claude apps gateway,不需要終端機。

雲端 session 與 Code Review

  • MCP 伺服器的表單。 雲端 session 新增表單卡片,你可以填寫或拒絕 MCP 伺服器要求的表單;過去這類請求會在你看不到的情況下被取消。
  • 「Catching up…」 當你切回一個仍在把訊息同步到最新的雲端或 Remote Control session 時,會顯示這一行。
  • 依嚴重程度分類的審查結果。 Code Review 分析頁面新增一張卡片,顯示該期間的審查結果總數、依嚴重程度堆疊的每日圖表,以及各嚴重程度的數量。

值得注意的行為變更

  • Team 與 Enterprise 登入的伺服器管理設定。 從 Anthropic API 取得的設定現在會直接套用,不再跳出核准提示;無法通過驗證的已儲存副本則會被拒絕。
  • autoMode.allow 與排程任務。 不含 "$defaults" 的 autoMode.allow 清單,不再移除針對排程任務 prompt 的內建規則。
  • VS Code 中的 ultrathink 現在會以 xhigh effort 執行該輪,並在聊天輸入框中以彩虹色顯示,與終端機相同。
  • gateway 上被封鎖的模型。 指定了被封鎖模型的 Claude apps gateway 請求,現在會收到指明欄位的 400 錯誤(見上方的更嚴格模型檢查)。
  • Vertex AI 與 Amazon Bedrock 上的模型 alias。 當最新模型尚未開放給該帳號或區域時,sonnet、opus 與 haiku 現在會改用較舊的模型,而不是在 session 中途顯示錯誤。
  • 雲端 session 的網路 secrets。 Enterprise 成員現在可以在自己的雲端環境中新增與刪除網路 secrets,不再只能檢視。
  • Claude Tag 頻道設定。 Slack 頻道的 Respond automatically 開關,改為頻道 Configure 頁面與 Claude Tag 管理設定中的「How Claude participates」選項。

安全性與權限修正

以下每一項都是這一版修正的錯誤。

  • --restricted session 在 Read 允許規則涵蓋時,可能上傳工作目錄以外的檔案。
  • PowerShell hook 的命令若以型別轉換、param、using 或 attribute 開頭,回傳結束碼 2 時不會阻擋。
  • 不含 "$defaults" 的受管理 autoMode.allow 清單,會從宿主應用程式的 --settings、在 /permissions 新增的第一條規則,或 /auto-mode-setup 重新拿回內建例外。
  • auto 模式的中止沒有回報。 伺服器沒有回傳安全判定、使 auto 模式停下某一輪時,雲端 session 與雲端排程任務不會被標記為失敗;在背景 agent 仍在執行時,claude -p 的文字輸出有時也不會說明 auto 模式為何停下該輪。
  • CLAUDE_CODE_AUTO_MODE_SERVER=1 在由宿主應用程式(例如 Claude Desktop)啟動、位於代理或 LLM gateway 後方且關閉實驗性 beta 功能的 session 中被忽略。
  • 外掛 MCP 的 headersHelper 腳本,在某個以憑證命名的環境變數被設為 1 之類的開關值時,會收到損毀的 CLAUDE_PLUGIN_ROOT 與伺服器 URL。

Shell 與工具修正

  • macOS 與 Linux 上的 shell 命令,不再於 Claude Code 自行結束後繼續執行(例如憑證被拒或雲端 session 被封存時)。
  • 值含換行的 bash alias(Git Bash 除外),以及名稱以連字號(-)開頭的函式,在 Bash 工具的 shell 中不再變成亂碼或遺失。
  • 從 Bash 工具啟動的 bash 腳本,在匯出 SHELLOPTS 時不再於第一個命令後停止。
  • Windows:當 rc 檔設定了 errexit 與 pipefail,且只定義了 winpty alias 或完全沒有 alias 時,Bash 工具在 Git Bash 中不再遺失你的 alias 與函式。
  • 搜尋行程在逾時被終止卻沒有結束時(在 Windows 上觀察到),Grep 與 Glob 現在會正常回傳。
  • 壓縮的回應被截斷或損毀時,部分網路請求不再卡住。

模型、subagent 與 session

  • 沿用的模型會保留。 沿用上層 subagent 模型的 subagent,在被背景工作或訊息喚醒時,不再改用主模型。
  • /model <id> 會發出警告:當此版本無法辨識該模型、auto-compact 將假設 200K context window 時。過去不會有任何警告。
  • 不可見字元。 含有不可見字元的 prompt 過去需要按兩次 Enter 才會送出。現在一般 prompt 會在第一次按 Enter 時清理後送出,命令則仍會等待你檢查。
  • 恢復時的計畫。 修正一個罕見情況:對話的一部分仍在儲存時執行了 /clear 或 /resume,之後恢復該對話時,它的計畫沒有被還原。
  • SDK 的 register_repo_root 現在會載入工作目錄以外目錄的 CLAUDE.md(搭配 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 時)。
  • Artifact 工具 不再把 self 層級的 artifact 資料庫存取規則顯示為 ?,並會在拒絕可能丟掉這些規則的重新發布時,把規則引述回來。

工作流程改進

  • 從 Code 分頁啟動的 /code-review(Claude Desktop 或網頁版):雲端與 claude remote-control session 現在會顯示審查結果卡片,而不是純文字清單。
  • 大型 repository 上的 /diff:每次重新整理通常少跑一個全 repository 的 git 命令,且在 git 緩慢時會拉長重新整理的間隔。
  • 沒有 GitHub remote:當 /ultrareview、雲端 session 或雲端 agent 找不到 GitHub remote 時,訊息現在會請你到 github.com/new 建立 repository,而且 /ultrareview 不再建議一個會被 gh 拒絕的 gh 命令。

雲端 session、自架 runner 與 Claude Tag

  • 雲端 session:Changes 窗格中說明清單省略了哪些內容的註記,現在是分支名稱旁的徽章,而不是 diff 上方的一列。Claude 切換目錄後,Files 窗格的檔案搜尋不再把資料夾顯示成 ../.. 路徑;結果會顯示從專案根目錄起算的路徑。
  • 自架 runner:在 session 的行程被替換之後,Claude 工作時送出的訊息不再於按下 Stop 後仍被回覆;session 移到新機器時,MCP 伺服器的開關也不再偶爾遺失。
  • Claude Tag:Claude 在某個 Slack 頻道建立的 canvas 一旦也分享到其他頻道或私訊,Claude 不再拒絕從原頻道編輯或附加內容。當雙方組織都安裝了 Claude、而 Slack 把回覆送到另一方組織的應用程式時,Slack Connect 討論串中未標記的回覆不再無人回應。雲端排程任務在 Slack 中的即時狀態檢查清單不再停在一半:該次執行現在可以編輯它在執行期間發布的頂層訊息。

VS Code

除了從聊天面板登入 gateway,以及 ultrathink 以 xhigh 執行(兩者都已在上方說明)之外:

  • 模型設定帶有 [1m] 標記(例如 opus[1m])時,Effort 滑桿、Ultracode 開關與模型名稱不再消失。
  • 設定檔有錯誤時,已儲存的 /btw 旁支提問歷史不再被過早刪除。
  • 計畫以「Yes, and manually approve edits」核准的對話,在重新載入或重新啟動後不再回到 Auto 模式。

其餘修正

「hold space to speak」提示不再於一個 session 內就用完三次顯示機會,也不再於 push-to-talk 未綁定按鍵時顯示空白按鍵。首次執行設定在狹窄的終端機中,不再漏掉安全注意事項與終端機設定說明裡的字。Enterprise 問卷卡片不再於短暫停頓後就收下輸入的 1 或 0;輸入的答案現在需要按 Enter。

本頁涵蓋全部 55 條變更;每一條的原文請見官方變更日誌。

如何更新

  1. 檢查已安裝的版本:claude --version
  2. 直接就地更新:claude update
  3. 如果你在 Opus 4.8 上使用 fast mode,請在 2026 年 11 月 30 日前改用 Opus 5.5。

相關連結