Claude Desktop Multi Instance

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-i