Configuration
After installing My Claude, you need to connect it to your Claude Code data. This page walks you through the initial setup process.
Automatic Setup
When you launch My Claude for the first time, the onboarding wizard guides you through the setup process:
- OAuth Token Detection - My Claude attempts to read your Claude Code OAuth token automatically
- Data Directory - My Claude locates your Claude Code sessions and configuration
- Dashboard - Once connected, you are taken to the main dashboard
In most cases, no manual configuration is needed.
OAuth Token
My Claude uses your Claude Code OAuth token to fetch usage data from the Anthropic API. This token is the same one Claude Code uses for authentication.
macOS
On macOS, Claude Code stores the OAuth token in the system Keychain. My Claude reads it automatically from:
Keychain item: "Claude Code-credentials"
If automatic detection fails, you can retrieve the token manually:
security find-generic-password -s "Claude Code-credentials" -w
Copy the output and paste it into My Claude's settings under Settings > General.
Windows & Linux
On Windows and Linux, Claude Code stores credentials in a local file. My Claude detects these automatically. If detection fails, check that Claude Code is installed and authenticated by running:
claude --version
Claude Code Data
My Claude reads session data and configuration from standard Claude Code locations:
- Sessions: Stored by Claude Code in your home directory
- Configuration:
~/.claude/settings.jsonand related files - Projects: My Claude discovers projects from your session history
No data is copied or duplicated. My Claude reads directly from these locations.
Verifying the Connection
Once configured, you can verify everything is working:
- Open My Claude and navigate to the Dashboard
- You should see your current usage stats (5-hour and 7-day windows)
- If stats appear, your OAuth token is correctly configured
If the dashboard shows empty data, see Troubleshooting for help.
Next Steps
- Usage Monitoring - Learn about the dashboard
- Rate Limit Alerts - Set up notifications for rate limit thresholds
- Settings - Explore all configuration options