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現在會以xhigheffort 執行該輪,並在聊天輸入框中以彩虹色顯示,與終端機相同。 - 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」選項。
安全性與權限修正
以下每一項都是這一版修正的錯誤。
--restrictedsession 在 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-controlsession 現在會顯示審查結果卡片,而不是純文字清單。 - 大型 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 條變更;每一條的原文請見官方變更日誌。
如何更新
- 檢查已安裝的版本:
claude --version - 直接就地更新:
claude update - 如果你在 Opus 4.8 上使用 fast mode,請在 2026 年 11 月 30 日前改用 Opus 5.5。