[BUG] "Approaching usage limit" banner fires when user is not approaching any limit

Resolved 💬 3 comments Opened Apr 21, 2026 by ferentchak Closed May 28, 2026

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

  1. Use Claude Code Desktop on a Max (20x) plan.
  2. Reach a state where weekly all-models is ~75%, but session is ~15% and the reset is still days away.
  3. 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 area
  • usage-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:

  1. 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.
  2. 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.
  3. Tier-aware CTA — replace "Upgrade" with "Enable extra usage" or "View usage details" for accounts already on Max (20x).

View original on GitHub ↗

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