paulocastellano/Manage Multiple Claude Code Accounts.md

Forked from KMJ-007/Manage Multiple Claude Code Accounts.md

Created September 24, 2025 13:56

Star (0) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/paulocastellano/09c138aef77422d4a5d5556c3f389fe9.js"></script>
Save paulocastellano/09c138aef77422d4a5d5556c3f389fe9 to your computer and use it in GitHub Desktop.

Download ZIP

Raw

Manage Multiple Claude Code Accounts.md

Manage Multiple Claude Code Accounts

Run two Claude Code accounts simultaneously on macOS without re-authenticating by using separate configuration directories.

Steps

Create Separate Config Directories

mkdir ~/.claude-account1
mkdir ~/.claude-account2

Add Aliases to Shell Config

Open ~/.zshrc (or ~/.bashrc for Bash) in an editor:
```
nano ~/.zshrc
```

Add:

alias claude-account1="CLAUDE_CONFIG_DIR=~/.claude-account1 claude"
alias claude-account2="CLAUDE_CONFIG_DIR=~/.claude-account2 claude"

Save and reload:
```
source ~/.zshrc
```

Authenticate Each Account
- For account 1:
```
claude-account1
```
  Log in; credentials save to ~/.claude-account1.
- For account 2:
```
claude-account2
```
  Log in; credentials save to ~/.claude-account2.
Switch or Run Simultaneously
- Run claude-account1 or claude-account2 in separate terminal tabs (Cmd + T).
- Each uses its own config and usage limits.

Notes

Requires separate Anthropic accounts (different emails).
Check Anthropic’s terms to ensure compliance.
Update Claude Code: npm install -g @anthropic-ai/claude-code.
If re-authentication occurs, verify CLAUDE_CONFIG_DIR with echo $CLAUDE_CONFIG_DIR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment