API Error 429 (rate_limit_error)
The API rejected the request for exceeding a rate or usage limit.
690 issues · 23 open · 667 resolved (97%) · first seen Mar 28, 2025
First response · account
What to do now
Most likely: The account, organization or endpoint exceeded a rate or usage window.
- Stop parallel retries and wait for the response’s retry window.
- Check current usage, plan limits and whether another process shares the same credentials.
- Use bounded exponential backoff; changing prompts does not reset a rate limit.
These are conservative triage steps, not an official Anthropic fix. Use the issue and workaround evidence below before making a destructive configuration change.
Is this getting better or worse?
This class of problem is converging. 166 new reports in the last 90 days vs 329 in the 90 before — -50%. The open backlog peaked at 125 in 2026-04 and sits at 23 today.
Derived by counting each matching issue from its creation date until it closed. First-party
computation over the anthropics/claude-code tracker — the trend is not published
anywhere upstream.
Which builds report this
554 of these reports name the Claude Code build they were running, spanning 100 releases. Heaviest reporters:
- Claude Code v2.1.114
- Claude Code v2.1.119
- Claude Code v2.1.123
- Claude Code v2.1.87
- Claude Code v2.1.92
- Claude Code v2.1.104
- Claude Code v2.1.112
- Claude Code v2.1.117
Report volume, not a defect count: an issue can mention a build without that build having caused the failure. Versions come from the version string in the bug-report template, matched against real published tags.
Do these get fixed?
Median time to close is 20 days across 667 closures. Of the 667 closures with a recorded reason, 9% were closed as completed and 609 as not-planned or duplicate. The most recent completed fix landed in 2026-08.
Workarounds reported by the community
21 of these issues post a workaround someone says worked. The highest-engagement ones:
- You've hit your limit · While usage is still at 84%
- …got "While our Support team is unable to manually reset or work around usage limits, you can learn about best practices [here]( If you’ve hit a message limit, you’ll need to wait until the reset time, or you can conside…
Found in the thread of #19673 · still open - [BUG] /api/oauth/usage endpoint returns persistent 429 for Claude Max users (retry-after: 0)
- Root Cause Found + Workaround After investigating, we discovered that rate limits are per-access-token, not per-account . Each new OAuth access token gets a fresh rate limit window (~5 requests before 429). How to bypass…
Found in the thread of #30930 · still open - [Bug] Anthropic API Error: Usage credits required for 1M context window with opus-plan model
- …sn't work, and just stops working at 1M Context. A feasible workaround would be to periodically use the /compact command manually.
Found in the thread of #61869 · resolved - [BUG] Skill `model:` frontmatter triggers 429 "Extra usage required" on 2.1.76 when session uses opus[1m]
- …Sonnet promoted to . Rejected if account lacks entitlement. Workarounds - Stay on 2.1.75 — skill model switching works correctly without auto-promotion. Caveat: if a sonnet skill (200K) is invoked from an opus[1m] sessio…
Found in the description of #34296 · still open - [BUG] Rate limit 429 errors despite dashboard showing available quota - Two Max accounts, documented inconsistencies
- ….3% , meaning ~20x token inflation per turn. After applying workarounds it stabilized at 89-99% . Full analysis with per-request measured data, safe workarounds, and community references (including [cc-cache-fix](
Found in the thread of #22876 · still open
Excerpts are quoted from the linked issue so you can judge relevance before opening it. Threads that only ask for a workaround, or report that there is none, are excluded. These are community suggestions, not official guidance from Anthropic — read the full thread before applying one.
Matching issues 1–100
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 690 matches; the statistics above cover all 690.
- You've hit your limit · While usage is still at 84%
- [Bug] Anthropic API Error: Image processing failures causing conversation token waste
- [BUG] /api/oauth/usage endpoint returns persistent 429 for Claude Max users (retry-after: 0)
- [Bug] Anthropic API Error: Usage credits required for 1M context window with opus-plan model
- [BUG] Skill `model:` frontmatter triggers 429 "Extra usage required" on 2.1.76 when session uses opus[1m]
- [BUG] Rate limit 429 errors despite dashboard showing available quota - Two Max accounts, documented inconsistencies
- [Bug] Rate Limit Error persists after increasing plan limits and adding funds and Max plan only at 33% used
- [BUG] /api/oauth/usage endpoint aggressively rate limits, making usage monitoring unusable
- [Bug] Rate limit triggered before reaching session usage limit (71%)
- [BUG] /usage command fails with rate_limit_error when checking usage data
- OAuth usage API (/api/oauth/usage) returns persistent 429 rate limit
- You've hit your org's monthly usage limit
- [Bug] Rate limit error despite low API usage when using Opus 4.6 (1m)
- 5-hour usage limit hits 100% instantly despite low context usage (11%)
- [BUG] 5-Hour Rate Limit Exhaustion Accelerating Despite Comparable Workload
- Session limit reached ∙ resets 3:30pm
- /logout /login missing
- Persistent HTTP 429 on auto-mode classifier (xml_s1), account-side config
- [BUG] Exponential backoff is broken
- [Bug] Ultrareview quota consumed on server-side rate limit failures
- You've hit your limit · resets 8pm (Europe/Berlin)
- [Bug] Unexpectedly High API Usage and Rate Limit Hits
- [BUG] MAX100 subscription - abnormal quota consumption and rate_limit_error with multi-session Claude Code
- Claude Code usage discrepancy - shows 100% while web shows 71%
- Bug Report - Extreme usage limit drain on Max Plan with Claude Code (one prompt consumes huge amounts)
- [Bug] Rate limit errors with unexplained session quota consumption
- 5-hour limit reached in less than 10 messages
- Claude AI terminal scroll issue | 1754510400
- [Bug] Rate limit exceeded despite low session usage percentage
- You've hit your limit · resets 1:40pm (America/New_York)
- [Bug] 1M context window incorrectly shown as extra billable usage on Max plan
- [Bug] Anthropic API Error: Rate limit reached on claude-sonnet-4-6-1m with Claude Pro plan
- You've hit your limit · resets 7pm (Europe/Berlin)
- [Bug] Anthropic API Error: Rate limit reached despite low session/weekly usage; missing per-minute limit documentation
- [BUG]
- Sonnet 4.6 routes every request to long-context tier on Claude Desktop 2.1.149 (429 'Usage credits required')
- OAuth expiration causes retry storm consuming 100% session usage (3.75M wasted tokens)
- Claude AI usage limit reached|1760000400
- You've hit your limit · resets 2pm (America/Chicago)
- You've hit your limit · resets 6pm (Europe/Lisbon)
- [Bug] Anthropic API Error: Rate limit exceeded with low usage quota
- Claude AI usage limit reached|1753088400
- [BUG] 20x Plan managed to burn the ENTIRE 5h window in ~30 minutes without any heavy use
- [BUG] Max Plan User Getting "Extra usage is required for long context requests" Error
- You've hit your limit · resets 10pm (Europe/Istanbul)
- You've hit your limit · resets 4pm (Asia/Tashkent)
- [Bug] Anthropic API Error: Rate limit reached despite available quota on Max plan
- Usage Quota Not Resetting at Scheduled Time for Max Customer
- Claude Code v2 not showing the entreprise proxy url in the header
- SUB AGENT GIMMICK Agent Execution Stalls: Sub-Agent Delegation Causing Performance Degradation
- Bug Report
- [BUG] Max plan: 'Usage credits required for long context requests' on standard 400k context
- You've hit your limit
- 5-hour limit reached ∙ resets 8pm
- session usage jumped 30% per prompt in less then 1 minute of entering the prompt
- I'm unable to generate a GitHub issue title from this message because it doesn't describe a specific bug or feature request for Claude Code. The message appears to be expressing concerns about API access levels and model autonomy rather than reporting a t
- You've hit your limit · resets 9:10pm (Europe/Kiev)
- [Bug] Authentication fails with --bare flag despite successful login
- [Bug] Conversation compactor fails to reduce token usage for extended context
- [Bug] Usage limits silently reduced without notification
- You've hit your limit · resets 4pm (Europe/Berlin)
- [Bug] Context window limit reached consistently at ~84% of session usage
- You've hit your limit · resets 2am (Europe/Berlin)
- You've hit your limit · resets 6pm (Asia/Bangkok)
- [BUG] v2.1.19: Unable to consume "Extra Usage" credits despite active balance | Unknown skill: rate-limit-options
- Tool Use Block Missing Corresponding Tool Result Block API Error: 400
- Missing Tool Result Block for Tool Use ID
- Saying I hit my limit when I haven't (just upgraded plan)
- You've hit your limit · resets 5pm (Europe/Brussels)
- You've hit your limit · resets 1am (Europe/London)
- You've hit your limit · resets 6am (Asia/Tokyo)
- You've hit your limit · resets 8pm (Asia/Tbilisi) - Claude Max
- You've hit your limit · resets 12pm (America/Sao_Paulo)
- [Bug] Test bypassing and incorrect working directory handling during execution
- [Bug] Rate limit error shown despite available quota on alternative models. Can't switch to haiku model in the CLI.
- If I reach the limit can't send bugreport
- Bug Report: Incomplete Task Implementation with Misleading Status Update
- Claude AI usage limit reached|1750460400
- You're out of extra usage · resets 7pm (Europe/Barcelona)
- [Bug] Model exhibits inconsistent reasoning, instruction non-compliance, and context degradation in extended sessions
- [Bug] Unexpected high token consumption with multi-agent Opus orchestrator spawning Sonnet agents
- [Bug] Auto-compact threshold change in 2.1.117 causes 5x token usage increase without notification
- You've hit your limit · resets 1pm (Europe/London)
- You've hit your limit · resets 8pm (Asia/Seoul)
- [Bug] Anthropic API Error: 429 Rate Limit with Multiple Parallel Sessions Below Usage Cap
- [Bug] Anthropic API Error: Rate limit reached without usage
- You've hit your limit · resets 1am (America/Chicago)
- You've hit your limit · resets Feb 11, 7pm (America/New_York)
- [BUG] You've hit your limit · resets 9:30pm (Asia/Calcutta)
- Faster rate-limit 2.0.x
- [Bug] Token usage display shows incorrect weekly allowance consumption rate
- [DOC] Claude Code making excessive tool calls in a loop
- Anthropic API Rate Limit Error Incorrectly Blocking Usage
- 5-hour limit reached ∙ resets 12pm
- [Bug] HTTP 529 overloaded_error is rendered as "Rate limited" and hard-fails parallel sessions/subagents (no backoff, not logged to errors)
- You've hit your limit · resets 2:10pm (Europe/Moscow)
- [Bug] Agent suggests destructive commands without safety warnings
- You're out of extra usage · resets 9:50pm (America/Sao_Paulo)
- You've hit your limit · resets 11:20pm (Europe/Paris) : session reaching 100% instantly
- Há mais de uma semana e a qualquer horário do dia que...