Quick start

Add each account with ccam add, then start Claude Code with ccam <name> or with a shortcut you name yourself, such as ccwork. That is all most people need.

1. Add your first account

ccam add

The wizard asks for a name such as personal or work, which items the account should share with your other accounts, and whether to create a shortcut command (see step 4). Then it runs claude auth login, which opens the browser so you can sign in. When it finishes you see:

✓ personal (me@example.com) added
  no shortcut (add one with `ccam shortcut personal ccpersonal`)

2. Bring over your existing settings

If you used Claude Code before, your settings, CLAUDE.md, extensions and MCP servers are in ~/.claude. Copy them into the shared settings, so that every account gets them:

ccam migrate

ccam shows what it will copy and asks first. It only reads ~/.claude, never copies a login, and leaves conversation history out unless you add --history. See copying an existing setup for the details.

3. Add the second account

ccam add work

4. Switch accounts

ccam work starts Claude Code as the work account. For something shorter, give the account a shortcut command of its own, such as ccwork. After the shared items, the wizard asks:

 Create a shortcut command for work? [y/N]
 A command such as ccwork that opens Claude Code as this account.

Press y, then type a name, or press Enter to use the suggested one:

 Shortcut name [ccwork]: █
 a-z, 0-9, '.', '-' and '_'; Enter alone uses ccwork

After the login, ccam confirms it:

✓ work (work@example.com) added
  shortcut: ccwork

If you skipped the question, add a shortcut at any time:

$ ccam shortcut work ccwork
✓ shortcut for work: ccwork

Now any of these start Claude Code as the work account:

ccwork
ccam work
ccam 2

Running ccam alone opens a picker: use the arrow keys and Enter, or press the account's number.

Everything after the shortcut or the account name goes to Claude Code unchanged, so you keep using the options you know:

ccwork --resume
ccam work -p "fix the failing test" --output-format json
cat error.log | ccwork -p "what caused this?"

By default, MCP servers, settings.json, the global CLAUDE.md, and agents, commands, skills and plugins are shared between accounts. Conversation history is not. Turn it on for both accounts if you want to continue conversations across them:

ccam share personal --history on
ccam share work --history on

ccam shows what it will move before it changes anything. See sharing for the details.

6. When an account reaches its limit

ccam usage
ccam next --continue

ccam usage shows the 5-hour and weekly usage of every account. ccam next --continue opens the same conversation in the next account. See usage limits.

Already using ~/.claude?

ccam import

The folder stays where it is, and plain claude keeps working as before.