SpyBara
Go Premium

fast-mode.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

This page contains 78 additions and 21 deletions.

2026
Thu 10 23:00 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59

使用快速模式加快回應速度

在 Claude Code 中切換快速模式，以獲得更快的 Opus 回應。

快速模式是 Claude Opus 的高速配置，使模型速度提升最高 2.5 倍，但每個 token 的成本更高。當您需要速度進行互動式工作（如快速迭代或實時調試）時，使用 /fast 切換開啟，當成本比延遲更重要時，切換關閉。

快速模式不是不同的模型。它使用 Claude Opus 搭配不同的 API 配置，優先考慮速度而非成本效率。您獲得相同的品質和功能，只是回應速度更快。快速模式在 Opus 5 和 Opus 4.8 上受支援。它在 Sonnet、Haiku 或其他模型上不可用。

Claude Code 將 Opus 4.7 視為任何其他不支援快速模式的模型：切換至它會關閉快速模式。Opus 4.7 的快速模式已於 2026 年 6 月 25 日棄用，並於 2026 年 7 月 24 日移除。

需要了解的事項：

  • 使用 /fast 在 Claude Code CLI 中切換快速模式。VS Code 擴充功能遵循您的 fastMode 設定，並在選定的模型支援快速模式時提供切換快速模式命令。
  • 快速模式定價在 Opus 5 和 Opus 4.8 上為 $10/$50 MTok 輸入/輸出。
  • 適用於訂閱方案（Pro/Max/Team/Enterprise）上的 Claude Code 使用者和 Claude Console。Team 和 Enterprise 組織需要擁有者先啟用它，Console 組織需要先佈建存取權限，兩者均在需求下說明。
  • 對於訂閱方案（Pro/Max/Team/Enterprise）上的 Claude Code 使用者，快速模式僅透過使用額度提供，不包含在訂閱速率限制中。

切換快速模式

在 CLI 中，透過以下任一方式切換快速模式：

  • 輸入 /fast 並按 Tab 鍵切換開啟或關閉
  • 在您的使用者設定檔案中設定 "fastMode": true

預設情況下，在互動式工作階段中開啟的快速模式會在工作階段之間保持。在非互動式模式中，使用 -p 旗標時，/fast 僅在使用快速模式在其 --settings 值中啟動的工作階段中運作，例如 claude -p --settings '{"fastMode": true}'；切換則僅適用於該工作階段，不會儲存為您的預設值，在任何其他非互動式工作階段中，該命令會報告快速模式不可用。您可以配置快速模式在每個工作階段重設。詳見要求每個工作階段選擇加入以了解詳情。

您可以在 Claude 工作時執行 /fast，Claude Code 會在不等待回合結束的情況下切換快速模式。Claude Code 會以原始速度完成執行中的回合，因此速度變更會從您的下一個回合開始生效。如果您目前的模型不支援快速模式，開啟它也會切換您的模型，Claude Code 會在該回合的下一個請求中使用新模型。

為了獲得最佳成本效率，在工作階段開始時啟用快速模式，而不是在對話中途切換。詳見了解成本權衡以了解詳情。

當您啟用快速模式時：

  • 如果您目前的模型不支援快速模式，Claude Code 會切換到 Opus
  • 您會看到確認訊息：「Fast mode ON」
  • 快速模式啟用時，提示旁會出現一個小的 ↯ 圖示
  • 隨時再次執行 /fast 以檢查快速模式是否開啟或關閉

Opus 5 是 Claude Code v2.1.219 及更新版本中的快速模式預設值。在 v2.1.219 之前，快速模式在 v2.1.154 至 v2.1.218 版本上預設為 Opus 4.8，在 v2.1.142 至 v2.1.153 版本上預設為 Opus 4.7。

當您再次使用 /fast 關閉快速模式時，您仍保持在 Opus 上。要切換到不同的模型，請使用 /model。

在快速模式開啟時切換模型

快速模式會在兩個方向上跟隨您的模型切換：

  • 切換離開：當您切換到不支援快速模式的模型時，Claude Code 會關閉快速模式。這包括 Opus 4.7；在 v2.1.221 之前，快速模式在切換到 Opus 4.7 後會保持開啟，API 會拒絕請求。
  • 切換回來：當您儲存的快速模式偏好設定為開啟時，切換回支援的 Opus 模型會再次開啟快速模式，這與新工作階段預設啟動的偏好設定相同。模型切換永遠不會為儲存偏好設定為關閉的工作階段開啟快速模式，配置了每個工作階段選擇加入時，切換回來也不會開啟它；執行 /fast 以重新啟用它。

每當模型切換開啟或關閉快速模式時，Claude Code 會顯示 Fast mode ON 或 Fast mode OFF 確認，快速模式開啟時會出現 ↯ 圖示。無論您使用 /model、/config model=<model> 切換，或從透過遠端控制連接的裝置切換，都是如此。

Claude Code 會在模型切換、重新連接或失敗的可用性檢查後，將工作階段的快速模式狀態重新傳送到透過遠端控制連接的裝置。

