Claude Desktop 多实例启动器

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

📖 文档语言 / Documentation Language:

• English: 您正在阅读英文版本
• 中文: 中文文档 (Chinese Documentation)

📸 屏幕截图

多窗口运行效果

Spotlight搜索集成

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

自定义Dock中的显示名称

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

✨ 特性

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

📋 系统要求

• macOS 11 (Big Sur) 或更高版本
• Claude Desktop 应用（从claude.ai/download下载）
• Bash shell（内置到macOS）

🚀 快速开始

1. 下载和安装

# 克隆仓库
git clone https://github.com/weidwonder/claude-desktop-multi-instance.git
cd claude-desktop-multi-instance

# 设置脚本可执行
chmod +x claude_quick.sh

或者直接下载脚本：

# 下载单个脚本文件
curl -O https://raw.githubusercontent.com/weidwonder/claude-desktop-multi-instance/main/claude_quick.sh
chmod +x claude_quick.sh

2. 首次使用

# 运行脚本显示菜单
./claude_quick.sh

# 或者直接创建并启动一个实例
./claude_quick.sh work

📖 使用指南

交互式菜单模式

运行 ./claude_quick.sh 显示菜单：

======================================
    Claude Desktop 快速启动器
======================================

可用选项：
1. 启动默认实例
2. 选择现有实例
3. 创建新实例
4. 删除指定实例
5. 创建应用包装器（独立图标）
6. 恢复原始配置
7. 诊断问题
8. 修复包装器

命令行模式

# 启动或创建实例
./claude_quick.sh [实例名称]

# 管理命令
./claude_quick.sh list                 # 列出所有实例
./claude_quick.sh delete [实例]        # 删除实例
./claude_quick.sh wrapper [实例]       # 创建应用包装器
./claude_quick.sh diagnose             # 诊断问题
./claude_quick.sh fix                  # 修复包装器
./claude_quick.sh restore              # 恢复原始配置

💼 使用场景

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

# 创建工作实例
./claude_quick.sh work
# 使用工作账户登录，配置与工作相关的MCP服务器

# 创建个人实例
./claude_quick.sh personal
# 使用个人账户登录，配置个人MCP服务器

场景2：不同项目的配置

# 项目A - 文件系统和网络搜索MCP
./claude_quick.sh project-a

# 项目B - 数据库和API MCP
./claude_quick.sh project-b

# 开发环境 - Git和测试工具MCP
./claude_quick.sh dev

场景3：创建应用包装器

# 为工作实例创建独立的应用图标
./claude_quick.sh wrapper work
# 输入显示名称：Claude 工作

# 现在可以从Launchpad或Spotlight直接启动“Claude 工作”
# 它将在Dock中显示为“Claude 工作”而不是“Claude”
# 每个包装器都保持自己的登录状态和配置

📁 文件结构

~/.claude-instances/                    # 实例数据目录
├── work/                              # 工作实例
│   └── Application Support/Claude/
│       └── claude_desktop_config.json
├── personal/                          # 个人实例
│   └── Application Support/Claude/
│       └── claude_desktop_config.json
└── scripts/                           # 辅助脚本
    ├── restore.sh                     # 快速恢复配置
    └── list.sh                        # 列出所有实例

/Applications/                          # 应用包装器
├── Claude.app                         # 原始应用
├── Claude-work.app                    # 工作实例包装器
└── Claude-personal.app                # 个人实例包装器

🔧 故障排除

问题：应用包装器无法启动

解决方案：

# 1. 运行诊断
./claude_quick.sh diagnose

# 2. 修复包装器
./claude_quick.sh fix

# 3. 如果仍然不起作用，请重新创建
rm -rf /Applications/Claude-work.app
./claude_quick.sh wrapper work

问题：未找到Claude Desktop

解决方案：

1. 确保从claude.ai/download下载并正确安装了Claude Desktop。
2. 确认应用位于/Applications/Claude.app。
3. 运行./claude_quick.sh diagnose检查安装状态。

问题：实例配置丢失

解决方案：

# 恢复原始配置
./claude_quick.sh restore

# 检查备份文件
ls -la ~/Library/Application\ Support/Claude.backup.*

问题：图标显示问题

解决方案：

# 修复图标
./claude_quick.sh fix

# 或重新创建应用包装器
./claude_quick.sh wrapper [实例名称]

📊 命令参考

命令	描述	示例
./claude_quick.sh	显示交互式菜单	./claude_quick.sh
./claude_quick.sh [实例]	启动或创建实例	./claude_quick.sh work
./claude_quick.sh list	列出所有实例	./claude_quick.sh list
./claude_quick.sh delete [实例]	删除指定实例	./claude_quick.sh delete old
./claude_quick.sh wrapper [实例]	创建应用包装器	./claude_quick.sh wrapper work
./claude_quick.sh diagnose	诊断问题	./claude_quick.sh diagnose
./claude_quick.sh fix	修复包装器	./claude_quick.sh fix
./claude_quick.sh restore	恢复原始配置	./claude_quick.sh restore

🔒 安全注意事项

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

❓ 常见问题

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

Q: 聊天历史会在实例间同步吗？
A: 不会。不同的实例使用不同的账户，因此聊天历史不会同步。

Q: 如何备份实例配置？
A: 将~/.claude-instances/[实例名称]目录复制到其他位置即可备份整个实例配置。

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

🤝 技术支持

如果您遇到问题：

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

📄 许可证

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

---

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