# Claude Code fast mode 快速模式怎么用：单价翻倍，中转实测

> fast mode 不换模型，只让 Opus 5.5、Fable 5.2 输出更快，单价翻倍，订阅只扣用量积分。会话开头用 /fast 打开；走中转要确认 speed 被转发。

- URL: https://blog.laozhang.ai/zh/posts/claude-code-fast-mode
- Published: 2026-11-12
- Updated: 2026-11-12
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: Claude Code
- Tags: Claude Code, fast mode, 快速模式, Opus 5.5, Fable 5.2, 用量积分

---
Claude Code 的 fast mode（官方中文叫快速模式）不换模型，只把同一个 Opus 5.5 或 Fable 5.2 放到更快的推理配置上跑：按 Anthropic 的说法，输出速度最高快 2.5 倍，回答质量和能力不变，代价是单价翻倍。截至 2026 年 11 月 12 日，Opus 5.5 每百万 token 的输入/输出价从 $4/$20 变成 $8/$40，Fable 5.2 从 $8/$40 变成 $16/$80。Pro、Max、Ultra、Team 和 Enterprise 订阅用户只能用用量积分（usage credits，也常被叫作额外用量）支付这部分，套餐额度还没用完也照样扣积分。

要用它，先在 claude.ai 的 **Settings > Usage** 打开用量积分（Team 和 Enterprise 还要组织 Owner 先开启 fast mode），然后在会话刚开始、上下文还很短的时候，在终端里输入 `/fast on`，看到 `Fast mode ON` 和输入框旁的 `↯` 图标才算开好。别在一段聊了很久的会话里中途打开：第一次打开时，整段上下文要按 fast 的未缓存输入价重新计一遍，Opus 5.5 在 10 万 token 上下文时，这一下就要 $0.80–$1.00。

例外有三种。走 Amazon Bedrock、Microsoft Foundry 或 Claude Platform on AWS 的，在 Claude Code 里用不了 fast mode。走第三方中转或公司网关的，Claude Code 能把 `"speed": "fast"` 发出去，但真的变快的前提是中转把这个字段转给了 Anthropic；2026 年 11 月 12 日测试的一家中转收下了请求却丢掉了这个字段，计时没有任何提速。还在 Opus 4.8 上开着 fast mode 的，2026 年 11 月 30 日以后请求会被拒绝，要在那之前换到 Opus 5.5。

## fast mode 换来什么：同一个模型，输出最快 2.5 倍，单价翻倍

