Claude Code 中文文档

create: 2026-06-28
update: 2026-07-31
author: thinkycx
title: 【译】Fast Mode:加速响应
description: Fast Mode 用更高 token 单价换取 Opus 2.5 倍响应速度。涵盖开关方式、定价对比、成本权衡、适用场景、代理/网关环境配置、速率限制回退机制,以及组织管理员启用配置。
category: translation
tags: claude-code, fast-mode, translation

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 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 ONFast 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" 而非连接错误消息:

  1. 仅使用 ANTHROPIC_AUTH_TOKEN 认证的会话:没有 claude.ai 登录或 Anthropic API key,也没有缓存的成功检查时,Claude Code 将 Fast Mode 视为被组织禁用(不发送请求)
  2. 拦截检查并返回自己页面的代理:例如 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 开启。TeamEnterprise 计划的 Owner 可通过 server-managed settings 在组织范围内部署。

{
  "fastModePerSessionOptIn": true
}

适用场景: 组织中用户运行多个并发会话时控制成本。用户仍可随时用 /fast 启用,但每次新会话都会重置。用户的 Fast Mode 偏好仍然被保存,移除此设置后恢复默认持久行为。

处理速率限制

Fast Mode 有独立于标准 Opus 的速率限制。 所有支持的 Opus 模型共享同一个 Fast Mode 速率限制池:在任意支持模型上的用量都从相同的限额中扣除。

触发速率限制或 usage credits 耗尽时的行为:

  1. Fast Mode 自动回退到标准速度
  2. 图标变灰表示冷却中
  3. 继续以标准速度和价格工作
  4. 冷却期结束后 Fast Mode 自动恢复

要手动关闭 Fast Mode 而非等待冷却,运行 /fast

研究预览

Fast Mode 是研究预览功能,意味着:

  • 功能可能根据反馈变化
  • 可用性和定价可能调整
  • 底层 API 配置可能演进

通过常规 Anthropic 支持渠道反馈问题。

相关文档