Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

快速模式

用 /fast 让 Opus 响应更快（最高约 2.5 倍），代价是更高的单 token 价格：开关与切换模型、成本权衡、使用要求、组织启用、代理与网关、按会话选择加入、速率限制（研究预览）。

快速模式处于研究预览阶段，功能、定价和可用性可能根据反馈变化。下文涉及的模型名和价格会随官方调整，一律以官方为准。

快速模式是 Claude Opus 的高速配置，让模型最高快约 2.5 倍，代价是更高的单 token 成本。需要速度做交互式工作（如快速迭代或实时调试）时用 /fast 打开，成本比延迟更重要时关掉。

快速模式不是另一个模型：它用同一个 Claude Opus，只是使用了优先速度而非成本效率的不同 API 配置，质量和能力完全一样，响应更快。在官方文档核实时，支持快速模式的是 Opus 5.5、Opus 5 和 Opus 4.8，Sonnet、Haiku 等其他模型不可用。Opus 4.7 不支持快速模式，所以切换到它会关闭快速模式（Opus 4.7 的快速模式于 2026 年 6 月 25 日被弃用，7 月 24 日移除）。

要点：

  • 在 Claude Code CLI 里用 /fast 开关快速模式；VS Code 扩展在所选模型支持快速模式时提供 Toggle fast mode 命令。Claude Code 把这个开关保存到 fastMode 设置。
  • 快速模式的每百万 token 输入/输出价格，官方核实时为 Opus 5.5 是 $8/$40，Opus 5 和 Opus 4.8 是 $10/$50（以官方定价页为准）。
  • 面向订阅套餐（Pro/Max/Team/Enterprise）上的 Claude Code 用户和 Claude Console 可用。Team 和 Enterprise 组织需要 Owner 先启用，Console 组织需要先开通访问权，详见「使用要求」。
  • 对订阅套餐用户，快速模式只通过用量额度提供，不包含在订阅的速率限制内。

开关快速模式

在 CLI 里，用以下任一方式开关：

  • 运行 /fast，按 Space 切换开或关，再按 Enter 确认。
  • 在用户设置文件里设置 "fastMode": true。

默认情况下，你在交互会话里打开的快速模式会跨会话保持；也可以配置成每个会话重置，见「要求按会话选择加入」。

在云端会话之外的非交互模式（带 -p）里，/fast 只在以 --settings 值启动并带有快速模式的会话里可用，例如 claude -p --settings '{"fastMode": true}'；此时开关只对该会话生效，不保存为你的默认值（-p 形式需要 Claude Code v2.1.205 或更高）。非交互模式的其他情形下，命令报告快速模式不可用。

Claude 工作时你也可以运行 /fast，Claude Code 无需等当前轮结束就切换快速模式：它以原速度完成正在运行的轮次，速度变化从你的下一轮开始生效。如果你当前的模型不支持快速模式，打开它还会切换你的模型，Claude Code 从该轮的下一个请求开始使用新模型。为了最好的成本效率，在会话开始时就启用快速模式，而不是在对话中途切换，见「理解成本权衡」。

启用快速模式时：

  • 如果当前模型不支持快速模式，Claude Code 切换到 Opus。
  • 你会看到确认消息「Fast mode ON」。
  • 快速模式生效期间，提示符旁出现小的 ↯ 图标。
  • 随时再运行 /fast 检查快速模式是开还是关。

在 Claude Code v2.1.280 及以后，Opus 5.5 是快速模式的默认模型；v2.1.280 之前，快速模式从 v2.1.219 起默认 Opus 5，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 重新启用。

无论是用 /model、/config model=<model>，还是通过 Remote Control 连接的设备切换，只要模型切换打开或关闭了快速模式，Claude Code 都会显示 Fast mode ON 或 Fast mode OFF 确认，快速模式开启期间出现 ↯ 图标。在模型切换、重新连接或失败的可用性检查之后，Claude Code 会把会话的快速模式状态重新发给通过 Remote Control 连接的设备。

在云端会话里使用快速模式

快速模式在你的账号可用时，也能在云端会话里工作，不论会话运行在 Anthropic 托管的基础设施还是自托管 runner 上（需要会话环境里是 Claude Code v2.1.271 或更高）。在会话里输入 /fast on 打开快速模式，它只对该会话保持开启，不保存为你的默认值；前文的使用要求在云端会话里同样适用。在浏览器 claude.ai/code 里，你也可以从消息框上的模型菜单开关快速模式：当你的套餐包含快速模式且所选模型支持时，菜单显示这个开关。

