Skip to content

j7-dev/claude-swap

 
 

Repository files navigation

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 user@example.com

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

About

Switch between multiple Claude Code accounts

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%