ccswitch

Switch between multiple Claude Code accounts instantly — no logging in and out.

---

Why

Claude Code only holds one account at a time. Switching meant logging out, waiting for the browser flow, and losing your session. With multiple accounts — work, personal, multiple team seats — this gets painful fast.

ccswitch snapshots each account's credentials to the system keychain, then swaps them in one command. Claude Code just sees a clean account on restart.

It also handles the claude setup-token (long-lived token) path, where CLAUDE_CODE_OAUTH_TOKEN silently overrides the credentials file and makes plain credential-swapping invisible.

---

Install

macOS (Homebrew):

brew tap vyshnavsdeepak/ccswitch https://github.com/vyshnavsdeepak/ccswitch
brew install ccswitch

Cargo:

cargo install --git https://github.com/vyshnavsdeepak/ccswitch

From source:

git clone https://github.com/vyshnavsdeepak/ccswitch
cd ccswitch
cargo install --path .

---

Quick start

OAuth accounts (browser login)

# 1. Log in to your first account in Claude Code, then:
ccswitch add          # snapshots credentials → Account 1

# 2. Log out, log in to your second account, then:
ccswitch add          # snapshots credentials → Account 2

# 3. Switch any time:
ccswitch switch 1     # switch to Account 1
ccswitch switch 2     # switch to Account 2
ccswitch switch       # rotate to the next account

# 4. Restart Claude Code to apply.

Token accounts (claude setup-token)

# 1. Make sure CLAUDE_CODE_OAUTH_TOKEN is set in your shell, then:
ccswitch add
# → reads the token from $CLAUDE_CODE_OAUTH_TOKEN automatically
# → prompts for an email/label (e.g. work@company.com)
# → writes the token directly to the system keychain

# 2. Add more token accounts:
ccswitch add
# → if $CLAUDE_CODE_OAUTH_TOKEN is already managed, prompts for a different token

# 3. Switch:
ccswitch switch 2
# → writes the new token to the keychain; restart Claude Code to apply

---

Commands

ccswitch                      open interactive TUI (recommended)
ccswitch add                  add current / $CLAUDE_CODE_OAUTH_TOKEN account
ccswitch list                 list all managed accounts (shows session expiry)
ccswitch status               show which account is active
ccswitch switch [n|email]     switch to account n or by email; rotates if omitted
ccswitch refresh [n|email]    refresh OAuth session token (active account if omitted)
ccswitch remove [n|email]     remove account n or by email

switch and remove accept either the account number or the full email address:

ccswitch switch 2
ccswitch switch work@company.com
ccswitch remove personal@gmail.com

---

TUI

Run ccswitch with no arguments for the full interactive interface.

╭─ ccswitch ───────────────────────────────╮
│  Active: work@company.com                │
╰──────────────────────────────────────────╯
╭─ 3 accounts ─────────────────────────────╮
│  ▶   1  work@company.com       active    │
│      2  personal@gmail.com               │
│      3  team@startup.ai  [token]         │
╰──────────────────────────────────────────╯
╭──────────────────────────────────────────╮
│  ↑↓ nav  ·  ↵ switch  ·  a add  ·  q quit│
╰──────────────────────────────────────────╯

Key	Action
↑ / k	move up
↓ / j	move down
Enter / Space	switch to selected account
a	add current account
d / Delete	remove selected account
q / Esc	quit

Token accounts show a dim [token] badge. After switching, restart Claude Code to apply — no new shell needed.

---

After switching

Restart Claude Code — that's it. Credentials are written directly to the system keychain, so no new shell or environment changes are needed.

Note: if CLAUDE_CODE_OAUTH_TOKEN is set in your current shell (from a previous setup), ccswitch will warn you. Run unset CLAUDE_CODE_OAUTH_TOKEN or add source ~/.ccswitchrc to your shell profile to clear it permanently.

---

How ~/.ccswitchrc works

ccswitch writes a small file that clears CLAUDE_CODE_OAUTH_TOKEN so Claude Code reads credentials from the keychain instead:

# Managed by ccswitch — do not edit manually
unset CLAUDE_CODE_OAUTH_TOKEN

Add source ~/.ccswitchrc to your ~/.zshrc (or ~/.bashrc) once. Any shell you open will have the env var cleared, so Claude Code always uses the keychain — which ccswitch keeps up to date.

---

Security

• macOS: all credentials stored in the system keychain via security(1) — no plaintext secrets on disk.
• Linux/WSL: per-account credential files under ~/.claude-switch-backup/credentials/ with 0600 permissions; directory is 0700.
• All file writes are atomic (write to temp → rename) to prevent corruption on crash.
• ~/.ccswitchrc contains a lookup command, not the raw token.

---

File layout

~/.claude-switch-backup/
├── sequence.json              # account list and active state
├── configs/
│   └── .claude-config-1-email@example.com.json   # per-account Claude config
└── credentials/               # Linux/WSL only (macOS uses keychain)
    └── .claude-credentials-1-email@example.com.json
~/.ccswitchrc                  # token env var loader (token accounts only)

---

Platforms

Platform	Credential store
macOS	system keychain (security add-generic-password)
Linux	~/.claude-switch-backup/credentials/ (mode 0600)
WSL	same as Linux