Claude Code account switcher for macOS

Keep all your Claude Code accounts signed in on one Mac. See each one's 5-hour and weekly usage limits, switch in one click, and let it switch for you before a limit stops your work.

Get it on GitHub Install in 2 minutes
ccs listing three Claude Code accounts with usage bars in the terminal, the CCS Usage menu bar popover, and a permission request answered on the phone

Everything about your Claude Code limits, in one place

🖥 Terminal

ccs lists every account with its limits and reset times. ccs use 2 switches.

📊 Menu bar

The active account's usage at all times. Click for usage cards, pace markers, a 24-hour chart and a Switch button per account.

⚡ Auto-switch

Checks every 2 minutes. At 90% it asks, at 95% it moves you to the least-used account.

📱 Telegram bot

Usage and switching from your phone. While you're away, Claude's permission prompts and questions come with buttons.

🔔 Alerts

A report when a task finishes, a forecast before a limit runs out, and a warning when usage rises while your Mac is idle.

🔒 Keychain only

Tokens never touch a plain file. .env files, keys and folders you list never leave the Mac.

See it

Terminal output of ccs: three accounts, each with 5-hour and weekly usage bars in green, orange or red
ccs in the terminal: green below 70%, orange from 70%, red from 90%.
The CCS Usage menu bar popover with session and weekly usage cards, a history chart and other accounts
The menu bar popover.

Install

You need macOS 14+, the claude CLI and python.org Python 3.9+ at /usr/local/bin/python3. No other dependencies.

  1. Get the script: 
    git clone https://github.com/green-thunder/claude-code-account-switcher && cd claude-code-account-switcher
mkdir -p ~/.local/bin && cp ccs ~/.local/bin/ccs && chmod +x ~/.local/bin/ccs
  2. Save your current account, sign in to the next one, save it too: 
    ccs            # saves the account you're logged into
claude         # then /login with the other account
ccs            # adds it to the list
  3. Switch any time: 
    ccs use 2

The menu bar app, auto-switch and the Telegram bot each take one more command. See the full install guide.

Questions

How do I use multiple Claude Code accounts on one Mac?

Install ccs and run it once to save the account you are logged into. In claude, run /login with the other account, then run ccs again. From then on, ccs use 2 switches to the second account, or use the menu bar app.

How can I see my Claude Code usage limits?

ccs shows each account's 5-hour session usage and weekly usage, with the time until each limit resets, in the terminal and in its menu bar app.

What happens when an account gets close to its limit?

The auto agent checks every 2 minutes. At 90% it asks whether to switch, and at 95% it switches by itself to the least-used account that is under 90%.

Where does ccs keep my login tokens?

Only in the macOS Keychain, never in a plain file.

Does ccs work on Linux or Windows?

No. ccs is built on the macOS Keychain, launchd and SwiftUI, so it runs on macOS 14 or later only.

Is it allowed to use several Claude accounts?

Using several accounts to get around usage limits may break Anthropic's terms. ccs is meant for people who have more than one account anyway, such as a team seat and a personal plan.