[FEATURE] Align weekly usage limit reset with billing cycle renewal
Preflight:
- [x] I searched existing issues and didn't find a duplicate
- [x] This is a single feature request
Problem Statement
When a Max subscriber's monthly payment processes, the 7-day rolling usage window continues on its own independent clock. This means you can pay for a new month of service and still be sitting at 96% of your weekly limit with hours left until it naturally rolls off.
The moment you are most excited to use the product (fresh billing month, payment just went through) is the exact moment you are most likely to be throttled from last week's usage. The billing event and the usage event feel like they should be connected, but they are not.
Proposed Solution
On billing cycle renewal, reset or significantly replenish the weekly usage bucket. Similar to how a cell phone data plan resets on the billing date rather than operating on a rolling 7-day window independent of when you pay.
This could be:
- A full reset of the weekly bucket on payment processing
- A partial replenishment (e.g., restore to 50%) so heavy users still get relief
- At minimum, a one-time bonus allocation on renewal day
Alternative Solutions
Currently the only option is to wait for the rolling window to naturally decay. There is no workaround — you just sit and watch the progress bar while knowing your payment just went through.
Priority
Medium
Feature Category
API integration
Use Case Example
- Subscriber uses Claude Code heavily Monday through Thursday
- Friday morning, monthly billing processes successfully
- Subscriber opens Claude Code on Friday, ready to start fresh
- Usage meter shows 96% weekly — still throttled from Monday-Thursday activity
- Has to wait 4 more hours for the rolling window to clear, despite just paying
Additional Context
Screenshot of the usage panel showing 96% weekly usage with "Resets in 4h" alongside a fresh billing cycle:
The cell phone data analogy resonates because every consumer subscription service resets usage on the billing date. The current behavior feels like paying your phone bill and being told "your data cap from last week is still in effect for a few more hours."
Environment
- Claude Code Version: 2.1.89
- Platform: Claude Max
- Operating System: macOS 15.4.1
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