____ _        _   _   _ ____  _______        ___   _  ___
  / ___| |      / \ | | | |  _ \| ____\ \      / / | | |/ _ \
 | |   | |     / _ \| | | | | | |  _|  \ \ /\ / /| |_| | | | |
 | |___| |___ / ___ \ |_| | |_| | |___  \ V  V / |  _  | |_| |
  \____|_____/_/   \_\___/|____/|_____|  \_/\_/  |_| |_|\___/

claudewho

Manage multiple Claude Code account configurations easily. Switch between work and personal accounts, or maintain separate configurations for different projects.

Installation

Homebrew (recommended)

brew install frisble/tap/claudewho

Or:

brew tap frisble/tap
brew install claudewho

Manual

git clone https://github.com/frisble/claudewho.git
cd claudewho
chmod +x bin/claudewho
sudo ln -s "$(pwd)/bin/claudewho" /usr/local/bin/claudewho

Usage

Create accounts

claudewho add work
claudewho add personal
claudewho add client-project

List accounts

claudewho list

Output:

Configured Claude accounts:

  work                 ~/.claudewho-work              (authenticated)
  personal             ~/.claudewho-personal          (not authenticated)
  client-project       ~/.claudewho-client-project    (authenticated)

Use claudewho-<name> or claudewho use <name> to launch.

Launch Claude with an account

# Using the wrapper command (recommended)
claudewho-work
claudewho-personal

# Or using the command
claudewho use work

Remove an account

claudewho remove personal

This will prompt for confirmation before deleting the account directory.

Commands

Command	Description
list	List all configured accounts
add <name>	Create a new account configuration
remove <name>	Remove an account (with confirmation)
use <name>	Switch to the specified account
ide-setup	Configure IDE integration (VSCode)
shell-init	Print shell aliases for sourcing
version	Show version information
help	Show help message

IDE Integration (VSCode)

The Claude Code IDE extensions bundle their own CLI and don't respect CLAUDE_CONFIG_DIR by default. claudewho provides wrapper scripts that work with the extension's claudeProcessWrapper setting.

Setup

claudewho ide-setup

This creates the necessary wrapper scripts and prints configuration instructions.

Option 1: Follow current account

All IDE windows share whichever account is active via claudewho use <name>.

Add to your VSCode settings.json (Cmd+Shift+P > "Open Settings (JSON)"):

"claude-code.claudeProcessWrapper": "~/.local/bin/claudewho-ide"

Option 2: Per-workspace account (parallel)

Different workspaces can use different accounts simultaneously.

Add to your workspace's .vscode/settings.json:

"claude-code.claudeProcessWrapper": "~/.local/bin/claudewho-ide-work"

To see all available per-account wrappers:

claudewho ide-setup

Or get the config for a specific account:

claudewho ide-setup --account work

How it works

• Each account is stored in ~/.claudewho-<name>/
• Account names are tracked in ~/.claudewho.conf
• Wrapper scripts like claudewho-work are created in ~/.local/bin/ and set CLAUDE_CONFIG_DIR before launching Claude
• Your original ~/.claude directory is never modified

Requirements

• Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
• Bash 4.0+ or Zsh
• macOS or Linux

Notes

• Each account requires a separate Anthropic account (different email)
• Each account has its own usage limits
• Check Anthropic's terms of service to ensure compliance

License

MIT