MultiClaude

A small set of macOS companion tools for Claude Code: run it under multiple accounts and keep an eye on each account's subscription usage from the terminal or the desktop.

All three are read-only against your own Claude accounts. They read the OAuth tokens Claude Code already stores in the macOS Keychain - nothing is sent anywhere except Anthropic's own usage endpoint, the same one behind /usage.

Platform: macOS only. The tools rely on the macOS Keychain (security) and the widget is a native AppKit/SwiftUI app.

How it works

Claude Code keeps a separate login per CLAUDE_CONFIG_DIR, storing each in a Keychain slot named Claude Code-credentials-<sha256(config_dir)[:8]>. So "switching account" is just pointing CLAUDE_CONFIG_DIR at a different directory. claude-acct does that, and also mirrors each login into a stable, human-named slot (Claude Code-credentials-<label>) so claude-usage can find it without depending on Claude's internal hashing.

Configuring accounts

Both claude-acct and claude-usage read the same account file, so they never drift. You don't have to create it yourself - the installer seeds it from accounts.example, and claude-acct writes a starter on first run if it's still missing. Either way, the file lands at ~/.config/claude-acct/accounts; open it and fill in your accounts:

$EDITOR ~/.config/claude-acct/accounts

One account per line - <label> <config_dir> [email]:

work       ~/.claude            [email protected]
personal   ~/.claude-personal   [email protected]

• label - the short name you type (claude-acct work).
• config_dir - that account's CLAUDE_CONFIG_DIR (~ and $HOME expand).
• email - optional, shown for context only.

The first account listed is the "primary": its <config_dir>/skills folder is symlinked into the other accounts' config dirs, so every account sees the same skills.

Override the location with $CLAUDE_ACCT_CONFIG if you don't want ~/.config/claude-acct/accounts.

Install

claude-usage needs only Python 3 from the system - no third-party packages; the widget build additionally needs the Xcode toolchain (swiftc).

Automatic install

Run the interactive installer:

./install.sh

It links the two scripts onto your PATH, seeds the accounts config from accounts.example, and (optionally) builds the desktop widget. It's idempotent - safe to re-run; each step checks current state and only does what's needed, and nothing is overwritten without asking. Useful flags:

./install.sh --yes            # non-interactive, accept defaults
./install.sh --bindir DIR     # link into DIR instead of ~/.local/bin
./install.sh --no-widget      # skip the widget build
./install.sh --uninstall      # remove the links it created

Manual install

Prefer to do it by hand? The installer just automates these steps:

1. Link the scripts onto your PATH (any directory on PATH works; ~/.local/bin is a common one):

   copy

   ln -s "$PWD/claude-acct"  ~/.local/bin/claude-acct
   ln -s "$PWD/claude-usage" ~/.local/bin/claude-usage
   

2. Seed the accounts config - copy the example and edit it (see Configuring accounts):

   copy

   mkdir -p ~/.config/claude-acct
   cp accounts.example ~/.config/claude-acct/accounts
   

3. Build the widget (optional - see ClaudeUsage widget):

   copy

   ./build-widget.sh
   

claude-acct

Launch Claude Code under a chosen account:

claude-acct work            # launch directly under "work"
claude-acct personal --foo  # any extra args are passed through to claude
claude-acct                 # no label → interactive menu

It exports CLAUDE_CONFIG_DIR, mirrors the login slot before and after the session (to capture token refreshes), and shares the primary account's skills.

claude-usage

Print usage for every configured account:

claude-usage           # colored bars in the terminal
claude-usage --json    # machine-readable, used by the widget

Each account shows its session (5h), weekly, and (if enabled) extra-usage limits with reset times. An account that isn't logged in, has an expired session, or can't reach the API shows a warning with a hint instead of numbers.

ClaudeUsage widget

A borderless, translucent panel that sits on the desktop (no Dock icon), shells out to claude-usage --json every 5 minutes, and renders the result. It's draggable and account-agnostic - it just displays whatever claude-usage reports.

To launch it at login, add ClaudeUsage.app to System Settings → General → Login Items. The app looks for claude-usage on a standard PATH (~/.local/bin, Homebrew, /usr/bin) or beside the app bundle.

Contributing

Contributions are welcome - see CONTRIBUTING.md for scope, ground rules, and how to test changes.

License

MIT