[Bug] Misleading "monthly usage limit" error message on Claude Max plan
Bug Description
Title: "monthly usage limit" error message is misleading on Claude Max plan
Summary
On Claude Max 5x (OAuth subscription, no API key), I received this error during sub-agent execution:
> You've hit your org's monthly usage limit
This wording is misleading. Most likely the underlying condition was a combination of (5-hour limit reached) + (extra-usage cap of $0 with prior
overage), but the error message gives no indication of which limit was hit.
Context when the error occurred (best-effort reconstruction from local logs)
- Plan: Claude Max 5x (organizationType: claude_max, organizationRateLimitTier: default_claude_max_5x). Personal subscription, treated as a
1-person "organization" internally.
- Sub-agent in progress for a parallel batch task.
- Statusline log (recorded every 30 min) showed 5h usage at 82% at 09:03 JST. Error was raised somewhere in the 09:30–10:00 JST window. Given
multiple sub-agents were running in parallel, the 5h quota almost certainly hit 100% during that window.
- Extra-usage monthly cap had been intentionally lowered to $0, with $0.35 already accrued — so the account was simultaneously in an "extra-usage
overage" state.
So the most likely sequence: …
Note: Content was truncated.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