Claude Account Switcher: Hot-Swap Accounts in One Click to Bypass Rate Limits

What It Does — Instant Account Switching with Live Usage Data

Claude Account Switcher is a lightweight macOS menu bar application that solves a specific but painful problem for developers using multiple Claude Code accounts. If you have separate subscriptions for personal projects, work, or client work, switching between them normally requires running claude auth logout followed by claude auth login—opening a browser, logging in, and waiting. This friction becomes critical when you hit rate limits on one account and need to continue working immediately on another.

The app provides:

• One-click account switching — no logout/login, no browser windows
• Live usage display — shows 5-hour and 7-day utilization for each account directly in the menu bar
• Secure credential storage — credentials stored exclusively in macOS Keychain, never on disk
• Auto-import — detects your current Claude Code account on first launch
• Full session switching — swaps both OAuth tokens and Claude CLI state so claude auth status always reflects the active account

How It Works — Under the Hood with macOS Keychain

Claude Code stores authentication in two places:

1. macOS Keychain — OAuth tokens (access + refresh) under the service Claude Code-credentials
2. ~/.claude.json — account metadata (email, org, subscription type) in the oauthAccount field

When you add an account, the app:

• Backs up current credentials to a separate Keychain entry (claude-switcher:{email})
• Saves the oauthAccount metadata from ~/.claude.json into its config
• Runs claude auth logout + claude auth login for the new account
• Imports the new account's credentials and metadata

When you switch accounts, the app:

• Saves the current account's Keychain credentials and oauthAccount state
• Restores the target account's OAuth token into Claude Code-credentials
• Restores the target account's oauthAccount into ~/.claude.json
• All Claude Code sessions immediately use the new account

Usage data is fetched via Anthropic's OAuth API using each account's stored token.

Setup — Install and Configure in Minutes

Install via Homebrew:

brew install --cask Symbioose/tap/claude-switcher

Then launch it from Spotlight or /Applications/Claude Switcher.app.

On first launch, the app automatically imports your current Claude Code account. To add additional accounts:

1. Click the menu bar icon
2. Select "Add Account"
3. Follow the authentication flow (this happens once per account)
4. The app handles backing up credentials and metadata

Your accounts are now available in the dropdown menu with their current usage statistics displayed.

When To Use It — Specific Workflows That Benefit

Rate Limit Management: When you hit your 5-hour or 7-day limits on your primary account, switch to a secondary account with one click instead of waiting hours or days.

Context Separation: Keep work and personal projects completely separate—different accounts mean different conversation histories, file access patterns, and billing.

Team Development: If your team shares a Claude Code subscription but you need individual usage tracking, this lets you maintain separate accounts while easily switching between them.

Testing Different Plans: If you're evaluating Claude Code Pro vs. Team vs. Enterprise features, maintain separate accounts for each and switch between them to compare behavior.

The app is particularly valuable for developers who:

• Regularly exceed Claude Code's rate limits
• Bill clients separately for AI-assisted development
• Maintain strict separation between work and personal coding
• Participate in beta programs with separate test accounts