claude-swap

Multi-account switcher for Claude Code. Easily switch between multiple Claude accounts without logging out.

Installation

Using uv (recommended)

uv tool install claude-swap

Using pipx

pipx install claude-swap

From source

git clone https://github.com/realiti4/claude-swap.git
cd claude-swap
uv sync
uv run cswap --help

Usage

Add your first account

Log into Claude Code with your first account, then:

cswap --add-account

Add more accounts

Log out of Claude Code, log in with another account, then:

cswap --add-account

Refresh expired tokens

If an account's token expires, log back into Claude Code with that account and re-run:

cswap --add-account

This will update the stored credentials without creating a duplicate.

Switch accounts

Rotate to the next account:

cswap --switch

Or switch to a specific account:

cswap --switch-to 2
cswap --switch-to [email protected]

Note: Restart Claude Code after switching for the new account to take effect.

Other commands

cswap --list              # List all accounts with usage stats
cswap --status            # Show current account
cswap --remove-account 2  # Remove an account
cswap --purge             # Remove all claude-swap data

How it works

Backs up OAuth tokens and config when you add an account
Swaps credentials when you switch accounts
Account credentials stored securely using platform-appropriate methods

Data locations

Platform	Credentials	Config backups
Windows	Windows Credential Manager	`~/.claude-swap-backup/`
macOS	macOS Keychain	`~/.claude-swap-backup/`
Linux	File-based (`~/.claude-swap-backup/credentials/`)	`~/.claude-swap-backup/`

Uninstall

Remove all data:

cswap --purge

Then uninstall the tool:

uv tool uninstall claude-swap
# or
pipx uninstall claude-swap

Requirements

Python 3.12+
Claude Code installed and logged in

License

MIT