Claude Desktop Multi Instance β Development skill for Claude Code
π Run multiple Claude Desktop instances simultaneously on macOS with independent configurations, accounts, and MCP server settings.
How to install Claude Desktop Multi Instance
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open weidwonder/claude-desktop-multi-instance and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Claude Desktop Multi Instance does
π Run multiple Claude Desktop instances simultaneously on macOS with independent configurations, accounts, and MCP server settings.
Alternatives in Development
- Claude Swap β Switch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and paralle 2k β
- Claude Balancer β A load balancer proxy for multiple Claude OAuth accounts with automatic failover, request tracking, and web da 910 β
- Claude Cognitive β Working memory for Claude Code - persistent context and multi-instance coordination 440 β
README
Claude Desktop Multi-Instance Launcher
π Run multiple Claude Desktop instances simultaneously on macOS with independent configurations, accounts, and MCP server settings
**π Documentation Language / ζζ‘£θ―θ¨:**
- English: You are reading the English version
- δΈζ: δΈζζζ‘£ (Chinese Documentation)
πΈ Screenshots
Multi-Window Running Effect
Spotlight Search Integration
*Use Spotlight (β+Space) to quickly find and launch different Claude instances. Each app wrapper shows up as a separate application that maintains its login state and configuration.*
Custom Display Names in Dock
 
*When hovering over icons in the Dock, each instance displays its own custom name instead of just "Claude"*
β¨ Features
- π Multi-Instance Management - Run multiple independent Claude Desktop instances on the same machine
- π·οΈ Custom Display Names - Show different app names in Dock (e.g., "Claude Work", "Claude Personal")
- βοΈ Independent Configurations - Each instance has its own MCP server config and login credentials
- π± App Wrappers - Create independent app icons for direct Launchpad access
- π Spotlight Integration - Find and launch instances quickly using Spotlight search (β+Space)
- π οΈ Smart Diagnostics - Built-in problem diagnosis and repair tools
- π‘ User-Friendly - Both interactive menu and command-line interfaces
π System Requirements
- macOS 11 (Big Sur) or later
- Claude Desktop app (download from claude.ai/download)
- Bash shell (built into macOS)
π Quick Start
1. Download and Setup
# Clone the repository
git clone https://github.com/weidwonder/claude-desktop-multi-instance.git
cd claude-desktop-multi-iRelated Skills
Leapfrog MCP
Multi-session browser MCP server -- 15 parallel isolated Chromium sessions so multiple Claude Code terminals c
Cctx
Claude Code context manager for switching between multiple settings.json configurations
Orbit
Desktop app for running multiple Claude Code agents simultaneously.
Cc Companion
A desktop companion app for Claude Code β monitors multiple instances all in one view
Orellius Browser Bridge
Multi-session fork of Orellius Browser Bridge - supports multiple Claude instances on different tabs
Conduct
Multi-agent conductor β orchestrate multiple Claude Code instances working on issues in parallel via tmux
Related Agents
Computer Use Operator
Desktop automation specialist. Controls native macOS apps via Computer Use MCP. Handles Finder, System Setting
Optimizer MCP
Specialized agent for optimizing Claude Code MCP server configurations. Expert in .mcp.json structure, server
Pbi Dax
DAX specialist for the Power BI Desktop project currently open. Writes, validates, tests and optimizes measure
