ccprofiles

Multi-account profile manager for Claude Code. Switch OAuth accounts without logout/login.

Install

npm install -g @achoo254/ccprofiles
ccprofiles setup  # Install /profile skill into Claude Code

Quick Start

# 1. Save your current account
ccprofiles save work

# 2. Login to another account
claude auth login --email [email protected]

# 3. Save that account
ccprofiles save personal

# 4. Switch between accounts
ccprofiles switch work

# 5. List all profiles
ccprofiles list

Commands

| Command | Description | |---------|-------------| | ccprofiles setup | Install /profile skill into Claude Code | | ccprofiles uninstall | Remove /profile skill | | ccprofiles save [name] | Snapshot current credentials (auto-detects name from email) | | ccprofiles switch <name> | Switch to a saved profile | | ccprofiles list | Show all profiles | | ccprofiles status | Current profile details + token expiry | | ccprofiles whoami | One-line active profile (script-friendly) | | ccprofiles check | Verify token is still valid | | ccprofiles delete <name> | Delete a profile | | ccprofiles restore | Rollback to pre-switch backup | | ccprofiles clone <name> | Export profile skeleton for another machine | | ccprofiles dashboard | Open browser dashboard to manage profiles |

Claude Code Integration

After running ccprofiles setup, you can manage profiles directly in Claude Code:

> /profile list
> /profile switch personal
> /profile save work

After switching, exit Claude Code and reopen to load the new credentials. Then run /profile status to verify.

Dashboard

View and manage all profiles in your browser:

ccprofiles dashboard

Opens a local web dashboard with real-time updates. Features:

• Profile cards with email, subscription type, and token status
• Switch, check, save, and delete profiles from the browser
• Dark/light theme based on OS preference
• Auto-shutdown after 10 minutes idle

How It Works

Profiles are stored in ~/.claude/profiles/{name}/:

~/.claude/profiles/
├── active              # Current profile name
├── _base/              # Auto-backup before each switch
├── work/
│   ├── .credentials.json
│   ├── settings.json
│   └── meta.json
└── personal/
    ├── .credentials.json
    ├── settings.json
    └── meta.json

Switching copies the profile's credentials and settings to ~/.claude/ (full replace).

FAQ

Q: What happens if a token expires? Run ccprofiles check to verify. If expired, run claude auth login then ccprofiles save <name>.

Q: Is my data safe? Every switch creates a backup in _base/. Use ccprofiles restore to rollback. Credentials are stored with the same security as Claude Code's own storage.

Q: Does it work on Windows/macOS/Linux? Yes. Zero dependencies — uses only Node.js built-ins.

Q: Can I share profiles between machines? Use ccprofiles clone <name> to export a profile skeleton (settings + metadata, no credentials). Then auth on the new machine.

Requirements

• Node.js >= 18
• Claude Code CLI installed

License

MIT