AgentsMulti-account

Agents

Multi-account

Keep several Claude or Codex logins on one device and pick the account each session runs under.

Top bar · New session
How to
  1. Log in once per account. Give each one its own config dir (e.g. CLAUDE_CONFIG_DIR=~/.claude-work claude).
  2. Open New session. Use New session in the top bar.
  3. Pick the account. Choose it from the Account picker.
  4. Create. The session launches bound to that account’s config.
One session, one account

A device can hold several Claude or Codex accounts (each is a config directory like ~/.claude or ~/.codex-work). When you open a new session, an Account picker lets you choose which one it runs under - the session is launched bound to that account’s config, so work and personal quotas never mix.

Accounts are scoped to the device: the picker on a remote box lists the logins that exist on that box, which means a session created over SSH uses the remote credentials, not your laptop’s.

To add another account, log into it in a terminal with a different config dir (e.g. CLAUDE_CONFIG_DIR=~/.claude-work claude). It then shows up in the picker automatically.

Was this page helpful?