Run several Claude Desktop accounts at once on one Mac

Each window has its own sign-in. All of them share one Claude Code setup, so a session in one account can send work to a session in another.

One bash script · no dependencies · never modifies Claude.app · free and open source (MIT)

Get it on GitHub Quick start All install methods
One Claude.app opens one window per account. Each window has its own sign-in and chats, all windows read one shared ~/.claude, and Claude Code sessions in different accounts can message each other.

What makes it different

Claude Desktop runs one account at a time. If you open it again, the same window comes back to the front. Other tools work around this by keeping every account fully separate. claude-multi-desktop keeps the sign-ins separate and lets the accounts share the rest:

  1. Separate accounts, one setup. Each window signs in to its own account and keeps its own chats, projects and plan. Claude Code in every window reads the same ~/.claude: skills, CLAUDE.md, memory, MCP servers, hooks and settings. If you write a skill once, every account has it.
  2. Sessions talk across accounts. A Claude Code session in your Work window can see the sessions in your Personal window and send one a message with Claude Code's built-in ListAgents and SendMessage tools. See how.
  3. No dependencies, nothing patched. Each launcher opens the Claude.app you already have with Electron's public --user-data-dir flag. It makes no copy of Claude.app, re-signs nothing and runs nothing in the background. Claude's updates reach every account.

Quick start

You need macOS and Claude Desktop in /Applications.

brew install jackson-cmd/tap/claude-multi-desktop
claude-multi-desktop add Work            # launcher "Claude Work" with its own sign-in
claude-multi-desktop open Work           # second window: sign in with your other account
claude-multi-desktop add Main --default  # launcher for the account you already use

The launchers go to ~/Applications, so Spotlight, Launchpad and the Dock find them. Drag them to the Dock and click whichever account you want; they can all stay open side by side.

No Homebrew, or would you rather not use Terminal? Install lists a Mac installer, a disk image with a double-click app, npm and a Claude Code plugin.

Install

Homebrew is the shortest way. The others are for people without Homebrew, or who would rather not use Terminal.

Homebrew

brew install jackson-cmd/tap/claude-multi-desktop

Mac installer (.pkg)

Download the .pkg file from the latest release and open it. It installs the claude-multi-desktop command to /usr/local/bin and the double-click app Claude Multi Desktop to /Applications.

The installer is not signed with an Apple Developer ID, so macOS blocks it the first time you open it: see If macOS blocks the app or installer.

To uninstall it:

sudo rm /usr/local/bin/claude-multi-desktop
sudo rm -rf "/Applications/Claude Multi Desktop.app"
sudo pkgutil --forget io.github.jackson-cmd.claude-multi-desktop

Disk image (.dmg)

Download the .dmg file from the same release page, drag Claude Multi Desktop to Applications and double-click it. It asks for an account name, an icon style (a coloured letter, your Claude icon with a letter badge, or a picture) and a colour, then makes the launcher and opens it. It can also open, rename or remove launchers you already made. You never need Terminal.

The app is not signed with an Apple Developer ID either: see If macOS blocks the app or installer. The disk image carries the same steps as a text file next to the app.

If macOS blocks the app or installer

If macOS says “Apple could not verify ‘Claude Multi Desktop’ is free of malware”: the app and the installer are not signed with an Apple Developer ID, so macOS blocks them the first time you open them. The code is open source, and you only need to allow it once.

macOS 15 (Sequoia) and later

  1. Double-click the app (or the .pkg) once. When macOS blocks it, click Done.
  2. Open System Settings → Privacy & Security and scroll down to the Security section. You will see “‘Claude Multi Desktop’ was blocked to protect your Mac.” (for the installer, its file name). Click Open Anyway.
  3. Enter your Mac login password (or use Touch ID). If macOS asks once more, click Open Anyway again. From then on it opens normally.

macOS 14 (Sonoma) and earlier

  1. Right-click (or Control-click) the app (or the .pkg) and choose Open.
  2. Click Open in the dialog. You only do this once.

Want no warning at all? Install with Homebrew instead: brew install jackson-cmd/tap/claude-multi-desktop.

npm

npx claude-multi-desktop add Work     # run it without installing
npm install -g claude-multi-desktop   # or install the command

Claude Code plugin

/plugin marketplace add jackson-cmd/claude-multi-desktop
/plugin install account-handoff@multi-desktop

The plugin adds one skill, handoff (also /account-handoff:handoff). It hands a task to a Claude Code session in another account using ListAgents, SendMessage and claude-multi-desktop peers, and relays the reply. It refuses to move work to another account because an account has hit a usage limit. The plugin does not install the claude-multi-desktop command itself; use one of the methods above for that. See Sessions across accounts.

curl or git clone

Install with curl, without Homebrew
mkdir -p ~/.local/bin
curl -fsSL https://raw.githubusercontent.com/jackson-cmd/claude-multi-desktop/main/claude-multi-desktop -o ~/.local/bin/claude-multi-desktop
chmod +x ~/.local/bin/claude-multi-desktop
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc   # then open a new terminal

Or clone the repository and run the script from the folder:

git clone https://github.com/jackson-cmd/claude-multi-desktop.git
cd claude-multi-desktop
./claude-multi-desktop add Work

Sign-in and updates

Signing in

