Common Issues

Solutions for frequently encountered problems with My Claude.

Dashboard Shows No Data

Symptoms: The dashboard loads but shows 0% for both usage windows, or displays empty charts.

Causes and solutions:

1. OAuth token not detected - My Claude needs your Claude Code OAuth token to fetch usage data. Go to Settings > General and verify the token is present. On macOS, the token is read from the system Keychain. See Configuration for manual token retrieval.
2. Claude Code not authenticated - If you have not logged into Claude Code yet, there is no token to read. Run claude in your terminal and complete the authentication flow first.
3. Network issues - My Claude fetches usage data from the Anthropic API. Check your internet connection and ensure api.anthropic.com is reachable.

OAuth Token Not Found

Symptoms: My Claude reports it cannot find your Claude Code credentials.

Solutions:

• macOS: The token is stored in the macOS Keychain under "Claude Code-credentials". Open Keychain Access and search for this entry. If it does not exist, re-authenticate Claude Code by running claude in your terminal.
• Windows/Linux: Check that Claude Code is installed and you have logged in at least once.

Notifications Not Working

Desktop Notifications

• macOS: Check System Settings > Notifications > My Claude and ensure notifications are allowed. If My Claude does not appear in the list, try relaunching the app.
• Windows/Linux: Ensure your system's notification daemon is running.

WhatsApp / Telegram

• Verify the connection is active in Settings > Notifications
• Try sending a test notification from the settings page
• Re-link your account if the connection has expired

App Not Launching

macOS

• If macOS blocks the app, go to System Settings > Privacy & Security and click Open Anyway
• Try removing the quarantine attribute: xattr -cr /Applications/My\ Claude.app

Windows

• Run the installer as Administrator if installation fails
• Check Windows Defender is not blocking the app

Linux

• For .deb: check for missing dependencies with sudo apt --fix-broken install

High Memory Usage

My Claude stores usage history in a local SQLite database. Under normal usage, this database stays small. If you notice high memory usage:

• Check the database size at .data/claude-stats.db in the My Claude data directory
• Restart the application to clear any accumulated in-memory data

Rate Limit Data Seems Stale

If your usage percentages are not updating:

1. Click the refresh button in the sidebar to force a data fetch
2. Check that your OAuth token has not expired (re-authenticate Claude Code if needed)
3. Verify your internet connection

System Tray Icon Not Appearing

• macOS: The tray icon appears in the menu bar. If your menu bar is crowded, it may be hidden - try using a tool like Bartender or expanding the menu bar area.
• Windows: Check the system tray overflow area (click the up arrow in the taskbar).
• Linux: Tray support depends on your desktop environment. GNOME users may need the AppIndicator extension.

Still Having Issues?

If your issue is not listed here:

1. Check the GitHub Issues for known problems
2. Open a new issue with details about your OS, My Claude version, and steps to reproduce