[FEATURE] Align weekly usage limit reset with billing cycle renewal

Resolved 💬 3 comments Opened Apr 2, 2026 by ojhurst Closed Jun 13, 2026

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:

  1. A full reset of the weekly bucket on payment processing
  2. A partial replenishment (e.g., restore to 50%) so heavy users still get relief
  3. 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

  1. Subscriber uses Claude Code heavily Monday through Thursday
  2. Friday morning, monthly billing processes successfully
  3. Subscriber opens Claude Code on Friday, ready to start fresh
  4. Usage meter shows 96% weekly — still throttled from Monday-Thursday activity
  5. 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

View original on GitHub ↗

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