claude-code - 💡(How to fix) Fix [DOCS] Clarify whether extra usage applies to the weekly limit [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#52276Fetched 2026-04-24 06:11:27
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
1
Author
Participants
Timeline (top)
labeled ×3
RAW_BUFFERClick to expand / collapse

Problem

The extra usage documentation explains that extra usage lets you continue working after hitting your "included usage limit" at standard API rates. However, it only mentions the session limit (5-hour rolling window) — it never mentions the weekly limit.

This leaves a gap: does extra usage kick in when you hit the weekly limit, or only when you hit the session limit?

Why it matters

Users planning their work and budgets need to know whether hitting the weekly cap means a hard stop until reset, or whether extra usage will let them keep going (at API rates). The answer significantly affects which plan tier to choose and whether to enable extra usage.

Suggested fix

Add a sentence to the extra usage article explicitly stating which limits extra usage applies to — session only, weekly only, or both.

extent analysis

TL;DR

Update the extra usage documentation to clarify which limits trigger extra usage, specifically addressing the weekly limit.

Guidance

  • Review the current documentation for any implicit hints about the weekly limit and extra usage.
  • Consider adding a clear statement to the documentation, such as "Extra usage applies to both session and weekly limits" or "Extra usage only applies to the session limit, not the weekly limit".
  • Verify the intended behavior with the development team or relevant stakeholders to ensure accuracy.
  • Test the updated documentation with user scenarios to ensure it addresses the confusion.

Example

No code snippet is applicable in this case, as the issue is related to documentation clarity.

Notes

The solution relies on understanding the intended behavior of extra usage in relation to the weekly limit, which may require input from the development team or product owners.

Recommendation

Apply workaround: Update the documentation to explicitly state which limits extra usage applies to, as this will provide clarity for users planning their work and budgets.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] Clarify whether extra usage applies to the weekly limit [1 participants]