Claude Code Multi-Account Manager
한국어
A Claude Code plugin for managing multiple accounts. Switch between accounts without logging out and monitor usage at a glance.
Installation
# Register marketplace (once)
claude plugin marketplace add https://github.com/lee-ji-hoon/claude-multi-account-manager.git
# Install plugin
claude plugin install account@lee-ji-hoon
# Restart Claude Code
After installation, your current account is automatically registered on session start, and terminal aliases (account, account-list, account-switch) are set up.
Features
- Account Switching — Switch to saved accounts instantly without logging out
- Auto Token Refresh — Refreshes all tokens on session start; refreshes expiring tokens on each message
- Usage Monitoring — Current session (5h) / weekly (7d) usage with progress bars
- Auto Plan Detection — Free / Pro / Team / Max5 / Max20
- Organization Support — Manages personal and org accounts separately, even with the same email
Commands
| Command | Description |
|---|
/account:list | List accounts + real-time usage |
/account:add [name] | Save current account |
/account:switch [id] | Switch account |
/account:remove [id] | Delete account |
/account:check | Check token status |
/account:set-plan [id] [plan] | Set Plan manually |
/account:export | Export account as JSON |
/account:import [json] | Import accounts from another machine |
/account:logs | View token refresh logs |
/account:repair | Diagnose & fix installation issues |
/account:report | Auto-create GitHub Issue with diagnostics |
Example
/account:list
Claude Accounts
───────────────────────────────────────────────────────
[1] ● work @Team [Max5] - active
[email protected]
now ██░░░░░░░░░░ 24% | ⏱ 4h 27m
week ██████░░░░░░ 51% | ⏱ 87h 27m
token 🔑 6h 15m remaining
[2] personal [Pro]
[email protected]
week ███░░░░░░░░░ 30% | ⏱ 120h 10m
token 🔑 3h 42m remaining
───────────────────────────────────────────────────────
How It Works
flowchart LR
subgraph Hooks
A[Session Start] --> B[Auto-register + Refresh all tokens]
C[Message Submit] --> D{Expires within 1h?}
D -->|Yes| E[Refresh token]
D -->|No| F[Skip]
end
subgraph Account Management
G["account:add"] --> H[Save to Keychain]
I["account:switch"] --> J[Swap token]
end
Data Storage
| Item | Location |
|---|
| Account index | ~/.claude/accounts/index.json |
| OAuth tokens | macOS Keychain + ~/.claude/accounts/credential_*.json |
| Profiles | ~/.claude/accounts/profile_*.json |
| Refresh logs | ~/.claude/accounts/logs/token-refresh.log |
Terminal Usage
After installation, you can use it directly from the terminal:
account # Help
account list # List accounts
account switch # Interactive switch
account-list # Shortcut alias
account-switch # Shortcut alias
Multi-Mac Sync (Optional)
Sync account data across multiple Macs via Telegram Bot.
# On Mac A
/account:push # Send to Telegram
# On Mac B
/account:pull # Receive from Telegram
Setup: Add bot_token and chat_id to ~/.claude/hooks/telegram-config.json.
Troubleshooting
/account:repair — Auto Diagnostics
Automatically diagnoses and fixes installation issues, token errors, and duplicate accounts.
/account:report — Bug Report
If the issue persists, run /account:report to collect diagnostics and auto-create a GitHub Issue.
Manual Checks
# Token status
/account:check
# Refresh logs
/account:logs
# Log file directly
cat ~/.claude/accounts/logs/token-refresh.log
Requirements
- macOS (uses Keychain)
- Python 3.8+
- Claude Code CLI
Contributing
Report bugs or suggest features via Issues.
Run /account:report in a Claude Code session to auto-create an Issue with diagnostic info.
License
MIT
