Claude/Codex Account Switcher

Switch between multiple Claude Code and Codex CLI accounts from your macOS menu bar.

Claude Switcher keeps separate account sessions for Claude Code and Codex CLI, shows live usage, and can automatically switch to another saved account when a provider reaches its limit.

Why use it?

AI coding CLIs are great until you need to jump between personal, work, team, or backup accounts. Without this app, switching usually means logging out, opening a browser, logging back in, and interrupting whatever you were doing in the terminal.

Claude Switcher stores account backups in macOS Keychain and swaps the active CLI session in one click. Claude and Codex are handled independently, so the active Claude account never changes your active Codex account.

Features

• Claude Code account switching - swap saved Claude Code sessions instantly
• Codex CLI account switching - save and restore Codex auth.json sessions
• Provider-separated state - same email can exist once for Claude and once for Codex
• Live usage in the menu bar - Claude 5-hour/7-day windows and Codex primary/secondary windows
• Optional auto-switch - per-provider failover when active usage reaches 100%
• First-launch import - imports the currently logged-in Claude and Codex accounts when available
• macOS Keychain backups - saved credentials are stored in Keychain, not plaintext config
• Standalone .app build - no Python install required for normal users

Install

Homebrew

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

Then launch Claude Switcher from Spotlight or /Applications.

GitHub release

1. Open the latest release
2. Download Claude-Switcher-vX.Y.Z.zip
3. Unzip it and drag Claude Switcher.app to /Applications
4. Launch it. The app appears as a menu bar icon.

On first launch, macOS may block the app because it is not signed. Open System Settings -> Privacy & Security and click Open Anyway.

Usage

Open the menu bar icon to:

• click any Claude or Codex account to make it active
• add a Claude account with claude auth login
• add a Codex account with a visible Terminal-based codex login flow
• refresh live usage manually
• enable or disable auto-switch separately for Claude and Codex
• remove saved inactive accounts from Keychain

After switching Claude, verify from any terminal:

claude auth status

After switching Codex, verify with:

codex login status

How it works

Claude Code stores OAuth credentials in macOS Keychain under Claude Code-credentials and account metadata in ~/.claude.json. Claude Switcher backs up each saved Claude account under claude-switcher:{email}, then restores the selected backup into Claude Code's active credential slot and updates ~/.claude.json.

Codex CLI stores ChatGPT authentication in ~/.codex/auth.json when cli_auth_credentials_store = "file" is used. Claude Switcher backs up each saved Codex session under codex-switcher:{email} and restores the selected session back to ~/.codex/auth.json with 0600 permissions.

Auto-switch is disabled by default. When enabled, usage refreshes in the background and the app switches only within the same provider. A full Claude account switches to another Claude account; a full Codex account switches to another Codex account.

Architecture