Why?

Claude CLI stores all config in a single ~/.claude/ directory — so you're locked to one account at a time. Switching means logging out, logging in, and losing your settings.

claude-multi-account fixes this:

• Isolated profiles — each account gets its own config directory, no conflicts
• Shared settings — define MCP servers, env vars, plugins, and CLAUDE.md once — auto-applied everywhere
• Plugin & marketplace management — enable plugins globally or per-account, browse marketplace indexes
• Direct launch — run claude-work or claude-personal directly from any terminal, no menu needed
• Cloud backup & restore — securely sync all profiles to the cloud and restore on any machine
• One command — launch any account instantly from an interactive menu

Features

Multi-Account Management Create, launch, rename, and delete independent Claude CLI profiles

Shared MCP & Settings Define MCP servers, env vars, and preferences once — sync to all accounts

Plugins & Marketplace Enable/disable plugins globally or per-account, browse and manage marketplace indexes

Global CLAUDE.md Write instructions and skills that apply across every account

Backup & Restore Timestamped local archives of all accounts and configs with one click

Export / Import Profiles Copy a profile between machines as a single base64 token — credentials, settings, and launcher included

Cloud Backup & Restore Securely sync all profiles to the cloud — restore on any machine with a single command

Direct Profile Launch Each profile is auto-registered on PATH — run claude-work directly from any terminal

Auto Dependency Detection Detects and offers to install missing dependencies (curl, jq, etc.) on first run

Run from Repo Add the repo to your PATH — git pull instantly updates the menu, no manual copying

Install

Pick any method — they all give you the claude-menu (or multi-claude) command.

One-liner (recommended)

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.ps1 | iex

npm

npm install -g @ghackk/multi-claude

pip

pip install multi-claude

Homebrew (macOS / Linux)

brew install ghackk/tap/multi-claude

Scoop (Windows)

scoop bucket add multi-claude https://github.com/ghackk/scoop-multi-claude
scoop install multi-claude

AUR (Arch Linux)

yay -S multi-claude

Manual (git clone)

# Linux / macOS
git clone https://github.com/ghackk/claude-multi-account.git ~/claude-multi-account
echo 'alias claude-menu="~/claude-multi-account/unix/claude-menu.sh"' >> ~/.bashrc

# Windows
git clone https://github.com/ghackk/claude-multi-account.git $HOME\claude-multi-account
[Environment]::SetEnvironmentVariable("PATH", "$HOME\claude-multi-account;" + [Environment]::GetEnvironmentVariable("PATH", "User"), "User")

Then open a new terminal and run claude-menu.

Menu Overview

Main Menu

======================================
       Claude Account Manager
======================================
  Current Accounts:

  1. claude-work     [logged in]   (last used: 02 Mar 2026 10:30 AM)
  2. claude-personal [logged in]   (last used: 01 Mar 2026 08:15 PM)

======================================
  1. List Accounts
  2. Create New Account
  3. Launch Account
  4. Rename Account
  5. Delete Account
  6. Backup Sessions (Local)
  7. Restore Sessions (Local)
  8. Shared Settings (MCP/Skills)
  9. Plugins & Marketplace
  E. Export Profile (Token)
  I. Import Profile (Token)
  C. Cloud Backup
  R. Cloud Restore
  0. Exit
======================================

Shared Settings (Option 8)

Manage universal settings applied to all accounts on launch:

| Option | Action | |--------|--------| | 1 | Edit MCP + Settings (opens in editor) | | 2 | Edit Skills/Instructions (CLAUDE.md) | | 3 | View current shared settings | | 4 | Sync shared settings to ALL accounts | | 5 | Show MCP server list | | 6 | Reset shared settings |

Plugins & Marketplace (Option 9)

Browse marketplace indexes and manage plugins across accounts:

| Option | Action | |--------|--------| | 1 | Enable plugin for ALL accounts | | 2 | Enable plugin for one account | | 3 | Disable plugin (shared) | | 4 | Disable plugin (one account) | | 5 | Browse marketplace plugins | | 6 | Marketplace Management (add/remove/sync) |

Export / Import Profile (Options E & I)

Transfer a profile between machines using a copy-pasteable base64 token:

| Option | Action | |--------|--------| | E | Export a profile — generates a compact token (~5 KB) containing credentials, settings, and launcher | | I | Import a profile — paste the token to restore the account on any machine |

The token bundles only essentials (credentials, settings, CLAUDE.md, launcher) — not cache or conversation history.

Cloud Backup & Restore (Options C & R)

Sync all profiles to the cloud and restore on any machine:

| Option | Action | |--------|--------| | C | Cloud Backup — select profiles and optional folders (shared settings, plugins, etc.) to upload securely | | R | Cloud Restore — enter your route key to download and restore all profiles on a new machine |

Profiles are automatically registered on PATH after restore, so you can run claude-work immediately.

Direct Profile Launch

Every profile you create is automatically available as a command:

# No need to open the menu — just run the profile name directly
claude-work
claude-personal

On Linux/macOS/Termux, symlinks are created in ~/.local/bin/. On Windows, the accounts directory is added to your user PATH. Profiles created, imported, or restored are all registered automatically.

How It Works

┌─────────────┐      ┌──────────────────┐      ┌─────────────────┐
│  You pick    │ ───> │  Shared settings │ ───> │  Claude CLI     │
│  an account  │      │  + plugins are   │      │  launches with  │
│  from menu   │      │  merged in       │      │  isolated config│
└─────────────┘      └──────────────────┘      └─────────────────┘

Each account gets its own config directory (~/.claude-<name>). On every launch, shared settings from ~/claude-shared/ are deep-merged into the account — MCP servers, env vars, preferences, plugins, marketplace indexes, and CLAUDE.md instructions all stay in sync.

Merge Strategy

Settings are deep-merged with shared settings winning on conflict:

| Scenario | Result | |----------|--------| | Key exists only in account | Kept | | Key exists only in shared | Added | | Key exists in both (simple value) | Shared wins | | Key exists in both (nested object) | Recursively merged |

For CLAUDE.md, shared content is inserted between auto-managed markers at the top. Account-specific instructions below the markers are preserved.

Folder Structure

~/
├── claude-multi-account/      # Git repo (can be added to PATH directly)
│   ├── claude-menu.ps1        # Windows menu script
│   ├── claude-menu.bat        # Windows launcher
│   ├── windows/               # Windows-specific scripts
│   └── unix/                  # Linux/macOS scripts
│
├── claude-accounts/           # Account launchers (auto-created)
│   ├── claude-work.bat/.sh    # Account launcher
│   └── claude-personal.bat/.sh
│
├── claude-shared/             # Shared config (applied to all accounts)
│   ├── settings.json          # MCP servers, env vars, preferences, enabledPlugins, extraKnownMarketplaces
│   ├── CLAUDE.md              # Global instructions & skills
│   └── plugins/               # Shared plugin & marketplace data
│       └── marketplaces/      # Cached marketplace indexes
│
├── claude-backups/            # Timestamped backup archives
│
├── .claude-work/              # Account: work (auto-created)
├── .claude-personal/          # Account: personal (auto-created)
└── .claude-<name>/            # Account: <name>

Documentation

• Installation Guide — setup for all platforms
• Usage Guide — full walkthrough of every feature

Requirements

• Claude CLI installed and available in PATH
• Windows: PowerShell 5.1+ (dependencies auto-detected via winget/scoop)
• Linux/macOS: Bash 4+ (dependencies like curl, jq auto-detected and offered for install on first run)
• Termux: Supported — dependencies installed via pkg

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

Credits

Built by Gyanesh Kumar

License

MIT