“API Error: Rate limit reached”

Claude Code — Claude Code error text. Anthropic's Hooks reference shows it as the example text for a rate-limit failure; this page also uses Anthropic's changelog and its Claude Code issue tracker.

The message

“API Error: Rate limit reached”

What it means

In Anthropic's Hooks reference this is the example error string for the rate_limit failure type, paired with the detail “429 Too Many Requests”. The docs give no separate explanation for it. Anthropic's changelog records two fixes where the wording appeared when it should not have: “Fixed misleading "Rate limit reached" message when the API returned an entitlement error” (2.1.89) and “Fixed "API Error: Rate limit reached" when selecting Opus” (2.1.78, VS Code). So the wording does not always mean you have used up your plan's limit.

What you can do

On this site: check your Claude Code usage · today's reset forecast · the banked reset · is it worth waiting?

Also searched as

People look this message up in many ways. These are search wordings, not Anthropic's text:

These are search wordings, not Anthropic's text. The exact string “API Error: Rate limit reached” appears in Anthropic's Hooks reference, its changelog and many reports on its Claude Code issue tracker.

Frequently asked questions

What does “API Error: Rate limit reached” mean in Claude Code?

Anthropic's Hooks reference shows “API Error: Rate limit reached” as the error string for a rate-limit failure, with the detail “429 Too Many Requests”. The docs do not explain it further. Anthropic's changelog says Claude Code once showed a misleading “Rate limit reached” message for an entitlement error and now shows the actual error instead.

Does a Claude API error rate limit reached message mean I have used my plan's limit?

Not necessarily. Anthropic's changelog lists fixes where this wording was shown for other problems, and users on the Claude Code issue tracker have reported it while their usage looked low (for example issue 29579, a Max plan at 16% usage). If you have really reached a plan limit, Claude Code's documented messages start “You've hit your ...” — see the related errors.

How do I fix API Error: Rate limit reached in Claude Code?

Anthropic has no single documented fix. A maintainer's comment on the issue tracker points to updating Claude Code, and to the hints the newer message shows, such as /extra-usage or /model to switch. If it still happens on the latest version, they ask for a report with your version and steps to reproduce.

Sources

Out of Claude usage? Third-party relays worth a look

Sponsored · synced from howtok.net

NovaAPISponsored

NovaAPI describes itself as a global AI token relay platform offering unified access to OpenAI, Claude, Gemini, and Chinese LLMs through low-latency, always-on routing. It advertises transparent pricing with API calls discounted up to 15% off list rates, plus a referral program with ongoing rewards.

  • WeChat Pay
  • Alipay
  • USDT
CheapRouterSponsored

CheapRouter is a pay-as-you-go, low-cost AI gateway with genuine models, offering full-strength GPT, Claude, and other model series, backed by an active model-authenticity verification mechanism and its own in-house AI coding software.

  • USDT
  • VISA
CodeKeySponsored

CodeKey describes itself as an AI API relay for developers, individuals, and teams, with access to Claude, GPT, DeepSeek, GLM, Kimi, Grok, and Gemini. It provides an English-language site, accepts WeChat Pay, Alipay, and USDT, and states that ¥1 paid gives $1 in platform credit. The operator also states that ordinary invoices are available from ¥200 without a fee and that refunds are available at any time without a fee.

  • Alipay
  • WeChat Pay
  • USDT

These are sponsored links, synced from howtok.net's pinned relay-station listings — third-party API resellers, not Anthropic. Claude Reset has no affiliation with them; use your own judgment.