[Bug] Misleading "monthly usage limit" error message on Claude Max plan

Resolved 💬 3 comments Opened May 4, 2026 by stoikheia Closed May 4, 2026

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.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