claude-swap 0.7.1

Multi-account switcher for Claude Code

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 [e-mail]

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