fast mode 是同一个模型的另一种 API 配置，用更高的单价换更快的输出，不是名叫"Opus Fast"的新模型。Anthropic 在 [Claude API 的 fast mode 文档](https://platform.claude.com/docs/en/build-with-claude/fast-mode)里写得很具体：提速体现在每秒输出 token 数上，不是首个 token 出来的等待时间，所以在流式输出长代码时最明显；"最高 2.5 倍"是 Anthropic 给出的上限，不同任务实际快多少会不一样。

| 模型 | 标准价（输入/输出，每百万 token） | fast mode 价 | 在 Claude Code 里的要求 |
| --- | --- | --- | --- |
| Fable 5.2 | $8/$40 | $16/$80 | v2.1.321 及以上 |
| Opus 5.5 | $4/$20 | $8/$40 | v2.1.280 及以上，此后 `/fast` 默认切到它 |
| Opus 5 | $5/$25 | $10/$50 | 研究预览 |
| Opus 4.8 | $5/$25 | $10/$50 | 已弃用，2026 年 11 月 30 日移除 |

价格来自 [Claude 定价文档](https://platform.claude.com/docs/en/about-claude/pricing)，截至 2026 年 11 月 12 日。fast mode 的单价在整个 100 万 token 上下文里都一样，提示缓存和数据驻留的倍率在它上面照常叠加。Sonnet、Haiku 和 Opus 4.7 都没有 fast mode，切到这些模型时 Claude Code 会自动把它关掉。还没决定用 Opus 5.5 还是 Fable 5.2 的，可以先看 [Fable 5.2 和 Opus 5.5 怎么选：哪档对哪档，同题实测贵 1.86 倍](https://blog.laozhang.ai/zh/posts/claude-fable-5-2-vs-opus-5-5)。

Opus 4.8 的 fast mode 已在 2026 年 10 月 30 日弃用，11 月 30 日正式移除，之后如果会话还停在 Opus 4.8 且开着 fast mode，API 会直接拒绝请求。想继续用 fast mode，就用 `/model` 切到 Opus 5.5（需要 Claude Code v2.1.280 以上），fast mode 会跟着保留；想留在 Opus 4.8，就运行 `/fast off` 回到标准速度。

## 哪些套餐和线路能用 fast mode：订阅只走用量积分

Claude Code 里能用 fast mode 的有三类：开了用量积分的 Claude 订阅、付费的 Claude Console 组织，以及有条件的 Google Cloud Agent Platform。Amazon Bedrock、Microsoft Foundry 和 Claude Platform on AWS 在 Claude Code 里不支持，`/fast` 会直接提示 `Fast mode is not available on this provider`。下表按 [Claude Code 官方中文文档《使用快速模式加快响应速度》](https://code.claude.com/docs/zh-CN/fast-mode)整理，截至 2026 年 11 月 12 日。

| 你的账号或线路 | 能不能用 | 条件 |
| --- | --- | --- |
| Pro、Max、Ultra 订阅登录 | 能 | 先在 claude.ai 的 Settings > Usage 打开用量积分，也可以在 Claude Code 里运行 `/usage-credits` 打开这个页面 |
| Team、Enterprise | 能，默认关闭 | Owner 在 Organization settings > Claude Code 开启；有账单权限的成员在 Organization settings > Usage 打开用量积分，没有权限的成员用 `/usage-credits` 向管理员申请 |
| Claude Console API key | 付费组织能 | 管理员在 Console 的 Claude Code preferences 开启；Opus 5.5 和 Fable 5.2 还受组织用量等级限制；免费 Evaluation 计划不能用 |
| Google Cloud Agent Platform | 只有 Fable 5.2 | Claude Code v2.1.322 以上，Fable 5.2 的区域设为 `global`、`us` 或 `eu` |
| Amazon Bedrock、Microsoft Foundry、Claude Platform on AWS | 不能 | 换到 Anthropic API 或订阅登录才有 |
| 第三方中转、公司 LLM 网关 | 看网关 | 中转要把 `speed` 字段原样转给 Anthropic，见后面中转一节 |

订阅用户要特别注意计费方式：fast mode 的花费直接从用量积分里扣，哪怕 Max 或 Ultra 的套餐额度还剩很多，也不会先用套餐额度。所以对订阅用户来说，开 fast mode 的每一轮都是额外按 API 价付钱。用量积分怎么按 API 价扣、什么时候换更大的套餐更划算，见 [Claude 额外使用费用：用量积分、Max 和 Claude Code 账单怎么判断](https://blog.laozhang.ai/zh/posts/claude-extra-usage-cost)；还在比较套餐本身的，见 [Claude Code 价格 2026：Pro、Max、Team、API 和额外用量怎么选](https://blog.laozhang.ai/zh/posts/claude-code-pricing-guide)。

## 怎么打开 fast mode：终端、VS Code、网页和 -p 的开法

在终端里最直接：运行 `/fast`，按空格切换开关，再按回车确认；也可以直接输入 `/fast on` 或 `/fast off`。打开后会显示 `Fast mode ON`，输入框旁出现 `↯` 图标，之后随时再运行一次 `/fast` 就能看当前状态。各入口的开法如下，截至 2026 年 11 月 12 日。

| 入口 | 怎么打开 | 是否保存为默认 |
| --- | --- | --- |
| 终端 CLI | `/fast` 后空格切换、回车确认，或 `/fast on` | 走 Anthropic API 时默认跨会话保留 |
| 用户设置文件 | 在 `~/.claude/settings.json` 写 `"fastMode": true` | 只在支持的模型上生效；Fable 5.2 要先在 Fable 5.2 上运行过一次 `/fast` |
| VS Code 扩展 | 命令面板里的 Toggle fast mode，所选模型支持时才出现 | 写入同一个 `fastMode` 设置 |
| claude.ai/code 网页和云端会话 | 输入框模型菜单里的开关，或在会话里输入 `/fast on`（环境要 v2.1.271 以上） | `/fast on` 只对当前会话有效 |
| 桌面版 Code 标签页 | 输入框的模型菜单 | 显示状态可能和实际不一致，见下面确认一节 |
| 无头模式 `claude -p` | 启动时带 `--settings '{"fastMode": true}'`（v2.1.205 以上） | 只对这一次运行有效 |

当前模型不支持 fast mode 时，`/fast` 会顺手把模型切到 Opus（v2.1.280 起默认是 Opus 5.5）；关掉 fast mode 则停留在当前模型，要换模型用 `/model`。Claude 正在干活时也能运行 `/fast`，正在进行的这一轮仍按原速度跑完，从下一轮开始生效。切到 Sonnet、Haiku 或 Opus 4.7 时 fast mode 会被关掉，再切回支持的 Opus 时，如果保存的偏好是开，它会自动恢复。

无头模式最容易开错。2026 年 11 月 12 日在一台 Mac 上用 Claude Code 2.1.322 测试（未登录状态）：直接运行 `claude -p "/fast"` 返回 `Fast mode unavailable: Fast mode is not available in the Agent SDK`；只在 `settings.json` 里写 `"fastMode": true` 再跑 `-p`，返回同一句话，发出的请求里也没有 `speed` 字段；改成启动参数 `--settings '{"fastMode": true}'` 后，这句提示消失，换成了 `Fast mode has been disabled by your organization`，原因是测试机没有登录，Claude Code 按"组织未开启"处理。也就是说，`-p` 只认启动参数里的设置，登录了有用量积分的账号后应这样写：

```bash
claude -p --settings '{"fastMode": true}' "运行测试，修复失败的用例"
```

## 值不值得开：会话开头开，中途切换按整段上下文重新计费

有人坐在屏幕前等结果的时候值得开，比如现场调试、改一处看一次效果的快速迭代、赶时间的修复；长时间自主运行的任务、批处理和 CI、在意成本的工作，留在标准速度更合适。原因很简单：同样的 token，fast mode 每一轮都正好贵一倍，换来的只是输出更快，没人在等的时候这笔钱买不到任何东西。

下面的数字是 2026 年 11 月 12 日按 Anthropic 标价复算的，不是账单，不含思考 token 和数据驻留倍率；订阅用户这部分按同样的 API 价从用量积分里扣。缓存热了以后的一轮，假设 10 万 token 已缓存、3,000 token 新输入、2,000 token 输出：Opus 5.5 标准速度是 100,000 × $0.20 + 3,000 × $4 + 2,000 × $20（每百万 token），约 $0.07；fast mode 下缓存读取、输入和输出单价都翻倍，约 $0.14。Fable 5.2 同一轮是 $0.12 对 $0.25。

中途打开的代价在第一轮。官方文档写明，一段对话里第一次打开 fast mode 时，整段上下文都按 fast 的未缓存输入价计费；fast 和标准速度各用各的缓存，之后每切换一次，又要把部分或全部上下文按未缓存价重读一遍。算法是"上下文 token 数 × fast 输入单价"（Opus 5.5 是 $8，Fable 5.2 是 $16，每百万 token）；这次请求同时会把上下文写进 fast 的缓存，而开 fast mode 时无论订阅（只扣用量积分）还是 API key，Claude Code 主对话默认都用 5 分钟缓存，写入按 1.25 倍计价，所以下表给的是 1 倍到 1.25 倍的区间。只有你用 `promptCacheTtl` 或 `CLAUDE_CODE_PROMPT_CACHE_TTL` 强制改成 1 小时缓存时，写入才按 2 倍算，金额是表中下限的两倍。

| 打开时的上下文 | 标准速度下一轮读缓存 | Opus 5.5 打开 fast | Fable 5.2 打开 fast |
| --- | --- | --- | --- |
| 2 万 token | $0.004 | $0.16–$0.20 | $0.32–$0.40 |
| 10 万 token | $0.020 | $0.80–$1.00 | $1.60–$2.00 |
| 30 万 token | $0.060 | $2.40–$3.00 | $4.80–$6.00 |
| 80 万 token | $0.16 | $6.40–$8.00 | $12.80–$16.00 |

来回切换更贵。以 Opus 5.5、15 万 token 上下文为例，按基础价算，打开 $1.20、关掉 $0.60、再打开 $1.20，三次合计 $3.00；算上 5 分钟缓存写入（1.25 倍）是 $3.75；同样三轮一直留在标准速度读缓存，合计只要 $0.09。触发速率限制后自动退回标准速度、冷却结束再回到 fast，也各算一次切换。所以要开就在会话开头开，开了就一直用到这段工作结束。为什么一次切换会让账单跳一下，见 [Claude Code 缓存未命中 token 成本：一次对话为什么突然变贵](https://blog.laozhang.ai/zh/posts/claude-code-cache-miss-token-costs)；各模型的缓存倍率见 [Claude Prompt Caching 提示缓存怎么用：各模型价格与命中实测](https://blog.laozhang.ai/zh/posts/claude-prompt-caching)。

![Opus 5.5 在 15 万 token 上下文里打开、关掉、再打开 fast mode 合计 $3.00，含 5 分钟缓存写入为 $3.75，一直留在标准速度三轮只要 $0.09](https://blog.laozhang.ai/posts/zh/claude-code-fast-mode/img/fast-mode-switch-cost.webp)

想快一点又不想多花钱，另一个办法是降低 effort：模型少想一些，回复更快，但复杂任务的质量可能下降；fast mode 则是质量不变、贵一倍，两者也可以同时用。effort 怎么设、各模型默认在哪一档，见 [Claude Code effort level 设置：各模型实测默认档与不生效排查](https://blog.laozhang.ai/zh/posts/claude-code-effort-level)。

## 怎么确认 fast mode 真的生效：看会话记录里的 speed 字段

界面上的 `Fast mode ON` 和 `↯` 图标说明开关打开了，不说明请求真的按 fast 跑了；最可靠的证据是会话记录里每条回复的 `speed` 字段。这不是多余的担心：[GitHub 上关于桌面版 Code 标签页 fast mode 显示不一致的 issue #100998](https://github.com/anthropics/claude-code/issues/100998) 截至 2026 年 11 月 12 日仍未关闭，多名用户报告输入框显示"Opus 5.5 Fast"，会话里每条回复却都是 `speed: standard`，其中一人统计到 10 月 19 日以来 10,307 次请求全部是标准速度，原因是账号没开用量积分。

Claude Code 把每个会话存成 `~/.claude/projects/` 下的一个 `.jsonl` 文件，按下面三步就能查：

1. 运行 `ls ~/.claude/projects/` 找到项目目录，目录名是项目路径把 `/` 换成 `-` 后的样子，例如 `-Users-you-myapp`。
2. 运行 `ls -t ~/.claude/projects/<项目目录>/*.jsonl | head -1` 找到最近的会话文件。
3. 统计这个会话里每种速度出现的次数：

```bash
grep -o '"speed":"[a-z]*"' <会话文件>.jsonl | sort | uniq -c
```

这个字段和 API 返回里的 `usage.speed` 是同一个东西，取值只有 `fast` 和 `standard`，按 fast 跑的回复应记成 `"speed":"fast"`。打开 fast mode 之后的几轮如果仍然全是 `"speed":"standard"`，说明没生效，先查用量积分有没有打开，再对照下一节的提示找原因。2026 年 11 月 12 日在一台 Mac 上统计最近 5 个会话记录，分别有 283、475、259、170、275 条 `"speed":"standard"`、0 条 fast，这几个会话本来就没开 fast mode，可以作为全是标准速度时输出长什么样的参照。如果设置过 `CLAUDE_CONFIG_DIR`，会话文件在那个目录下的 `projects/` 里。

钱花在哪里也能看到，先运行 `/status`：显示 `Login method`（例如 Claude Max account）的是订阅登录，在 claude.ai 的 Settings > Usage 看本月用量积分合计，fast mode 包含在内但不单列；Team 和 Enterprise 成员运行 `/usage` 看自己的用量积分花费；显示 `API key` 的是 Console 组织，在 Console 的 Usage 和 Cost 页面把 Group by 选成 Speed (research preview)，就能把 fast 和标准速度分开。

## "Fast mode …" 提示是什么意思：原因与处理对照表

下表的提示原文取自 2026 年 11 月 12 日 Claude Code 2.1.322 的 macOS 程序文件，界面上显示的就是这些英文；`-p` 模式下前面还会加上 `Fast mode unavailable: `。原因和处理大多来自官方文档；文档里没有解释的几条，原因是按提示字面推断的，已在表中注明。

| 提示原文 | 原因 | 怎么处理 |
| --- | --- | --- |
| `Fast mode requires usage credits` | 订阅账号没开用量积分 | Pro、Max、Ultra 在 Settings > Usage 打开或运行 `/usage-credits`；Team、Enterprise 由有账单权限的成员打开 |
| `Fast mode requires a paid subscription` | 文档未写，按字面推断：登录的是免费账号 | 升级到付费套餐，或改用付费 Console 组织的 API key |
| `Fast mode has been disabled by your organization` | Owner 没开启；托管设置写了 `fastMode: false`；`-p` 下未登录；设了 `fastModePerSessionOptIn` 却不在交互式终端里；网关只配了 `ANTHROPIC_AUTH_TOKEN` 或被 TLS 代理拦截 | 请 Owner 开启；在交互式终端里 `/fast on`；网关情况设 `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` |
| `… is not in your organization's allowed models` | 组织的 `availableModels` 白名单不含 `/fast` 要切到的模型 | 先用 `/model` 切到白名单里支持 fast 的模型再 `/fast`，或请管理员调整 |
| `Fast mode is not available on this provider` | 走的是 Bedrock、Foundry 或 Claude Platform on AWS | 这些线路没有办法打开，只能换到 Anthropic API 或订阅登录 |
| `Fast mode is not available in the Agent SDK` | `-p` 启动时没带 `--settings '{"fastMode": true}'` | 按上面的命令加启动参数 |
| `Fast mode unavailable during evaluation. Please purchase credits.` | Console 处于免费 Evaluation 计划 | 在 Console 的 billing 设置里购买额度 |
| `Fast mode unavailable due to network connectivity issues` | 可用性检查连不上 `api.anthropic.com` | 放行到 `api.anthropic.com` 的直连，或设 `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` |
| `Fast mode is currently unavailable` | 网关发的 key 不是 Anthropic 格式，或设了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`，检查没有发出 | 设 `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` |
| `↯` 变灰 | 触发 fast mode 自己的速率限制，进入冷却，期间按标准速度和标准价运行 | 等冷却结束会自动恢复；不想等就 `/fast` 关掉 |
| `Fast mode overloaded and is temporarily unavailable · resets in …` | 文档未写，按字面推断：fast 容量暂时不够 | 等倒计时结束，或先 `/fast off` 用标准速度 |
| `Fast mode disabled · Out of usage credits` | 用量积分用完，请求改按标准速度重试，本会话关掉 fast，保存的偏好不变 | 充值或调高上限后运行 `/fast` 重新打开 |
| `Fast mode disabled · usage credit limit reached` | 文档未写，按字面推断：用量积分到了设定的上限 | 在 Settings > Usage 调高上限，或等下个计费周期 |
| `Fast mode disabled · Usage credits turned off by your organization` | 组织关掉了用量积分 | 找组织管理员 |
| `Fast mode disabled · Usage credits turned off for your account` | 你的账号没开用量积分 | 个人套餐在 Settings > Usage 打开，组织成员找管理员 |
| `Fast mode needs Vertex region global, us or eu · …` | Agent Platform 上 Fable 5.2 的区域不对 | `export VERTEX_REGION_CLAUDE_FABLE_5_2=global` 后重启 Claude Code |
| `Fast mode was refused for this project · trying again in …` 或 `Using standard speed on … · fast mode wasn't available` | Agent Platform 拒绝了 fast 请求，已回到标准速度 | 运行 `/fast on` 立即重试 |
| `… auto mode is off while fast mode is on. Run /fast off to change this.` | 文档未写，按字面推断：fast mode 开着时 auto mode 被关闭 | 需要 auto mode 就 `/fast off` |
| `Opus 4.8 fast mode is deprecated and will be removed on …` | Opus 4.8 的 fast mode 11 月 30 日移除 | `/model` 切到 Opus 5.5，或 `/fast off` |
| `Unknown argument "…"` | `/fast` 后面跟了 on、off 以外的参数 | 只用 `/fast`、`/fast on`、`/fast off` |

用量积分用完时有一个容易误会的地方：交互式会话里 fast mode 会自己关掉，但 `settings.json` 里仍是 `"fastMode": true`，看起来像是设置失灵。[GitHub issue #107249（fast mode 在运行中的 CLI 会话里自动关闭）](https://github.com/anthropics/claude-code/issues/107249)的报告者最后查明就是这个原因，按"不是 bug"关闭。`-p` 配合 `--output-format stream-json` 时则不同，fast mode 保持打开，每一轮都会在消息流里收到一条同样文字的 `system` 通知。

## 走中转或网关能用 fast mode 吗：看 speed 有没有被转发

能不能用取决于两道关。第一道在 Claude Code 本地：它会直接向 `api.anthropic.com` 查询组织是否开通了 fast mode，这个请求不走 `ANTHROPIC_BASE_URL`，但会走配置的 HTTP 代理，网络屏蔽了 Anthropic 时就会报上一节里的网络或组织类提示。第二道在中转：开了 fast mode 的请求会带上 `"speed": "fast"`，中转必须把这个字段原样转给 Anthropic，返回的 `usage` 里才会出现 `"speed": "fast"`；中转如果把字段删掉，你照样能收到正常回复，只是不会变快，界面上也不会有任何提示。

2026 年 11 月 12 日用本地模拟的 Anthropic 端点抓取了 Claude Code 2.1.322 在 `-p` 模式下发出的请求。开着 fast mode 时，请求体里有 `"speed": "fast"`，模型是 `claude-opus-5-5`，`anthropic-beta` 请求头末尾多了 `fast-mode-2026-02-01`。用网关签发的非 Anthropic 格式 `ANTHROPIC_API_KEY` 时，`/fast on` 显示 `↯ Fast mode ON · $8/$40 per Mtok (this session only)`，请求照常带上了 `speed`，没有用任何跳过检查的变量；官方文档说这种配置会提示 `Fast mode is currently unavailable`，在这次 `-p` 测试里没有出现，交互模式下可能不同。界面上显示的单价是 Anthropic 的价格，不是中转的价格。

只设置 `ANTHROPIC_AUTH_TOKEN` 的情况最容易被忽略。同一次测试里，`/fast` 提示 `Fast mode has been disabled by your organization`，之后发出的请求都不带 `speed`，也就是悄悄按标准速度在跑；加上 `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` 后，请求里才出现 `"speed": "fast"`。跳过变量只改本地检查，如果组织确实没开 fast mode，API 仍会拒绝，Claude Code 随后改按标准速度重试并关掉 fast mode。base URL、key 和网关本身怎么配，见 [Claude Code API 配置：先选路由，再设置 Key、模型和网关](https://blog.laozhang.ai/zh/posts/claude-code-api-configuration)。

同一天还直接测了一家中转（LaoZhang 的 `/v1/messages` 接口）。给 `claude-opus-5-5` 发带 `"speed": "fast"` 和 beta 头的请求，返回 HTTP 200，但 `usage` 里没有 `speed` 字段，`service_tier` 是 `standard`；给 Sonnet 5.5、Haiku 5.5 发 `"speed": "fast"`，给 Opus 发随便写的 `"speed": "turbo"`，同样返回 200，而官方 API 对不支持的模型会报错，说明这个字段在转给上游之前就被丢掉了。计时也印证了这一点：非流式、`max_tokens` 2000、关闭思考，标准请求和 fast 请求交替跑 4 轮，标准速度中位数每秒 118.1 个输出 token（108.9–119.4），"fast"中位数 117.2（114.5–119.8），没有提速。这只是一家中转的结果，别家要自己验证。

![走中转使用 fast mode 要过两道关：Claude Code 先直连 api.anthropic.com 做可用性检查，中转再把 speed 字段转给 Anthropic；实测的一家中转丢掉了该字段，输出速度中位数 118.1 对 117.2 token/s](https://blog.laozhang.ai/posts/zh/claude-code-fast-mode/img/relay-speed-two-gates.webp)

验证任何一家中转只要一条请求。把模型换成不支持 fast mode 的 Sonnet 5.5：官方 API 会报错，返回 200 就说明 `speed` 被丢掉了；再对 Opus 5.5 发一次，看返回的 `usage` 里有没有 `"speed":"fast"`。有的中转用 `Authorization: Bearer` 认证，按它的文档改请求头即可。

```bash
curl -s "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":32,"speed":"fast","messages":[{"role":"user","content":"Say OK"}]}'
```

## Claude Code fast mode 的其他问题

**fast mode 能缩短等第一个字出来的时间吗？**
基本不能。Anthropic 的 Claude API 文档写明，fast mode 的提速体现在每秒输出 token 数上，不是首个 token 的等待时间。回复越长、越是流式输出，差别越明显；如果你的等待主要花在工具调用或首个 token 上，开了也感觉不到多少。

**怎么彻底禁用 fast mode，防止多个会话一直按 fast 计费？**
在环境变量里设 `CLAUDE_CODE_DISABLE_FAST_MODE=1` 会完全关闭 fast mode。只想让每个会话默认关闭、需要时再手动打开，就在设置文件里写 `"fastModePerSessionOptIn": true`；Team 和 Enterprise 的 Owner 可以通过服务端托管设置对整个组织下发，此时 `/fast on` 只在交互式终端里有效。这两项都来自截至 2026 年 11 月 12 日的 Claude Code 文档。

**直接调 API 时，fast mode 能和 Batch API 或 Priority Tier 一起用吗？**
不能。截至 2026 年 11 月 12 日，Claude API 文档写明 fast mode 不支持 Batch API，也不支持签了 Priority Tier 承诺的用量。API 请求触发 fast 的速率限制时返回 429，官方 SDK 默认会按 `retry-after` 重试 2 次；想改用标准速度，就去掉 `speed` 重新发送，但要知道这会让提示缓存失效。

## 参考来源

本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-11-12。

- [Claude API 的 fast mode 文档](https://platform.claude.com/docs/en/build-with-claude/fast-mode) (platform.claude.com)
- [Claude 定价文档](https://platform.claude.com/docs/en/about-claude/pricing) (platform.claude.com)
- [Claude Code 官方中文文档《使用快速模式加快响应速度》](https://code.claude.com/docs/zh-CN/fast-mode) (code.claude.com)
- [GitHub 上关于桌面版 Code 标签页 fast mode 显示不一致的 issue #100998](https://github.com/anthropics/claude-code/issues/100998) (github.com)
- [GitHub issue #107249（fast mode 在运行中的 CLI 会话里自动关闭）](https://github.com/anthropics/claude-code/issues/107249) (github.com)