Orpheus
Docs

Managing multiple accounts

Run several Claude accounts on one machine, see each one's weekly limit, and move agents between them.

What an account is

Each Claude subscription (Pro or Max) you sign in to on a machine is one connected account. Your plan sets how many you can connect: 1, 2, 4, 8 or 12.

On the machine, each account lives in its own Claude config folder. Your default account is in ~/.claude. Every extra account gets one more folder.

Config folderAccountThis week
~/.claudethe defaultPersonal PRO41%
~/.claude-workone more folderWork Max MAX88%

Why run more than one

  • More capacity. Each account has its own weekly limit.
  • Work and personal apart. An agent runs under the account you start it with.
  • Agents keep running. When one account hits its limit, its agents can move to another.

What you need

  • A plan that covers the number of accounts you want to connect. See Pricing.
  • A machine already connected to Orpheus. See the setup guide.
  • Agents running inside tmux. Orpheus only sees sessions in tmux.

1Sign in each extra account

Pick a folder name for the account, for example ~/.claude-work. Start Claude Code with that folder:

CLAUDE_CONFIG_DIR=~/.claude-work claude

Inside it, sign in to the other subscription:

/login

Do this once per extra account, with a different folder each time. Your default account stays in ~/.claude and is not touched.

2Start an agent under an account

In tmux, start the agent with the folder of the account it should use:

# a tmux session for the project tmux new -s myproject cd ~/code/myproject # this agent runs on the Work account CLAUDE_CONFIG_DIR=~/.claude-work claude

Run plain claude to use the default account. Orpheus sees which account each session uses. Usage shows each account's weekly limit once usage reading is on for the machine: set "usage": true in the policy file from step 3. It is off until you turn it on.

The Usage page with one card for each Claude account, each showing its weekly limit and whether it is on track.
Usage: one card per account, with its week and whether it is on track.

3List the logins in the policy file

To let Orpheus switch sessions between accounts, list the logins in the connector policy on that machine: ~/.config/orpheus-connector/policy.json. Add a logins list and keep the settings already in the file.

"logins": [ { "label": "Personal", "configDir": "~/.claude" }, { "label": "Work Max", "configDir": "~/.claude-work" } ]
  • label is the name you see in Orpheus.
  • configDir is the folder you signed that account into in step 1.
  • List every account an agent may move onto, your default ~/.claude too. A move to a folder that is not listed is refused.
This file lives only on your machine. Orpheus cannot change it.

4Move an agent to another account

  1. Open Usage in Orpheus and tap the session under its account.
  2. Pick the account to move it to.

It works on idle Claude sessions. Orpheus restarts the agent under the other account with claude --continue, so the conversation carries on.

The move sheet on Usage: an idle session and the accounts it can move to.
Move to another account, on an idle Claude session.

5When an account runs low

Usage shows each account's week and whether it is on track to last until it resets.

To have Orpheus act on it, turn on Auto-move at the top of the Usage page. Only an admin can change it.

  • It moves idle sessions off an account that is projected to run out, or is over your threshold. The default threshold is 90%.
  • They go to the account with the most room on the same machine.
  • Every move is logged.
The Usage page with the Auto-move switch and its threshold.
Auto-move at the top of the Usage page.

Quick reference

Sign in an extra account
CLAUDE_CONFIG_DIR=~/.claude-work claude, then /login
Start an agent under it
The same command, inside tmux
Let Orpheus switch accounts
logins in ~/.config/orpheus-connector/policy.json
Move one agent
Usage, tap the session, pick the account
Move agents automatically
Auto-move on the Usage page (admin only)
See every limit
Usage