Claude Code 多环境运行

同一个项目目录里，终端 A 继续用默认 Claude，终端 B 走公司网关，两者同时运行、互不干扰。这是我做 PathMux 想解决的问题。

为什么做 PathMux

我自己有 Claude Code 的登录账号，平时直接运行 claude 就能用；公司项目则要求走指定网关。同事常用 cc-switch 在配置之间切换，但我需要的不只是切换：我想在同一个项目里同时保留原来的登录环境和公司网关。

临时设置环境变量，关掉终端就得重新来；直接改 settings.json，又可能影响另一套配置。PathMux 把它们保存为独立的「环境」。配置一次后，原来的 claude 照常使用，网关环境用 claude 环境名 启动。

下面按下载 → 安装 → 配置 → 启动的顺序操作。安装包版本以下载时的发布页面为准。

1. 先确认 Claude Code 已安装

PathMux 只负责管理 Claude Code 的环境，本身不包含 Claude Code。还没装的读者先按 Claude Code 官方安装文档 完成安装。打开终端运行 claude，确认它能正常启动，再继续下面的步骤。

2. 下载最新正式版安装包

打开 PathMux 最新正式版下载页。这个链接会自动跳到当前最新正式版，不用在列表里翻。进入后展开 Assets。

下面的 <版本号> 是占位符，下载时对应 Assets 里真实的文件名：

• macOS（Apple Silicon 或 Intel）：选择 PathMux_<版本号>_universal.dmg
• Windows 64 位：选择 PathMux_<版本号>_x64-setup.exe
• Windows 64 位也可以选 MSI：PathMux_<版本号>_x64_en-US.msi（EXE 和 MSI 二选一即可）

.sig、latest.json、.app.tar.gz 和 Source code 压缩包都不是首次安装用的程序。

（截图中的版本号只是拍摄时的状态，下载时以你打开的页面为准）

3. 安装并打开

macOS
双击下载的 .dmg，把 PathMux 拖进「应用程序」，再从「应用程序」打开。首次打开如果系统提示无法验证开发者，先确认文件来自上述 GitHub Releases 页面，再到「系统设置 → 隐私与安全性」选择「仍要打开」。可参考 Apple 官方说明。

Windows
双击 x64-setup.exe 按向导安装；如果选的是 .msi，双击安装即可。弹出「Windows 已保护你的电脑」时，先核对文件来自 GitHub Releases，确认后点「更多信息」→「仍要运行」。无法确认来源时不要安装。

4. 创建一个网关环境

打开 PathMux，进入「环境」→「新建」。

（截图中的地址和 Key 只是输入框示例，不要照抄）

依次填写：

1. 环境名称：例如 corp。保存后启动命令就是 claude corp，名称创建后不能直接改名。
2. 环境类型：选择「网关环境」。
3. ANTHROPIC_BASE_URL 与 API Key：按你的网关提供方给出的值填写。
4. 模型映射：如果网关要求把 Opus / Sonnet / Haiku 映射到它提供的模型，按实际可用模型填写。

点右上角「保存更改」。保存后重新打开一个终端窗口，让终端读取新接入的命令。

5. 在同一项目目录里同时启动

macOS 用 zsh 或 bash，Windows 用 PowerShell（系统自带的 Windows PowerShell，或 PowerShell 7 及以上版本）。如果用 Windows Terminal，请选 PowerShell 标签页，不要选「命令提示符」。

分别打开两个终端，进入同一个项目目录：

claude          # 终端 A：原来的默认 Claude
claude corp     # 终端 B：刚创建的公司网关环境

corp 换成你在第 4 步保存的实际名称。两个命令分别决定各自会话的配置。PathMux 只负责创建和维护启动配置，网关地址、Key 与服务可用性由你的网关提供方负责。配置完成后，桌面应用不需要一直开着。

两个终端都能正常对话且互不影响，就说明配置成功了。