理解成本权衡

快速模式的单 token 价格高于标准 Opus（下表为官方核实时的数字，以官方为准）：

模型输入（每百万 token）输出（每百万 token）
Opus 5.5$8$40
Opus 5$10$50
Opus 4.8$10$50

快速模式的价格在完整的 100 万 token 上下文窗口内是固定的；用来对比的标准 Opus 费率见 Claude 定价参考。

你在一次对话里第一次启用快速模式时，要为整个对话上下文按快速模式的未缓存输入 token 价格付全价。对话越深，这笔钱越多，所以从一开始就启用快速模式更便宜。这个成本每个对话只发生一次，所以之后再关再开快速模式不会重复。机制见提示缓存页里「打开快速模式」一节。

在哪看快速模式的花费

你在哪里看到快速模式花费取决于你怎么登录，所以先运行 /status 检查：如果它显示 Login method 行（如 Claude Max account），你用的是 Claude 订阅登录；如果显示 API key 行，你的请求计入某个 Claude Console 组织。

  • Pro 和 Max：你用自己的用量额度支付快速模式。在 claude.ai 的 Settings > Usage 里，Usage credits 部分显示你本月花了多少用量额度；这个数字包含快速模式，但不单独拆分。
  • Team 和 Enterprise：你的组织用它的用量额度支付你的快速模式用量；要看自己的用量额度花费，运行 /usage；组织在哪里看到这笔花费，见 Claude for Teams and Enterprise 的成本说明。
  • Claude Console：你的组织连同其余 API 用量一起为快速模式付费。在 Console 的 Usage 和 Cost 页面，在 Group by 菜单里选 Speed (Research Preview) 可以把快速模式与标准速度用量分开；只有所选日期范围包含快速模式用量时才出现该选项。

决定何时用快速模式

快速模式最适合响应延迟比成本更重要的交互式工作：快速迭代代码改动、实时调试会话、有紧迫截止期的工作。标准模式更适合：速度不太重要的长时间自主任务、批处理或 CI/CD 流水线，以及对成本敏感的工作负载。

快速模式与 effort 级别

快速模式和 effort 级别都影响响应速度，但方式不同：

设置效果
快速模式模型质量相同、延迟更低、成本更高
较低的 effort 级别思考时间更少、响应更快，复杂任务上质量可能更低

你可以两者结合：在简单任务上，用快速模式配较低的 effort 级别以获得最大速度。

使用要求

快速模式要求以下全部满足：

  • 仅限 Anthropic API 或订阅：快速模式通过 Anthropic Console API 和使用用量额度的 Claude 订阅套餐提供，在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Claude Platform on AWS 上不可用。Console 组织还必须已开通快速模式访问权。
  • 订阅套餐需打开用量额度：在 Pro、Max、Team 或 Enterprise 套餐上，你的账号必须打开用量额度，也就是允许超出套餐包含用量的计费。在它们打开之前，/fast 报告「Fast mode requires usage credits」。怎么打开取决于套餐：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 需 Owner 启用：Team 和 Enterprise 组织默认禁用快速模式，必须由 Owner 明确启用后用户才能使用。

四个组织设置会阻止用 /fast 打开快速模式：

  • 未启用快速模式：组织没有启用快速模式时，用 /fast 打开会显示「Fast mode has been disabled by your organization.」
  • 托管设置关闭了快速模式：组织部署的托管设置里设了 fastMode: false 时，显示同样的消息。
  • 要求按会话选择加入：托管设置里设了 fastModePerSessionOptIn: true 时，除交互式终端会话之外的任何地方，/fast on 都以同样的消息被拒绝。
  • 快速模式的 Opus 模型不被允许：组织的 availableModels 允许列表排除了快速模式的 Opus 模型时，打开被拒绝并提示「is not in your organization's allowed models」；在已经运行于受支持快速模式的被允许 Opus 模型的会话里，/fast 改为在当前模型上启用快速模式而不切换模型。

为你的组织启用快速模式