了解成本權衡

快速模式的每個 token 定價高於標準 Opus：

模型 輸入 (MTok) 輸出 (MTok)
Opus 5 $10 $50
Opus 4.8 $10 $50

快速模式定價在整個 1M token 上下文視窗中是固定的。如需與標準 Opus 費率進行比較，請參閱 Claude 定價參考。

當您在對話中首次啟用快速模式時，您需要為整個對話上下文支付完整的快速模式未快取輸入 token 價格。對話進行得越深入，成本就越高，因此從一開始就啟用快速模式會更便宜。成本每個對話只適用一次，因此稍後關閉並再次開啟快速模式不會重複計費。如需了解機制，請參閱快速模式如何與 prompt cache 互動。

查看快速模式支出出現的位置

您看到快速模式支出的位置取決於您如何登入，因此請先執行 /status 來檢查。如果它顯示 Login method 列（例如 Claude Max account），表示您使用 Claude 訂閱登入。如果改為顯示 API key 列，您的請求將計費到 Claude Console 組織。

  • Pro 和 Max：您從使用額度中支付快速模式費用。前往 claude.ai 上的 設定 > 使用情況，其中 使用額度 部分顯示您本月在使用額度中花費了多少。該數字包括快速模式，但不會單獨列出。
  • Team 和 Enterprise：您的組織從其使用額度中支付您的快速模式使用費用。若要查看您自己的使用額度支出，請執行 /usage。如需了解您的組織在何處查看該支出，請參閱 Claude for Teams and Enterprise。
  • Claude Console：您的組織使用其 API 使用的其餘部分支付快速模式費用。在 Console 使用情況 和 成本 頁面上，在 分組依據 選單中選擇 Speed (Research Preview) 以將快速模式與標準速度使用分開。只有當選定的日期範圍包括快速模式使用時，您才會看到該選項。

決定何時使用快速模式

快速模式最適合用於回應延遲比成本更重要的互動式工作：

  • 快速迭代程式碼變更
  • 實時調試工作階段
  • 時間敏感的工作，有緊迫的截止日期

標準模式更適合：

  • 速度不那麼重要的長期自主任務
  • 批次處理或 CI/CD 管道
  • 成本敏感的工作負載

快速模式與努力等級

快速模式和努力等級都會影響回應速度，但方式不同：

設定 效果
快速模式 相同的模型品質、更低的延遲、更高的成本
較低的努力等級 較少的思考時間、更快的回應、複雜任務上可能品質較低

您可以結合兩者：在直接任務上使用快速模式搭配較低的努力等級以獲得最大速度。

要求

快速模式需要以下所有條件：

  • 僅限 Anthropic API 或訂閱：快速模式可透過 Anthropic Console API 和使用額度的 Claude 訂閱方案取得。它在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 AWS 上的 Claude Platform 上不可用。Console 組織也必須啟用快速模式。
  • 訂閱方案啟用使用額度：在 Pro、Max、Team 或 Enterprise 方案上，您的帳戶必須啟用使用額度，這允許超出您方案包含使用量的計費。在啟用之前，/fast 會顯示「Fast mode requires usage credits · /usage-credits to turn them on」。您啟用它們的方式取決於您的方案：
    • 在 Pro 和 Max 上，在 claude.ai 上的 Settings > Usage 中的 Usage credits 部分啟用它們，或執行 /usage-credits 以開啟該頁面。
    • 在 Team 和 Enterprise 上，具有計費存取權限的成員在 Admin settings > Usage 中為組織啟用它們，沒有計費存取權限的成員執行 /usage-credits 以向組織的管理員發送請求。
  • 付費 Console 組織：Claude Console 帳戶不使用使用額度，您的組織按 token 為快速模式付費，與其餘 API 使用量一起。在 Console 的免費 Evaluation 方案上，/fast 會顯示「Fast mode unavailable during evaluation. Please purchase credits.」若要清除它，在您的 Console 計費設定中購買額度。
  • Team 和 Enterprise 的管理員啟用：快速模式預設對 Team 和 Enterprise 組織禁用。管理員必須明確啟用快速模式，使用者才能存取它。

為您的組織啟用快速模式

您啟用快速模式的位置取決於您的組織使用的產品：

  • Console（API 客戶）：管理員在 Claude Code preferences 中啟用它。快速模式處於研究預覽中，因此您的組織必須先啟用快速模式存取權限，快速模式請求才能成功。若要取得存取權限，請聯絡您的帳戶經理或加入等候清單，如 Claude API 上的快速模式中所述。

    沒有佈建的存取權限，API 會以 429 拒絕每個快速模式請求，Claude Code 會將每個拒絕視為快速模式速率限制。與速率限制的冷卻時間不同，拒絕會持續到存取權限被佈建為止。

  • Claude AI（Team 和 Enterprise）：管理員在 管理員設定 > Claude Code中啟用它

另一個完全禁用快速模式的選項是設定 CLAUDE_CODE_DISABLE_FAST_MODE=1。詳見環境變數。

在代理和 LLM 閘道後面使用快速模式

