claude-code - 💡(How to fix) Fix [Bug] Claude Code incorrectly billing against extra usage instead of plan quota [4 comments, 5 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#45203Fetched 2026-04-09 08:10:52
View on GitHub
Comments
4
Participants
5
Timeline
10
Reactions
0
Timeline (top)
cross-referenced ×5commented ×4labeled ×1

Error Message

Subject: Claude Code returning 'out of extra usage' error despite plan usage being under limit I'm experiencing a critical bug with Claude Code where I receive an API 400 error despite having significant plan usage remaining. Error message: API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"You're out of extra usage. Add more at claude.ai/settings/usage and keep going."}} The error says I'm out of extra usage, but my actual plan usage shows: I am well within my Max plan limits. The error occurs regardless of which model I select. Meanwhile, claude.ai in the browser works perfectly fine with the same account.

RAW_BUFFERClick to expand / collapse

Bug Description Subject: Claude Code returning 'out of extra usage' error despite plan usage being under limit

Hi Anthropic Support,

I'm experiencing a critical bug with Claude Code where I receive an API 400 error despite having significant plan usage remaining.

Environment:

  • Claude Code version: 2.1.29
  • Plan: Claude Max (5x)
  • Models tested: Opus 4.5, claude-sonnet-4-5-20250929

Error message: API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"You're out of extra usage. Add more at claude.ai/settings/usage and keep going."}}

The problem: The error says I'm out of extra usage, but my actual plan usage shows:

  • Current session: 2% used (resets 2am Asia/Seoul)
  • Current week (all models): 0% used (resets Apr 15)
  • Current week (Sonnet only): 0% used (resets Apr 15)

I am well within my Max plan limits. The error occurs regardless of which model I select. Meanwhile, claude.ai in the browser works perfectly fine with the same account.

Key observation: Claude Code appears to be drawing from the "extra usage" bucket instead of the standard plan usage bucket, even when the plan limit has not been reached. This forces users to either enable extra usage billing or be locked out of Claude Code entirely — despite having an active Max plan with usage remaining.

This seems like either a billing system bug or an undocumented policy that Claude Code bypasses plan limits entirely and requires extra usage credits. If this is intentional, it is not clearly communicated and feels deeply unfair to paying Max subscribers.

Request: Please investigate why Claude Code is triggering extra usage errors when plan usage is clearly under the limit, and clarify whether Claude Code is intentionally excluded from Max plan usage quotas.

Thank you.

extent analysis

TL;DR

Check the billing configuration to ensure Claude Code is correctly linked to the Max plan usage bucket, rather than relying on extra usage credits.

Guidance

  • Verify the account settings at claude.ai/settings/usage to confirm the Max plan details and usage limits.
  • Investigate the Claude Code configuration to determine if there's an option to specify the usage bucket (standard plan vs. extra usage).
  • Test Claude Code with a different model to see if the issue is model-specific or a global configuration problem.
  • Review the documentation for any mentions of Claude Code usage policies or limitations that may not be clearly communicated.

Example

No code snippet is provided as the issue seems to be related to configuration or billing settings rather than code-specific.

Notes

The issue may be related to a misconfiguration or a bug in the billing system, and further investigation is needed to determine the root cause. It's also possible that there's an undocumented policy or limitation that's causing the issue.

Recommendation

Apply a workaround by checking the billing configuration and ensuring that Claude Code is correctly linked to the Max plan usage bucket, as it's unclear if this is an intentional policy or a bug.

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