[BUG] "Approaching usage limit" banner fires when user is not approaching any limit
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report
- [x] I am using the latest version of Claude Code
What's Wrong?
The persistent "Approaching usage limit" banner is appearing in Claude Code Desktop during sessions where the user is not, in fact, approaching any meaningful limit.
At the time the banner appeared:
- Current session: 15% used
- Weekly all-models: 75% used (resets in ~2 days)
- Sonnet-only weekly: 40% used
- Claude Design weekly: 0% used
The warning is a false positive. There is no cap the user is about to hit in this session or the next several. The banner also offers an "Upgrade" CTA, which is meaningless for accounts already on the top-tier Max (20x) plan — there is nowhere to upgrade to.
What Should Happen?
- The banner should only fire when the user is actually close to a limit they will hit in the current or next session.
- The banner text should specify which limit is being approached (weekly all-models, Sonnet-only, session, or Claude Design) rather than using generic wording that could refer to any of four different counters.
- For accounts on Max (20x), the CTA should not say "Upgrade." A tier-aware CTA would be "Enable extra usage" (pay-as-you-go) or "View usage details."
Error Messages/Logs
Approaching usage limit
(No error in logs — this is a UI banner, not an API error.)
Steps to Reproduce
- Use Claude Code Desktop on a Max (20x) plan.
- Reach a state where weekly all-models is ~75%, but session is ~15% and the reset is still days away.
- Observe the persistent "Approaching usage limit" banner above the input, with an "Upgrade" link.
Screenshots attached in comment:
banner-in-app.png— the banner as it appears above the input areausage-limits-panel.png— the Plan usage limits panel showing all four counters
Claude Model
Sonnet (default) — Sonnet 4.6 – High
Is this a regression?
I don't know
Last Working Version
N/A
Claude Code Version
1.3561.0 — Claude Code Desktop app
Platform
Anthropic API
Operating System
macOS (26.4.1)
Terminal/Shell
N/A — this is the Claude Code Desktop app, not the CLI
Additional Information
Related issues:
- #50908 — "API Error / Usage exhausted when I just started and have plenty of usage left"
- #41084 — Max 20x phantom usage: daily vs. weekly counters contradict each other
- #43046 — Usage stats show wrong percentage after weekly reset
- #49616 — Weekly usage limit reset 4+ hours before scheduled time
- #41930 — Widespread abnormal usage-limit drain across paid tiers since March 23, 2026
Suggested fix:
- Raise the trigger threshold so the banner fires only when the user is realistically about to hit a cap during their current or next session.
- Specify the limit in the banner text — e.g. "Approaching weekly all-models limit (75%)" — rather than generic language that could reference any of four different counters.
- Tier-aware CTA — replace "Upgrade" with "Enable extra usage" or "View usage details" for accounts already on Max (20x).
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