在哪里启用取决于你的组织用哪个产品：

  • Console（API 客户）：管理员在 Claude Code 偏好设置里启用。快速模式处于研究预览，所以组织还必须已开通快速模式访问权，快速模式请求才会成功；获取访问权要联系你的客户经理或加入候补名单，详见 Claude API 上的快速模式文档。没有开通访问权时，API 以 429 拒绝每个快速模式请求，Claude Code 把每次拒绝当作快速模式速率限制；与速率限制的冷却不同，这些拒绝会持续到访问权开通为止。
  • Claude AI（Team 和 Enterprise）：Owner 在 Admin Settings > 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：把失败的检查当作可用，同时仍遵守「被你的组织禁用」的响应。当你的网络拒绝连接，或 Anthropic 拒绝网关凭据时使用；放行出口对凭据情形没有帮助，因为没有东西被阻断。
  • CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1：完全跳过检查。当你的网络拦截请求而不是拒绝它时使用。

有两种网关配置，即使组织已启用快速模式，也会报告「Fast mode has been disabled by your organization」而不是连接消息：只用 ANTHROPIC_AUTH_TOKEN 认证的会话会跳过检查（没有 claude.ai 登录或 Anthropic API key、也没有缓存的成功检查时，Claude Code 不发请求就把快速模式当作被组织禁用）；以及拦截检查并以自己的页面应答的代理（例如返回 HTTP 200 拦截页的 TLS 检查代理），这会被读作组织已禁用快速模式的响应。这两种情况下，设置 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 恢复快速模式；CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS 不适用，因为它只绕过失败的检查，而这两种情况产生的是「已禁用」响应；放行直连出口对 bearer 令牌的情形没有帮助，它从不发请求。

这些变量只影响客户端的检查。当你的组织禁用了快速模式，无论是否设置它们，API 都会拒绝快速模式请求；API 的拒绝即使设了跳过变量也成立：Claude Code 以标准速度重试被拒绝的请求，关闭快速模式，/fast 报告你的组织已禁用快速模式。设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 也会抑制可用性检查；在没有此前缓存的成功检查时，/fast 报告「Fast mode is currently unavailable」，两个跳过变量在该配置下同样能恢复快速模式。

要求按会话选择加入

默认情况下，用户在交互会话里打开的快速模式跨会话保持。要改变这一点，在任何设置文件里把 fastModePerSessionOptIn 设为 true，这会让每个会话以快速模式关闭开始，要求用户用 /fast 明确启用。Team 或 Enterprise 套餐的 Owner 可以经服务端托管设置在整个组织范围部署它。

{
  "fastModePerSessionOptIn": true
}

这在用户同时运行多个会话的组织里对控制成本有用。用户的快速模式偏好仍然被保存，所以移除这个设置会恢复默认的持久行为。当托管设置设置了该键，/fast on 只在交互式终端会话里可用；在其他任何地方，包括非交互模式、VS Code 扩展和云端会话，都会被拒绝，并提示你的组织已禁用快速模式。

处理速率限制

快速模式的速率限制与标准 Opus 是分开的。所有受支持的 Opus 模型共享一个快速模式速率限制池：其中任何一个的用量都从同一组限制里扣。当你触及快速模式速率限制时：

  1. 快速模式自动回退到标准速度。
  2. ↯ 图标变灰，表示冷却中。
  3. 你继续以标准速度和标准价格工作。
  4. 冷却结束后，快速模式自动重新启用。

要手动禁用快速模式而不是等冷却，再次运行 /fast。

如果会话中途用量额度耗尽，Claude Code 以标准速度和价格重试每个被拒绝的快速模式请求，所以你能继续工作，且没有冷却。你怎么看到这次拒绝取决于会话类型：

  • 在交互会话里，Claude Code 显示「Fast mode disabled · usage credits exhausted」通知，并在该会话剩余时间里关闭快速模式。你保存的快速模式偏好不变；运行 /fast 再次打开。
  • 在带 --output-format stream-json 的非交互模式以及通过 Agent SDK，Claude Code 在你的用量额度耗尽期间，每轮一次，把同样的文字作为 subtype 为 notification 的 system 消息发到消息流上，快速模式保持开启（需要 Claude Code v2.1.221 或更高）。

研究预览

快速模式是研究预览功能，这意味着：功能可能根据反馈变化；可用性和价格可能改变；底层的 API 配置可能演进。通过你常用的 Anthropic 支持渠道报告问题或反馈。

另见

  • 模型配置：切换模型并调整 effort 级别。
  • 有效管理成本：跟踪 token 用量并降低成本。
  • 状态行配置：显示模型和上下文信息。