Skip to content

code-fast-mode.md

Latest commit

 

History

History
158 lines (102 loc) · 8.59 KB

code-fast-mode.md

File metadata and controls

158 lines (102 loc) · 8.59 KB
title Speed up responses with fast mode
source https://code.claude.com/docs/en/fast-mode
category code
generated true

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt Use this file to discover all available pages before exploring further.

Speed up responses with fast mode

Get faster Opus responses in Claude Code by toggling fast mode.

Fast mode is in [research preview](#research-preview). The feature, pricing, and availability may change based on feedback.

Fast mode is a high-speed configuration for Claude Opus, making the model 2.5x faster at a higher cost per token. Toggle it on with /fast when you need speed for interactive work like rapid iteration or live debugging, and toggle it off when cost matters more than latency.

Fast mode is not a different model. It uses Claude Opus with a different API configuration that prioritizes speed over cost efficiency. You get identical quality and capabilities with faster responses. Fast mode is supported on Opus 4.7 and Opus 4.6. It is not available on Sonnet, Haiku, or other models.

Fast mode requires Claude Code v2.1.36 or later. Check your version with `claude --version`.

What to know:

  • Use /fast to toggle on fast mode in Claude Code CLI. Also available via /fast in Claude Code VS Code Extension.
  • Fast mode pricing is $30/$150 MTok on both Opus 4.7 and Opus 4.6.
  • Available to all Claude Code users on subscription plans (Pro/Max/Team/Enterprise) and Claude Console.
  • For Claude Code users on subscription plans (Pro/Max/Team/Enterprise), fast mode is available via usage credits only and not included in the subscription rate limits.

This page covers how to toggle fast mode, its cost tradeoff, when to use it, requirements, per-session opt-in, and rate limit behavior.

Toggle fast mode

Toggle fast mode in either of these ways:

  • Type /fast and press Tab to toggle on or off
  • Set "fastMode": true in your user settings file

By default, fast mode persists across sessions. Administrators can configure fast mode to reset each session. See require per-session opt-in for details.

For the best cost efficiency, enable fast mode at the start of a session rather than switching mid-conversation. See understand the cost tradeoff for details.

When you enable fast mode:

  • If you're on a different model, Claude Code automatically switches to Opus
  • You'll see a confirmation message: "Fast mode ON"
  • A small ↯ icon appears next to the prompt while fast mode is active
  • Run /fast again at any time to check whether fast mode is on or off

When you disable fast mode with /fast again, you remain on Opus. The model does not revert to your previous model. To switch to a different model, use /model.

Opus 4.7 is the fast mode default in Claude Code v2.1.142 and later. To pin fast mode to Opus 4.6 instead, set CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1.

Understand the cost tradeoff

Fast mode has higher per-token pricing than standard Opus:

Mode Input (MTok) Output (MTok)
Fast mode $30 $150

Fast mode pricing is flat across the full 1M token context window.

When you switch into fast mode mid-conversation, you pay the full fast mode uncached input token price for the entire conversation context. This costs more than if you had enabled fast mode from the start.

Decide when to use fast mode

Fast mode is best for interactive work where response latency matters more than cost:

  • Rapid iteration on code changes
  • Live debugging sessions
  • Time-sensitive work with tight deadlines

Standard mode is better for:

  • Long autonomous tasks where speed matters less
  • Batch processing or CI/CD pipelines
  • Cost-sensitive workloads

Fast mode vs effort level

Fast mode and effort level both affect response speed, but differently:

Setting Effect
Fast mode Same model quality, lower latency, higher cost
Lower effort level Less thinking time, faster responses, potentially lower quality on complex tasks

You can combine both: use fast mode with a lower effort level for maximum speed on straightforward tasks.

Requirements

Fast mode requires all of the following:

  • Not available on third-party cloud providers: fast mode is not available on Amazon Bedrock, Google Vertex AI, or Microsoft Azure Foundry. Fast mode is available through the Anthropic Console API and for Claude subscription plans using usage credits.
  • Usage credits turned on: your account must have usage credits turned on, which allows billing beyond your plan's included usage. For individual accounts, turn this on in your Console billing settings. For Team and Enterprise, an admin must turn on usage credits for the organization.
Fast mode usage draws directly from usage credits, even if you have remaining usage on your plan. This means fast mode tokens do not count against your plan's included usage and are charged at the fast mode rate from the first token.
  • Admin enablement for Team and Enterprise: fast mode is disabled by default for Team and Enterprise organizations. An admin must explicitly enable fast mode before users can access it.
If your admin has not enabled fast mode for your organization, the `/fast` command will show "Fast mode has been disabled by your organization."

Enable fast mode for your organization

Admins can enable fast mode in:

Another option to disable fast mode entirely is to set CLAUDE_CODE_DISABLE_FAST_MODE=1. See Environment variables.

Require per-session opt-in

By default, fast mode persists across sessions: if a user enables fast mode, it stays on in future sessions. Administrators on Team or Enterprise plans can prevent this by setting fastModePerSessionOptIn to true in managed settings or server-managed settings. This causes each session to start with fast mode off, requiring users to explicitly enable it with /fast.

{
  "fastModePerSessionOptIn": true
}

This is useful for controlling costs in organizations where users run multiple concurrent sessions. Users can still enable fast mode with /fast when they need speed, but it resets at the start of each new session. The user's fast mode preference is still saved, so removing this setting restores the default persistent behavior.

Handle rate limits

Fast mode has separate rate limits from standard Opus. Fast mode for Opus 4.7 and Opus 4.6 share the same rate limit pool: usage on either model draws from the same limits. When you hit the fast mode rate limit or run out of usage credits:

  1. Fast mode automatically falls back to standard speed
  2. The ↯ icon turns gray to indicate cooldown
  3. You continue working at standard speed and pricing
  4. When the cooldown expires, fast mode automatically re-enables

To disable fast mode manually instead of waiting for cooldown, run /fast again.

Research preview

Fast mode is a research preview feature. This means:

  • The feature may change based on feedback
  • Availability and pricing are subject to change
  • The underlying API configuration may evolve

Report issues or feedback through your usual Anthropic support channels.

See also