How subscription quota is calculated and reset
Monthly subscriptions include a usage allowance. Both 5-hour and weekly limits apply. Usage is metered in weighted request units and depends on the token volume of each request.
How is the subscription allowance metered — what exactly is the unit?
In WEIGHTED REQUEST UNITS, not raw request counts: one request costs (input tokens + output tokens + 10% of cached-read tokens) divided by 29,000, rounded up, with a minimum of 1 and a cap of 50 units. A request that includes images costs at least 5 units, counting only the images newly uploaded in that request — images re-sent from earlier turns are not charged again. Cache reads count at 10%, writing to the cache is free, and a failed request costs 0. Units depend only on token volume, not on which model you call. Actual usage and reset times are shown in the Console; internal web searches add no extra allowance charge.
What you actually spend depends on the token volume of each request:
- A short chat turn, code completion or small edit is usually 1 unit.
- Requests with images start at 5 units; a long-context agent or coding session is typically 10–50 units, with 50 as the per-request cap.
5-hour and 7-day windows
Paid subscriptions use separate fixed 5-hour and 7-day windows, timed from each window’s start. Usage for a window resets when it expires, and the next call opens a new window. Check the Console or usage API for your reset times. If either window has insufficient quota, further calls can receive a 429 rate-limit response. Failed requests consume no quota, and subscription overage charges are not added automatically.
Compare workflows on the plans page. To see usage live in Claude Code: Usage in Claude Code.
What a 429 means
- concurrency_limit: concurrency over your plan cap — slow down, reduce parallel calls, or compare higher-tier plans.
- window/quota: 5h or weekly window usage exhausted — wait for reset or upgrade.
- upstream_busy: transient upstream load — usually clears shortly.
Check your base URL & generate settings · Choose your client guide · Create an account