Each account signs in on its own, once. Open its launcher (or run claude-multi-desktop open NAME), click Log in in that window and finish in the browser. Your other accounts are not touched.

After that you never sign in again. Closing the window, restarting your Mac, updating Claude Desktop, renaming the launcher or updating claude-multi-desktop all keep the sign-in, because it is saved in that account's own folder (~/Library/Application Support/Claude-NAME). Only remove NAME --delete-data deletes it. If the browser sends the sign-in back to the wrong window, quit the other Claude windows, sign in, then reopen them from their launchers.

Updating Claude Desktop

Every account runs the same Claude.app, so one update covers all of them. Before you update, quit Claude in every account: while another account is still open, the update may not install, or the open windows may misbehave.

  1. Quit every Claude window (⌘Q in each one, or Claude → Quit Claude).
  2. Open Claude the normal way, or from your Claude Main launcher, and install the update when Claude offers it (or choose Claude → Check for Updates).
  3. Open your other accounts again from their launchers.

You never need to remake launchers after a Claude update.

Updating claude-multi-desktop

Installed withUpdate with
Homebrewbrew upgrade claude-multi-desktop
Mac installer or disk imageDownload the newer .pkg or .dmg from the latest release and install it the same way
npmnpm install -g claude-multi-desktop@latest, or npx claude-multi-desktop@latest
Claude Code plugin/plugin marketplace update multi-desktop

Launchers you already made keep working after an update, because they only open Claude.app.

Icons and names

By default a launcher gets a coloured square with the first letter of its name. You can pick another look when you add it, or change it later:

claude-multi-desktop add Work --icon claude                  # your Claude icon with a coloured letter badge
claude-multi-desktop add Home --icon ~/Pictures/home.png     # any PNG, JPEG, HEIC or ICNS picture
claude-multi-desktop icon Work --icon claude --color 2E9D6A  # change an existing launcher's icon
claude-multi-desktop rename Work Office                      # rename a launcher; sign-in and chats stay
claude-multi-desktop list --names                            # print the launcher names, one per line

--icon claude draws your own Claude icon with a coloured letter badge, on your Mac, from the Claude.app you have installed. Nothing from Anthropic is shipped with this tool. rename keeps the account's sign-in and chats; the account's folder (for example Claude-Work) is not renamed.

One limit: the custom icon belongs to the launcher, so you see it in Finder, Spotlight and Launchpad. Once a window is open, the Dock shows the normal Claude icon and name for it, because Claude.app decides that and this tool never modifies Claude.app.

What is shared and what is not

Separate per accountShared
Sign-in, plan, chats and projects✓
Desktop settings, connectors, extensions✓
Claude Code skills, commands, agents, hooks, settings✓
CLAUDE.md, memory and MCP servers✓
List of running Claude Code sessions✓

Commands

CommandWhat it does
add NAMEMake the launcher Claude NAME with its own sign-in
add NAME --defaultMake a launcher for the account you already use
add NAME --color HEXChoose the icon colour, e.g. --color 7A5AE0
add NAME --icon claudeUse your own Claude icon with a coloured letter badge, drawn on your Mac
add NAME --icon /path/to/pictureUse any PNG, JPEG, HEIC or ICNS picture as the icon
icon NAME --icon … --color HEXChange the icon or colour of an existing launcher
rename NAME NEWRename a launcher and keep its sign-in and chats (the account folder keeps its name)
listShow launchers and which accounts are open
list --namesPrint the launcher names only, one per line
open NAMEOpen that account's window
peersShow Claude Code sessions running in every account
remove NAME [--delete-data]Delete a launcher, and optionally that account's folder

FAQ

How do I use two Claude accounts at the same time on a Mac?

Run claude-multi-desktop add Work, open Claude Work and sign in with the second account. Your first account keeps working in its own window. The step-by-step guide has the details.

Why does opening Claude a second time just bring the same window back?

Claude Desktop allows one running copy per data folder. A launcher starts Claude with a different data folder, so macOS opens a second, independent window.

Do my Claude Code skills, CLAUDE.md and MCP servers work in every account?

Yes. Every account reads the same ~/.claude. If work data must stay inside a work account, use a tool that isolates Claude Code as well, such as claude-multiprofile.

Can Claude Code sessions in different accounts talk to each other?

Yes. Ask a session to list the other sessions on this Mac and to message one of them. Read the guide.

Do I need Terminal?

No. The disk image has a double-click app that asks for a name, an icon style and a colour, makes the launcher and opens it. The command line does the same and also lets you script it.

Why does the Dock show the normal Claude icon for an open window?

The custom icon belongs to the launcher. Once a window is open, the Dock icon and name come from Claude.app, and this tool never modifies Claude.app, so they stay as Claude ships them.

Does this modify, copy or re-sign Claude.app?

No. Launchers only open the Claude.app you already have, with a public Electron flag.

Disclaimer

claude-multi-desktop is an independent open-source project. It is not affiliated with, endorsed by or supported by Anthropic. “Claude” and “Claude Desktop” are trademarks of Anthropic.

Acceptable use. Use this tool only for legitimate purposes and only with Claude accounts you are entitled to use, for example to keep a work account and a personal account open side by side. Do not use it:

You are responsible for how you use your accounts. Anthropic may restrict or close accounts that break its terms, and the authors of this project accept no responsibility for that or for any other consequence of using it. The software is provided “as is”, without warranty of any kind.