claude-code - 💡(How to fix) Fix [Bug] Misleading "monthly usage limit" error message on Claude Max plan [2 comments, 2 participants]

Title: "monthly usage limit" error message is misleading on Claude Max plan On Claude Max 5x (OAuth subscription, no API key), I received this error during sub-agent execution: overage), but the error message gives no indication of which limit was hit. Context when the error occurred (best-effort reconstruction from local logs)

• 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

TL;DR

The error message "You've hit your org's monthly usage limit" is misleading and should be updated to indicate whether the 5-hour limit or extra-usage cap was reached.

Guidance

• Review the error message handling to provide more specific information about which limit was hit (5-hour limit or extra-usage cap).
• Consider adding logging to track when the 5-hour limit is approaching or has been reached to help with debugging.
• Evaluate the current extra-usage cap setting and consider adjusting it to a more reasonable value to avoid unexpected overages.
• Investigate the possibility of displaying a more informative error message that takes into account both the 5-hour limit and extra-usage cap.

Notes

The provided information suggests that the issue is related to the error message wording and the interaction between the 5-hour limit and extra-usage cap. However, without more context or details about the system's implementation, it's difficult to provide a more specific solution.

Recommendation

Apply workaround: Update the error message to provide more specific information about which limit was hit, and consider adjusting the extra-usage cap setting to avoid unexpected overages. This will help to mitigate the issue and provide a better user experience until a more permanent solution can be implemented.