Troubleshooting
Common messages, and how to clear them.
- “Sign in to Claude Code to see limits.”
- You’re not signed into Claude Code with a Claude subscription. Open Claude Code and log in. (If you use an API key, Amazon Bedrock, or Google Vertex, the limits feature isn’t available — but the rest of Crustat still works.)
- “Token expired — open Claude Code to refresh.”
- Your Claude Code login has expired. Just open Claude Code; it refreshes the login automatically, and Crustat picks it up on the next refresh (or click Refresh in the gear menu).
- The menu-bar percentage is blank.
- The percentage is part of the rate-limits feature — it appears once you’re signed into Claude Code. Token-usage stats inside the popover work regardless.
- I clicked “Deny” on the keychain prompt by mistake.
- Open Keychain Access, search “Claude Code-credentials”, double-click it → Access Control tab, and either add Crustat to the allowed apps or choose “Allow all applications.” Then reopen Crustat.
- “Couldn’t load limits (…).”
- A temporary network or API issue. Crustat keeps showing your last-known limits and retries automatically.