在提供快速模式之前，Claude Code 會透過直接請求 api.anthropic.com 來檢查您組織的快速模式可用性。該檢查不遵循 ANTHROPIC_BASE_URL，因此在透過 LLM 閘道路由 Claude 流量並阻止直接出站到 api.anthropic.com 的網路上，即使推理請求有效，檢查也會失敗。該檢查確實使用已設定的 HTTP 代理，因此網路阻止只在 api.anthropic.com 即使透過代理也無法到達的地方才會導致檢查失敗。

當檢查失敗時，/fast 報告「Fast mode unavailable due to network connectivity issues」，請求以標準速度執行，即使您的組織已啟用快速模式。過去成功的檢查會從其快取結果繼續工作，因此被阻止的檢查主要影響新安裝。

當檢查到達 api.anthropic.com 但呈現 Anthropic 拒絕的認證時，開放網路上也會出現相同的連線訊息。其解析的金鑰是閘道發行的認證的工作階段，保存在 ANTHROPIC_API_KEY 中或由 apiKeyHelper 產生，會使用該金鑰發送檢查，被拒絕的請求會報告為連線失敗。

若要還原快速模式，在網路阻止是原因的地方允許直接出站到 api.anthropic.com，或設定與檢查失敗方式相符的任何變數：

  • CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1 將失敗的檢查視為可用，並仍然遵守「disabled by your organization」回應。當您的網路拒絕連線，或當 Anthropic 拒絕閘道認證時使用它；允許清單不會幫助認證情況，因為沒有任何東西被阻止。
  • CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 完全跳過檢查。當您的網路攔截請求而不是拒絕它時使用它。

兩個閘道設定報告「Fast mode has been disabled by your organization」而不是連線訊息，即使您的組織已啟用快速模式：

  • 僅使用 ANTHROPIC_AUTH_TOKEN 進行驗證的工作階段會跳過檢查：沒有 claude.ai 登入或 Anthropic API 金鑰，以及沒有快取的成功檢查，Claude Code 會將快速模式視為由您的組織禁用，而不發送請求。
  • 攔截檢查並用自己的頁面回答的代理，例如傳回 HTTP 200 阻止頁面的 TLS 檢查代理，被讀取為您的組織已禁用快速模式的回應。

在這兩種情況下，設定 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 以還原快速模式。CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS 不適用於任何一種情況，因為它只繞過失敗的檢查，而這兩種都會產生禁用回應。允許清單不會幫助持有人令牌情況，它永遠不會發送請求。

這些變數只影響用戶端檢查。當您的組織已禁用快速模式時，API 會拒絕快速模式請求，無論是否設定了它們。

設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 也會抑制可用性檢查。沒有先前快取的成功檢查，/fast 報告「Fast mode is currently unavailable」；兩個跳過變數在該設定中也會還原快速模式。

要求每個工作階段選擇加入

預設情況下，使用者在互動式工作階段中啟用的快速模式會在工作階段之間保持。若要變更此行為，在任何設定檔中將 fastModePerSessionOptIn 設定為 true，這會導致每個工作階段以快速模式關閉開始，並要求使用者使用 /fast 明確啟用它。Team 或 Enterprise 方案上的擁有者可以透過伺服器受管設定在組織範圍內部署它。

{
  "fastModePerSessionOptIn": true
}

這對於控制執行多個並行工作階段的使用者的組織成本很有用。使用者的快速模式偏好設定仍會保存，因此移除此設定會還原預設的持久行為。

處理速率限制

快速模式與標準 Opus 有不同的速率限制。所有支援的 Opus 模型共享一個快速模式速率限制池：任何模型上的使用都會從相同的限制中扣除。當您達到快速模式速率限制時：

  1. 快速模式自動回退到標準速度
  2. ↯ 圖示變灰以指示冷卻
  3. 您以標準速度和定價繼續工作
  4. 冷卻期過期時，快速模式自動重新啟用

要手動禁用快速模式而不是等待冷卻，請再次執行 /fast。

如果您在工作階段中途用完使用額度，Claude Code 會在標準速度和定價下重試每個被拒絕的快速模式請求，因此您可以繼續工作，且沒有冷卻期。您看到拒絕的方式取決於工作階段類型：

  • 在互動式工作階段中，Claude Code 會顯示「快速模式已禁用 · 使用額度已耗盡」通知，並在工作階段的其餘時間關閉快速模式。您儲存的快速模式偏好設定不會改變；執行 /fast 以重新開啟快速模式。
  • 在非互動模式中使用 --output-format stream-json，以及透過 Agent SDK，Claude Code 會在訊息串流上以 system 訊息的形式發出相同的文字，子類型為 notification，在您用完使用額度時每個回合發出一次。快速模式保持開啟。需要 Claude Code v2.1.221 或更新版本。

研究預覽

快速模式是研究預覽功能。這意味著：

  • 該功能可能會根據反饋而改變
  • 可用性和定價可能會改變
  • 底層 API 配置可能會演變

透過您通常的 Anthropic 支援管道報告問題或反饋。

另請參閱