Quick Start

Get up and running with multiple Claude Code accounts in under a minute.

Why claude-account-switch?

Claude Code doesn't officially support multiple accounts. claude-account-switch uses the CLAUDE_CONFIG_DIR environment variable to manage separate profiles, each with its own OAuth credentials.

Setup

npx claude-account-switch init

Here's what the interactive wizard looks like:

  ╭──────────────────────────────────────╮
  │ Welcome to Claude Switch!            │
  │ Multi-account manager for Claude Code│
  ╰──────────────────────────────────────╯

  How many profiles do you want to set up? 2

  Profile 1 name: work
  Profile 2 name: personal

  Which profile should be active by default?
  ❯ work
    personal

  Share settings across profiles? (recommended) Yes

  Existing ~/.claude detected. Migrate to a profile?
  ❯ Yes, migrate to "work"
    Yes, migrate to "personal"
    No, skip

  ✓ Migrated ~/.claude → profile: work
  ⚠ Original ~/.claude was NOT deleted.
  ✓ Created profile: work
  ✓ Created profile: personal
  ✓ Shared settings linked
  ✓ Shell integration installed (zsh, bash)
  ✓ Active profile: work

  Next steps:
    1. Open a new terminal
    2. Run claude to authenticate your "work" profile
    3. Run cpf personal && claude to authenticate "personal"

After Setup

claude           # Launch Claude with the active profile
cpf work         # Quick switch to "work" profile
cpf personal     # Quick switch to "personal" profile
claude-pick      # Interactive profile selector with arrow keys

Next Steps

• Installation — all installation methods
• Commands — full CLI reference
• Shell Integration — available shell commands
• Platform guides: macOS · Linux · Windows