Toolbar shows false '100% extra usage' alert on session start
Resolved 💬 2 comments Opened Apr 12, 2026 by thisisfatih Closed May 23, 2026
Bug description
On session start, the toolbar briefly shows a false alert:
You've used 100% of your extra usage · resets [date]
The alert is inaccurate — web dashboard shows correct (non-100%) usage. It disappears after the first real user message.
Root cause (from binary analysis)
Claude Code v2.1.104 runs a startup quota probe during "Starting background startup prefetches":
mG9()callsTY1()— a real API call with{role:"user", content:"quota", max_tokens:1, source:"quota_check"}- Response headers contain
anthropic-ratelimit-unified-overage-utilization = 1.0 FU6(headers)processes these → setsok.utilization = 1.0,ok.rateLimitType = "overage"- Toolbar renders the 100% alert immediately
- First real user message → fresh API call → headers reflect actual state → alert clears
The probe appears to return stale/cached rate limit headers that don't match the actual usage state returned by subsequent real API calls.
Steps to reproduce
- Use Claude Code until extra usage is near or at 100%
- Close the session
- Top up or wait for state to normalize (web shows non-100%)
- Open a new Claude Code session
- Toolbar shows 100% alert immediately
- Send any message → alert disappears
Expected behavior
Toolbar should either:
- Not show the alert until a real message confirms the rate limit state, or
- Show a "checking..." state while the startup probe is in-flight
Environment
- Claude Code: 2.1.104
- OS: macOS Darwin 25.3.0 arm64
Suggested fix
Debounce or suppress the overage alert until at least one real user message confirms the high utilization state. The startup probe result alone should not trigger the display.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