Claude Desktop Multi Instance

Claude桌面多实例启动器

🚀 在macOS上同时运行多个Claude Desktop实例，具有独立的配置、帐户和MCP服务器设置

📖 Documentation Language / 文档语言:

• 英语：你正在读英文版
• 中文: 中文文档 (Chinese Documentation)

📸 截图

多窗口运行效果

Multi-instance demo

Spotlight搜索集成

Spotlight search showing multiple Claude instances

*使用Spotlight（⌘+Space）快速查找并启动不同的Claude实例。每个应用程序包装器都显示为一个单独的应用程序，用于维护其登录状态和配置。*

Dock中的自定义显示名称

First instance name Second instance name

*当鼠标悬停在Dock中的图标上时，每个实例都会显示自己的自定义名称，而不仅仅是“Claude”*

✨ 特性

• 🔄 多实例管理 -在同一台计算机上运行多个独立的Claude Desktop实例
• 🏷️ 自定义显示名称 -在Dock中显示不同的应用程序名称（例如“Claude Work”、“Claude Personal”）
• ⚙️ 独立配置 -每个实例都有自己的MCP服务器配置和登录凭据
• 📱 应用程序包装器 -创建独立的应用程序图标，以便直接访问Launchpad
• 🔍 聚光灯集成 -使用Spotlight搜索快速查找和启动实例（⌘+空格）
• 🛠️ 智能诊断 -内置故障诊断和维修工具
• 💡 友善 -交互式菜单和命令行界面

📋 系统要求

• macOS 11（大苏尔）或更高版本
• Claude桌面应用程序（从下载 claude.ai/下载)
• Bash shell（内置于macOS中）

🚀 快速开始

1.下载和设置

# Clone the repository
git clone https://github.com/weidwonder/claude-desktop-multi-instance.git
cd claude-desktop-multi-instance

# Make script executable
chmod +x claude_quick.sh

或者直接下载脚本：

# Download single script file
curl -O https://raw.githubusercontent.com/weidwonder/claude-desktop-multi-instance/main/claude_quick.sh
chmod +x claude_quick.sh

2.首次使用

# Run script to show menu
./claude_quick.sh

# Or directly create and launch an instance
./claude_quick.sh work

📖 使用指南

交互式菜单模式

跑 ./claude_quick.sh 要显示菜单，请执行以下操作：

======================================
    Claude Desktop Quick Launcher
======================================

Available options:
1. Launch default instance
2. Select existing instance
3. Create new instance
4. Delete specified instance
5. Create app wrapper (independent icon)
6. Restore original configuration
7. Diagnose problems
8. Fix wrappers

命令行模式

# Launch or create instance
./claude_quick.sh [instance_name]

# Management commands
./claude_quick.sh list                 # List all instances
./claude_quick.sh delete [instance]    # Delete instance
./claude_quick.sh wrapper [instance]   # Create app wrapper
./claude_quick.sh diagnose             # Diagnose problems
./claude_quick.sh fix                  # Fix wrappers
./claude_quick.sh restore              # Restore original config

💼 用例

场景1：工作和个人账户分开

# Create work instance
./claude_quick.sh work
# Login with work account, configure work-related MCP servers

# Create personal instance
./claude_quick.sh personal
# Login with personal account, configure personal MCP servers

场景2：不同的项目配置

# Project A - with filesystem and web search MCP
./claude_quick.sh project-a

# Project B - with database and API MCP
./claude_quick.sh project-b

# Development environment - with Git and testing tools MCP
./claude_quick.sh dev

场景3：创建应用程序包装器

# Create independent app icon for work instance
./claude_quick.sh wrapper work
# Enter display name: Claude Work

# Now you can launch "Claude Work" directly from Launchpad or Spotlight
# It will show as "Claude Work" instead of "Claude" in Dock
# Each wrapper maintains its own login state and configuration

📁 文件结构

~/.claude-instances/                    # Instance data directory
├── work/                              # Work instance
│   └── Application Support/Claude/
│       └── claude_desktop_config.json
├── personal/                          # Personal instance
│   └── Application Support/Claude/
│       └── claude_desktop_config.json
└── scripts/                           # Helper scripts
    ├── restore.sh                     # Quick restore config
    └── list.sh                        # List all instances

/Applications/                          # App wrappers
├── Claude.app                         # Original app
├── Claude-work.app                    # Work instance wrapper
└── Claude-personal.app                # Personal instance wrapper

🔧 故障排除

问题：应用程序包装程序无法启动

解决方案：

# 1. Run diagnostics
./claude_quick.sh diagnose

# 2. Fix wrappers
./claude_quick.sh fix

# 3. If still not working, recreate
rm -rf /Applications/Claude-work.app
./claude_quick.sh wrapper work

问题：未找到Claude Desktop

解决方案：

1. 确保Claude Desktop已从下载并正确安装 claude.ai/下载
2. 确认应用程序位于 /Applications/Claude.app
3. 跑 ./claude_quick.sh diagnose 检查安装状态

问题：实例配置丢失

解决方案：

# Restore original configuration
./claude_quick.sh restore

# Check backup files
ls -la ~/Library/Application\ Support/Claude.backup.*

问题：图标显示问题

解决方案：

# Fix icons
./claude_quick.sh fix

# Or recreate app wrapper
./claude_quick.sh wrapper [instance_name]

📊 命令参考

🔒 安全考虑

1. 配置备份：脚本会自动备份原始配置，但建议手动备份
2. 敏感信息：每个实例独立存储登录信息
3. 权限控制：应用程序包装器使用与原始Claude应用程序相同的权限
4. 数据隔离：不同实例的数据完全隔离

❓ 常见问题

Q： 我可以同时运行多个实例吗？\ A： 不可以。macOS一次只能使用一个Claude Desktop实例，但您可以在它们之间快速切换。

Q： 实例之间的聊天历史记录会同步吗？\ A： 不会。不同的实例使用不同的帐户，因此聊天历史记录不会同步。

Q： 如何备份实例配置？\ A： 复制 ~/.claude-instances/[instance_name] 用于备份整个实例配置的目录。

Q： 我可以导入/导出MCP配置吗？\ A： 是的。复制 claude_desktop_config.json 文件以在实例之间共享MCP配置。

🤝 技术支持

如果您遇到问题：

1. 首次运行 ./claude_quick.sh diagnose 用于自动诊断
2. 查看本文档中的故障排除部分
3. 确保Claude Desktop应用程序是最新版本
4. 检查macOS系统版本兼容性

📄 许可证

MIT许可证-免费使用和修改

______________________________________________________________________

💡 小贴士：此工具对于需要同时管理多个Claude帐户或不同MCP服务器配置的用户特别有用。每个实例都是完全独立的，可以在不同的工作环境中安全使用。