源码解析:claude-desktop-multiple-windows-different-api 靠 7 个"踩坑所得"的逆向发现让 Claude Desktop 多开成为可能
源码解析:claude-desktop-multiple-windows-different-api 靠 7 个"踩坑所得"的逆向发现让 Claude Desktop 多开成为可能
claude-desktop-multiple-windows-different-api 是一个开源的 Claude Desktop 多开工具:让同一个桌面上同时运行多个 Claude Desktop 窗口,一个窗口走官方订阅,其余窗口各自接入不同的第三方 API(cc-switch 驱动),Windows 已实测可用、macOS 实验性支持。更难得的是,作者靠不断试错和逆向分析,找到了 7 个 Claude Desktop 官方文档从未提及的底层行为,并全部写进了不到 2000 行的 PowerShell + C# 源码里。本文带你逐条拆开这些"踩坑所得"的发现,看看多开为什么这么难、又为什么最后成了。
1 分钟看懂:项目能做什么,代码怎么组织
先建立整体印象,再进入细节:
| 能力 | 说明 |
|---|---|
| 官方 + 第三方同时运行 | 官方窗口保留订阅登录;其他窗口走 cc-switch 指定的第三方 API |
| 每窗口独立 API | 可为每个窗口指定供应商(直连其上游),或跟随 cc-switch 当前选择 |
| 窗口数量不限 | 每个窗口有独立数据目录、独立配色图标(桌面/任务栏/托盘)、独立任务栏按钮 |
| 会话共享 | 新会话、标题、置顶/星标、MCP 服务器在窗口间自动镜像 |
| 更新无忧 | 不拷贝、不修改官方应用,每次启动都从商店包动态解析安装路径 |
代码组织非常简洁,核心模块一目了然:
- claude-multi.ps1 —— 入口脚本,按
gui / install / add / launch / check等子命令分发 - src/Core.ps1 —— 核心逻辑:实例路径推导、启动、会话同步、后台代理(约 650 行,全文重点)
- src/CcSwitch.ps1 —— 只读访问 cc-switch 数据库,为每个窗口生成独立 profile
- src/ShellProp.cs —— C# P/Invoke 封装:窗口身份、图标、托盘重绘、SQLite 读取
- src/Icon.ps1 —— 本地读取已安装应用图标并 HSV 重绘生成配色图标
- src/Extras.ps1 —— 设置同步(置顶/MCP)与"同一会话双窗口"冲突预警
- src/Gui.ps1 —— WinForms 管理界面(Anthropic 风格,内置中文切换)
- run.vbs —— 无窗口启动垫片,桌面快捷方式的真正目标
- instances.json / palettes.json —— 实例与配色配置文件
7 个逆向发现:多开为何从"不可能"变成"可以"
以下 7 条发现按"踩坑顺序"讲解,前 3 条是数据目录之争,4~6 条是外观与系统集成,第 7 条是长期维护。
发现 1:所有窗口共用一份配置库,configLibrary 是"全局开关"
Claude Desktop 的第三方模式(3P)配置不在注册表,而在 %LOCALAPPDATA%\Claude-3p\configLibrary。cc-switch 把供应商 profile 写进这里,于是问题来了:所有读这份配置的窗口都会被强制进入 3P 模式——包括你的官方订阅窗口。
带 disableDeploymentModeChooser 字段的 profile 就像一个"全局开关",官方窗口下次启动也会中招。这正是多开的第一道坎:你还没多开,官方窗口就已经被"劫持"了。作者在 src/CcSwitch.ps1 的 New-DirectProfile 中为每个窗口单独生成一份带此字段的 profile,让"进入 3P"只影响目标窗口。
发现 2(死路):--user-data-dir 与 CLAUDE_USER_DATA_DIR 在 Windows 上无效
最直觉的多开方案是给每个窗口传不同的 --user-data-dir,或用环境变量 CLAUDE_USER_DATA_DIR。实测结果:
- 生产版会清除该环境变量;
- 在 3P 模式下会直接覆盖数据目录;
- 第二个 3P 窗口与第一个冲突后静默退出,连报错都没有。
这条死路的价值在于:它把"数据目录到底由什么决定"这个真正的问题暴露了出来。
发现 3(破局):3P 数据目录其实是从 %LOCALAPPDATA% 推导出来的
既然应用自己会覆盖传入的目录,那就骗它推导的"原料"。作者发现 3P 数据目录由 %LOCALAPPDATA% 环境变量派生,于是每个额外窗口启动前都注入一个私有目录:~\.claude-multi\<id>\Local,窗口自然获得完全独立的数据与 profile。
对应源码 src/Core.ps1 的两个函数:
Get-DataDir:推导每个实例真正的数据目录(官方实例指向APPDATA\Claude,3P 实例指向各自的私有目录);Get-FakeLocal:返回该实例的"假LOCALAPPDATA"。
而 src/Core.ps1 的 Invoke-Launch 展示了完整手法:临时改写 LOCALAPPDATA(顺带注入每窗口独立的 TZ 时区与 HTTPS_PROXY 代理),启动后在 finally 块里恢复原值,保证不污染 PowerShell 自身环境。这一招同时实现了多官方账号 + 每账号独立出口 IP + 时区对齐的防风控隔离。
发现 4:官方窗口隔离——给订阅一个"看不见的空 Claude-3p"
回到发现 1 的困境:官方窗口下次启动仍会读全局的 configLibrary。解法同样优雅,见 src/Core.ps1 的 Initialize-OfficialHome:
- 为官方窗口建一个私有
LOCALAPPDATA,其中Claude-3p目录为空——没有 3P profile,官方窗口就永远不会被强制切到第三方模式; - 私有目录里的
Claude和Packages用**目录联接(junction)**指回真实目录,登录态与缓存照常可用。
空目录 + 目录联接,两招就把官方订阅"物理隔离"了,且完全不修改官方应用一个字节。
发现 5:独立任务栏按钮与托盘图标——靠 P/Invoke 逐窗口改身份
Electron 有个"特性":所有窗口默认使用同一个 AppUserModelID,所以多开的窗口在任务栏上会合并成一个按钮,托盘里也是清一色的官方图标。
ShellProp.cs 的 196 行 C# 是这段最硬核的代码:
SetWindowIdentity(src/ShellProp.cs#L82-L91):通过SHGetPropertyStoreForWindow给单个窗口句柄写入独立的 AUMID、图标与显示名,覆盖 Electron 的进程级设置,从此每个窗口在任务栏各占一格;SetWindowIcon(src/ShellProp.cs#L98-L103):用WM_SETICON消息更换窗口大/小图标;SetLinkAumid(src/ShellProp.cs#L106-L115):给.lnk快捷方式也盖上同样的 AUMID,让"固定的任务栏按钮"与窗口归到同一组;TrayIcon.Apply(src/ShellProp.cs#L180-L195):枚举目标进程里的Electron_NotifyIconHostWindow隐藏窗口,用Shell_NotifyIcon的NIM_MODIFY逐个 ID 尝试重绘系统托盘图标和提示文字——相当于跨进程给别人的 Electron 应用"换皮肤"。
配套的 src/Core.ps1 Set-Link 则把每个桌面快捷方式指向 run.vbs 这个无窗口垫片:VBS 负责静默拉起 PowerShell,避免快捷方式一闪而过黑窗口。
发现 6:一个神秘的 Bug——图标不能放在 AppData 的 ClaudeMulti 目录下
这条没有任何文档可查,纯靠排查:资源管理器和任务栏对 AppData\*\ClaudeMulti 这类目录下的 .ico 文件只显示空白页,而放在其他任何目录都正常。
所以图标统一生成到 ~\.claude-multi\icons,并在 src/Core.ps1 特意留了一行注释警告后人:"不要移回 AppData*\ClaudeMulti,Explorer 从那里加载不了图标"。图标本身由 src/Icon.ps1 本地重绘:读取已安装应用自带的 Square310x310Logo 图,按 palettes.json 的 HSV 参数(或任意 #RRGGBB)重新着色,再打包成多尺寸 .ico(src/Icon.ps1#L74-L85)。仓库因此不分发任何 Anthropic 素材。
发现 7:更新无忧——每次启动都从 MSIX 包解析安装路径
很多多开工具靠拷贝/打补丁官方程序,一旦商店更新就全线失效。本项目反过来:
- src/Icon.ps1 的
Get-ClaudePackage每次都用Get-AppxPackage AnthropicPBC.Claude现查最新版本的安装位置; - src/Core.ps1 的
Invoke-Launch优先走 WindowsApps 的应用执行别名(2026-10 起直接CreateProcess包内 exe 会被拒,注释里完整记录了这次踩坑)。
不拷贝、不打补丁、不存版本号——官方更新多少次,工具照常工作。
多开之后:后台代理的三大"续命"机制
多开只是第一步,让多个窗口长期"像一台"才是难点。Claude Desktop 只在启动时读取会话与配置目录:没有文件监听、改 config.json 不触发重读、正式版还禁用了远程调试。作者的答案是一个常驻后台代理(src/Core.ps1#L610-L648 的 Invoke-Agent,每 2 秒巡检一次):
- 会话镜像 + 静默重启:会话文件按"最新写入者胜出"镜像到所有实例(src/Core.ps1#L448-L477);某窗口出现它"不认识"的新会话后,满足三个安全条件才在后台重启——非焦点窗口、45 秒内没写过会话文件、子进程没在烧 CPU(src/Core.ps1#L497-L518)。重启后的窗口以
SW_SHOWMINNOACTIVE最小化且不打扰地回来(src/ShellProp.cs#L51-L56);你正在用的窗口绝不被碰,只会收到带 "Reload now" 按钮的通知(背后注册了私有协议claudemulti://restart/<id>,见 src/Core.ps1#L378-L386)。 - 直接读 cc-switch 的 SQLite 库:通过 Windows 自带的
winsqlite3.dll只读查询供应商列表(src/ShellProp.cs#L125-L162),无需依赖 cc-switch 开着;降级链路依次尝试 python / sqlite3.exe(src/CcSwitch.ps1#L2-L21)。 - 双窗口冲突预警:每个窗口为每个会话各跑一个 Claude Code 进程(
--resume=<id>),两边同时发话会让记录交错分叉。代理扫描子进程命令行,发现同一会话在两个窗口存活且其一在烧 CPU 时,弹 Windows 通知提醒(src/Extras.ps1#L191-L213)。
动手体验:最快上手步骤
环境要求:Windows 11、PowerShell 5.1+、Microsoft Store 版 Claude Desktop(AnthropicPBC.Claude)、带 Claude Desktop 供应商的 cc-switch。
git clone https://gitcode.com/gh_mirrors/cl/claude-desktop-multiple-windows-different-api
cd claude-desktop-multiple-windows-different-api
.\claude-multi.ps1 install # 为 instances.json 中每个窗口生成图标和快捷方式
.\claude-multi.ps1 gui # 打开管理界面(或用桌面快捷方式)
之后按需添加窗口:
.\claude-multi.ps1 add -Id gem -Name "Claude Gemini" -Palette gemini -Provider <cc-switch供应商id>
.\claude-multi.ps1 launch -Id gem
.\claude-multi.ps1 check # 审计各实例出口 IP、机房/家宽属性、时区吻合度
也可以为窗口写死一份自定义 profile:instances.json 里加 "profile": "路径\\profile.json",格式参考 examples/profile.example.json。macOS 实验版在 macos/claude_multi.py(仅标准库,python3 macos/claude_multi.py gui 即可)。
小结:7 条发现背后的工程哲学
| # | 发现 | 一句话本质 |
|---|---|---|
| 1 | configLibrary 是全局 3P 开关 | 先搞清应用"认什么" |
| 2 | --user-data-dir 被生产版覆盖 |
直觉方案要实测证伪 |
| 3 | 数据目录派生自 %LOCALAPPDATA% |
骗原料而不是硬覆盖 |
| 4 | 空 Claude-3p + 目录联接隔离官方 |
用文件系统语义做隔离 |
| 5 | 逐窗口写 AUMID/图标/托盘 | 跨进程 P/Invoke 补齐 Electron 短板 |
| 6 | AppData\*\ClaudeMulti 下 .ico 空白 |
尊重系统怪异行为,绕开即可 |
| 7 | 每次从 MSIX 现查安装路径 | 不拷贝不补丁,天然抗更新 |
需要提醒的是:全部机制都依赖 Claude Desktop 的未公开行为,未来版本更新可能使其失效;官方窗口的隔离在其下次重启后生效;绕过本工具(开始菜单磁贴等)启动的官方窗口没有隔离。但正是这种"踩坑所得 + 源码注释留痕"的写法,让这个项目成为理解 Electron 应用行为与 Windows 系统集成细节的优质样本——每一行注释背后,都是一次失败的实验。