claude-code - 💡(How to fix) Fix CLI requires extra-usage billing for fast Opus 4.6, but desktop app runs it on Max plan [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#55050Fetched 2026-05-01 05:47:32
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Participants
Timeline (top)
labeled ×4

The desktop Claude app lets a Claude Max subscriber pick Opus 4.6 Max Fast and use it on their included Max usage. The Claude Code terminal CLI on the same OAuth account refuses with a message that fast mode requires extra-usage (pay-per-token) billing to be enabled.

This is a parity gap between clients, not a billing or auth issue.

Root Cause

The desktop Claude app lets a Claude Max subscriber pick Opus 4.6 Max Fast and use it on their included Max usage. The Claude Code terminal CLI on the same OAuth account refuses with a message that fast mode requires extra-usage (pay-per-token) billing to be enabled.

This is a parity gap between clients, not a billing or auth issue.

RAW_BUFFERClick to expand / collapse

Summary

The desktop Claude app lets a Claude Max subscriber pick Opus 4.6 Max Fast and use it on their included Max usage. The Claude Code terminal CLI on the same OAuth account refuses with a message that fast mode requires extra-usage (pay-per-token) billing to be enabled.

This is a parity gap between clients, not a billing or auth issue.

Environment

  • CLI version: 2.1.123 (latest on npm at time of report)
  • Install method: Homebrew (/opt/homebrew/bin/claude)
  • Auth: OAuth (ANTHROPIC_API_KEY is unset, verified)
  • Plan: Claude Max — oauthAccount.organizationRateLimitTier: 'default_claude_max_20x'
  • Org: personal org, user is admin
  • Cached entitlement state in ~/.claude.json:
    • oauthAccount.hasExtraUsageEnabled: false
    • cachedExtraUsageDisabledReason: 'org_level_disabled'

Repro

  1. Subscribe to Claude Max.
  2. Open the Claude desktop app — pick Opus 4.6 Max Fast from the model list. It runs on included Max usage. ✅
  3. Open Claude Code in the terminal, authed via the same Claude.ai OAuth account.
  4. Run /model — only Opus 4.7, Sonnet, Haiku appear. No Opus 4.6 / fast option.
  5. Run /fast — message says fast mode requires extra-usage billing. ❌

Expected

The CLI should honor the same Max-tier fast Opus 4.6 entitlement that the desktop app honors for the same OAuth account. Either:

  • Surface "Opus 4.6 Max Fast" in /model for Max subscribers, or
  • Allow /fast to toggle on without extra-usage billing when the account is on a Max plan.

Actual

/fast is gated on hasExtraUsageEnabled regardless of Max-tier entitlement. Forces Max users to choose between (a) using desktop, (b) enabling pay-per-token billing they don't want, or (c) not using fast Opus 4.6.

Notes

  • Public docs at https://code.claude.com/docs/en/fast-mode currently say fast mode is "available via extra usage only and not included in the subscription rate limits" — but this contradicts the actual desktop-app behavior for Max subscribers, so the docs likely also need updating once the CLI catches up.

extent analysis

TL;DR

The CLI should be updated to honor the Max-tier fast Opus 4.6 entitlement without requiring extra-usage billing.

Guidance

  • Verify that the oauthAccount.organizationRateLimitTier is correctly set to 'default_claude_max_20x' in the CLI.
  • Check the ~/.claude.json file to ensure that the oauthAccount.hasExtraUsageEnabled flag is not being used to gate the fast mode feature for Max subscribers.
  • Update the CLI to surface "Opus 4.6 Max Fast" in the /model list for Max subscribers, or allow /fast to toggle on without extra-usage billing when the account is on a Max plan.
  • Review the public docs at https://code.claude.com/docs/en/fast-mode to ensure they accurately reflect the entitlements for Max subscribers.

Example

No code snippet is provided as the issue is related to the CLI's behavior and entitlements, rather than a specific code implementation.

Notes

The current behavior of the CLI contradicts the desktop app's behavior for Max subscribers, and the public docs may also need updating to reflect the correct entitlements.

Recommendation

Apply a workaround by updating the CLI to honor the Max-tier fast Opus 4.6 entitlement without requiring extra-usage billing, as this will provide parity with the desktop app's behavior.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix CLI requires extra-usage billing for fast Opus 4.6, but desktop app runs it on Max plan [1 participants]