Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeReleasesv2.1.304entry #138

Claude Code v2.1.304 ·

/usage now says how long its rate limit lasts

When the usage endpoint is rate limited, /usage now shows when you can try again instead of a generic 'try again in a moment'

Group of 2 You'll notice Improvements
JSON All of v2.1.304
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Usage & LimitsArea: what it touches
ImprovementsKind: in v2.1.304,
ImprovementsSection of the release

What

/usage shows your session cost, plan usage limits and activity stats. It gets this information from a usage endpoint, an address on Anthropic's servers. When that endpoint refuses because of too many requests (an HTTP 429 response), Claude Code now tells you when you can try again.

  • After a 429, Claude Code makes an extra lookup and adds a heldUntilMs value, the time the hold ends, to its 'unavailable' result. That result used to carry only status and rateLimitedVia. If the extra lookup fails, the error is ignored.
  • When heldUntilMs is known, the message is built from that time and says the endpoint is rate limited until then, using a new helper that formats the reset time.
  • When it is not known, you still see the old fixed text: 'Usage endpoint is rate limited. Please try again in a moment.'

Separately, the help text for --debug now gives the examples --debug=hooks,mcp and --debug='!hooks,!mcp' for filtering debug output by category.

Why

You get a concrete wait time instead of guessing how long to wait before running /usage again.

Read from
Names in the bundle/usage
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Added since A small documentation edit on Customize keyboard shortcuts touched a line naming /usage after this was published. | `settings:fixUsage` | F | Send your session the [`/usage` recommendations](/docs/en/costs#apply-recommendations-with-the-fix-shortcut) Claude Code can apply, when the `/usage` footer offers a fix. Requires v2.1.305 or later | keybindings see the edit
Confirmed since Anthropic's documentation has since written up /usage, on Manage costs effectively. On a Pro, Max, Team, or Enterprise plan, `/usage` also shows a breakdown of what counts against your plan limits, with recommendations: costs see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up /usage, on Manage costs effectively.
Anthropic's release notes agreeFixed claude --help text for --tools, --resume, --debug, --json-schema, --disable-slash-commands, --system-prompt-snapshot and claude update…

See this entry in the whole of v2.1.304 →

Feedback