Fast Mode:让 Opus 响应快 2.5 倍¶
核心价值:用更高的 token 单价换取更低的延迟,模型质量不变。
[!NOTE]
Fast Mode 处于 研究预览阶段,功能、定价、可用性可能随反馈调整。
Fast Mode 是 Claude Opus 的高速配置,最高可将响应速度提升 2.5 倍,代价是更高的 token 单价。用 /fast 命令即可切换——需要快速迭代或实时调试时打开,关注成本时关闭。
Fast Mode 不是另一个模型。 它使用相同的 Claude Opus,只是通过不同的 API 配置优先保证速度。质量和能力完全一致,只是响应更快。当前支持 Opus 5 和 Opus 4.8,不支持 Sonnet、Haiku 等其他模型。
Opus 4.7 已不再支持 Fast Mode。 Claude Code 在判断 Fast Mode 是否开启时(/fast 切换、模型双向切换、会话启动)仍将 Opus 4.7 视为 Fast Mode 模型,但 API 会拒绝这些请求而非以标准速度执行。请切换到 Opus 5 或 Opus 4.8 以继续使用加速。Opus 4.7 的 Fast Mode 于 2026 年 6 月 25 日弃用,2026 年 7 月 24 日正式移除。
关键信息速览:
| 项目 | 说明 |
|---|---|
| 开启方式 | CLI 中输入 /fast(VS Code 扩展暂不支持) |
| 定价 | Opus 5 和 Opus 4.8 均为 $10 / $50 per MTok(输入/输出) |
| 适用范围 | 所有订阅计划(Pro/Max/Team/Enterprise)及 Claude Console |
| 计费方式 | 订阅用户通过 usage credits 计费,不包含在订阅限额内 |
切换 Fast Mode¶
两种方式开关 Fast Mode:
- 输入
/fast后按 Tab 切换开/关 - 在 用户设置文件 中设置
"fastMode": true
默认情况下,Fast Mode 跨会话持久保存。 在非交互模式中(使用 -p 标志),/fast 仅在以 Fast Mode 启动的会话中生效,例如 claude -p --settings '{"fastMode": true}';此时切换仅影响当前会话且不保存为默认值,在其他非交互会话中该命令会提示 Fast Mode 不可用。管理员可以配置为每次会话重新开始时重置,详见 每次会话强制手动开启。
为了最佳成本效率,在会话开始时就启用 Fast Mode,而非中途切换。 原因见 理解成本权衡。
启用后的表现:
- 如果当前使用其他模型,Claude Code 自动切换到 Opus
- 显示确认信息:"Fast mode ON"
- 提示符旁出现
↯图标表示 Fast Mode 激活 - 随时运行
/fast可查看当前状态
关闭 Fast Mode 后不会切回原来的模型——你仍留在 Opus 上。要切换模型请使用 /model。
切换到不支持 Fast Mode 的模型时, Claude Code 会关闭 Fast Mode(Opus 4.7 除外,该模型上 Fast Mode 保持开启但 API 会拒绝请求)。切换回支持的 Opus 模型时,如果你保存的 Fast Mode 偏好为开启(即新会话默认启动时的偏好),Fast Mode 会自动重新开启;如果保存的偏好为关闭,模型切换不会开启 Fast Mode。配置了 每次会话强制手动开启 时,切换回来不会自动开启 Fast Mode,需手动运行 /fast。v2.1.208 之前,切换回来后 Fast Mode 保持关闭直到手动运行 /fast。
模型切换时的确认提示: 无论通过 /model、/config model=<model> 还是 Remote Control 切换模型,只要导致 Fast Mode 状态变化,Claude Code 都会显示 Fast mode ON 或 Fast mode OFF 确认,↯ 图标也会相应出现或消失。v2.1.218 之前,通过 /config model=<model> 或 Remote Control 切换时不显示确认。
版本历史: Opus 5 从 Claude Code v2.1.219 起成为 Fast Mode 默认模型。v2.1.154 到 v2.1.218 默认使用 Opus 4.8,v2.1.142 到 v2.1.153 默认使用 Opus 4.7。
理解成本权衡¶
Fast Mode 的 token 单价高于标准 Opus。
| 模型 | 输入(每 MTok) | 输出(每 MTok) |
|---|---|---|
| Opus 5 | $10 | $50 |
| Opus 4.8 | $10 | $50 |
Fast Mode 定价在整个 1M token 上下文窗口内统一,不分段。标准 Opus 的对比价格见 Claude 定价参考。
首次启用的成本影响: 在一个对话中第一次启用 Fast Mode 时,你需要为整个对话上下文按 Fast Mode 未缓存输入价格支付一次费用。对话越深,这笔费用越高——所以从头开始启用更划算。此费用每个对话只收一次,后续关闭再开启不会重复收取。机制详情见 Fast Mode 与提示缓存的交互。
何时使用 Fast Mode¶
适合 Fast Mode 的场景——交互式工作,延迟比成本重要:
- 快速迭代代码修改
- 实时调试会话
- 时间紧迫的任务
适合标准模式的场景:
- 长时间自主运行的任务(速度不敏感)
- 批处理或 CI/CD 流水线
- 成本敏感的工作负载
Fast Mode vs Effort Level¶
两者都影响响应速度,但机制完全不同。
| 设置 | 效果 |
|---|---|
| Fast Mode | 模型质量不变,延迟更低,成本更高 |
| 降低 Effort Level | 减少思考时间,响应更快,复杂任务质量可能下降 |
两者可以叠加:对简单任务同时启用 Fast Mode + 低 Effort Level,获得最大速度。
使用条件¶
Fast Mode 需要同时满足以下条件:
| 条件 | 说明 |
|---|---|
| Anthropic API 或订阅计划 | 仅通过 Anthropic Console API 和 Claude 订阅计划(使用 usage credits)可用。不支持 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、Claude Platform on AWS |
| Usage Credits 已开启 | 账户必须开启 usage credits(允许超出计划用量计费)。个人账户在 Console 计费设置 开启;Team/Enterprise 需管理员开启 |
| Team/Enterprise 需 Owner 启用 | 默认关闭。Owner 必须显式 启用 Fast Mode |
[!NOTE]
Fast Mode 用量直接从 usage credits 扣除,即使你的计划仍有剩余用量也是如此。Fast Mode token 不计入计划包含的用量,从第一个 token 起就按 Fast Mode 费率计费。[!NOTE]
如果组织未启用 Fast Mode,/fast命令会显示 "Fast mode has been disabled by your organization."。如果组织的availableModels白名单排除了 Fast Mode Opus 模型,/fast会被拒绝并提示 "is not in your organization's allowed models"。例外情况:当前会话已在支持 Fast Mode 的允许 Opus 模型上运行时,/fast会直接在当前模型上启用 Fast Mode。
为组织启用 Fast Mode¶
启用位置取决于组织使用的产品:
| 产品 | 操作位置 |
|---|---|
| Console(API 客户) | 管理员在 Claude Code preferences 中启用 |
| Claude AI(Team / Enterprise) | Owner 在 Admin Settings > Claude Code 中启用 |
也可通过设置环境变量 CLAUDE_CODE_DISABLE_FAST_MODE=1 完全禁用 Fast Mode,详见 环境变量。
在代理和 LLM 网关后使用 Fast Mode¶
Claude Code 在提供 Fast Mode 之前会检查组织的 Fast Mode 可用性,方式是直接向 api.anthropic.com 发送请求。 该检查不遵循 ANTHROPIC_BASE_URL,因此在通过 LLM 网关 路由 Claude 流量且阻止对 api.anthropic.com 直接出口的网络中,即使推理请求正常工作,检查也会失败。但该检查会使用配置的 HTTP 代理,所以只有在即使通过代理也无法到达 api.anthropic.com 时,网络阻止才会导致检查失败。
检查失败时, /fast 会报告 "Fast mode unavailable due to network connectivity issues",请求以标准速度运行——即使组织已启用 Fast Mode。过去成功的检查会从缓存结果继续工作,因此被阻止的检查主要影响新安装。
同样的连接错误消息也会出现在开放网络中, 当检查到达 api.anthropic.com 但携带了 Anthropic 拒绝的凭证时。如果会话解析的密钥是网关签发的凭证(存储在 ANTHROPIC_API_KEY 中或由 apiKeyHelper 产生),检查会使用该密钥发送请求,被拒绝的请求会被报告为连接失败。
恢复 Fast Mode 的方式—— 根据失败原因设置对应的环境变量:
| 环境变量 | 作用 | 适用场景 |
|---|---|---|
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 key,也没有缓存的成功检查时,Claude Code 将 Fast Mode 视为被组织禁用(不发送请求) - 拦截检查并返回自己页面的代理:例如 TLS 检查代理返回 HTTP 200 阻止页面,会被读取为组织禁用 Fast Mode 的响应
这两种情况下,设置 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 即可恢复。CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS 对这两种情况不适用——它只绕过失败的检查,而这两种情况产生的是禁用响应。白名单直接出口对 bearer-token 情况无效,因为该情况根本不发送请求。
这些变量仅影响客户端检查。 当组织确实禁用了 Fast Mode 时,API 无论如何都会拒绝 Fast Mode 请求。
设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 也会抑制可用性检查。在没有之前缓存的成功检查的情况下,/fast 会报告 "Fast mode is currently unavailable";此配置下两个 skip 变量同样可恢复 Fast Mode。
每次会话强制手动开启¶
默认行为: Fast Mode 跨会话保持。在任何设置文件中将 fastModePerSessionOptIn 设为 true,可让每次新会话都以 Fast Mode 关闭状态开始,用户需手动输入 /fast 开启。Team 或 Enterprise 计划的 Owner 可通过 server-managed settings 在组织范围内部署。
{
"fastModePerSessionOptIn": true
}
适用场景: 组织中用户运行多个并发会话时控制成本。用户仍可随时用 /fast 启用,但每次新会话都会重置。用户的 Fast Mode 偏好仍然被保存,移除此设置后恢复默认持久行为。
处理速率限制¶
Fast Mode 有独立于标准 Opus 的速率限制。 所有支持的 Opus 模型共享同一个 Fast Mode 速率限制池:在任意支持模型上的用量都从相同的限额中扣除。
触发速率限制或 usage credits 耗尽时的行为:
- Fast Mode 自动回退到标准速度
↯图标变灰表示冷却中- 继续以标准速度和价格工作
- 冷却期结束后 Fast Mode 自动恢复
要手动关闭 Fast Mode 而非等待冷却,运行 /fast。
研究预览¶
Fast Mode 是研究预览功能,意味着:
- 功能可能根据反馈变化
- 可用性和定价可能调整
- 底层 API 配置可能演进
通过常规 Anthropic 支持渠道反馈问题。