为不同项目创建独立的 `CODEX_HOME` 和 `user-data-dir`,减少配置互相影响。
macOS · Windows · Codex 多开 · 第三方 Responses API
让每个 Codex 窗口都有自己的 API 配置。
Codex 多开助手可以创建多个隔离的 Codex 桌面窗口,并为每个窗口配置独立的 API Key、Base URL、模型和启动器。
为什么需要它
不用再靠命令行记住不同工作区。
通过表单填写 Base URL、API Key 和模型,不再手动编辑 `config.toml`。
每个 Profile 都会生成自己的启动器 App,像普通应用一样双击打开。
使用流程
从创建到打开,只保留必要步骤。
面向第一次配置的用户,默认继承已有 Codex 配置,并在关键位置给出测试和回退能力。
创建 Profile、填写 Provider、获取模型、测试接口、生成启动器并打开独立 Codex 窗口。
创建 Profile
命名新的工作区,选择是否继承默认 Codex 配置。
配置 Provider
填写第三方 Responses 兼容接口,或使用官方 OpenAI API Key。
测试并生成
测试 API 可用性,生成配置文件、本地密钥和启动器 App。
双击打开
从主界面或 Finder 启动对应 Codex 窗口。
模型选择
能获取模型列表就选择,获取不到就手动填。
很多第三方服务商提供 `/models` 接口。Codex 多开助手会尝试解析返回结果中的模型 ID,并给出可点击选择。服务商不支持时,不影响手动填写模型。
- 支持常见 `data`、`list`、`results` 返回结构。
- 只使用明确的字符串 `id` 作为模型 ID。
- 测试失败也允许继续生成,便于排查服务商兼容性。
本地安全
API Key 不进入诊断报告,也不写入启动脚本。
本地加密保存
API Key 保存在本机加密文件中,用于启动对应 Profile。
配置可恢复
每次写入 `config.toml` 前都会创建备份,出错后可恢复。
诊断可反馈
复制诊断信息时不会包含 API Key,方便在 Issues 中描述问题。
环境检查
先确认本机条件,再生成启动器。
App 会检查 Codex App、Codex 可执行文件、Node runtime、启动器目录和 Profile 目录。只有 CLI 缺失时通常仍可继续使用桌面多开功能。
查看完整使用说明
来自早期用户反馈
Windows 和 Mac Intel 已进入测试版。
根据 Linux.do 社区反馈,当前版本已补齐 Windows x64、macOS Intel 和 macOS Apple Silicon 三类安装包。
Windows x64 support
已适配 Windows 下的 Codex 检测、Profile 路径、启动器生成和第三方 Provider 配置,欢迎继续反馈真实环境问题。
查看 issue #2多账号隔离验证
验证不同 Profile 是否能保留独立 Codex 登录状态,并把账号隔离和 API 配置隔离讲清楚。
查看 issue #1v0.1.1 多平台测试版
按系统和芯片架构选择下载。
当前版本提供 macOS Apple Silicon、macOS Intel 和 Windows x64 三种安装包,支持官方 OpenAI API Key 和第三方 Responses 兼容接口。macOS 未签名版本可能需要手动解除 quarantine。
试用反馈、版本进展和常见配置问题会优先整理在这里。
xattr -dr com.apple.quarantine "/Applications/Codex 多开助手.app"
常见问题
分发试用前先说清边界。
为什么打开时 macOS 提示无法验证?
当前是未签名 MVP 测试版。正式公开分发前需要 Developer ID 签名和 notarization。
是否支持 Windows?
v0.1.1 已提供 Windows x64 测试包,包含 Windows 下的 Codex 检测、Profile 路径、启动和 Provider 配置适配。问题进展会记录在 issue #2。
Mac Intel 芯片应该下载哪个包?
Intel 芯片 Mac 下载 `Codex-Multi-Launcher-0.1.1-x64-mac.zip`,M 系列 Mac 下载 `Codex-Multi-Launcher-0.1.1-arm64-mac.zip`。
是否支持不同 Codex 账号同时登录?
多 Profile 已经隔离 `CODEX_HOME` 和 `user-data-dir`,但账号登录态还需要更多真实环境验证。多账号隔离进展会记录在 issue #1。
第三方中转站都能用吗?
不保证。MVP 只支持 Responses 兼容接口,服务商需要真正支持 Codex 使用的 Responses API。
能接入智谱、DeepSeek、通义或 Kimi 吗?
可以先测试,但前提是服务商提供 OpenAI/Responses 兼容入口。只支持原生 API 或只支持 Chat Completions 的接口不一定可用。配置时重点确认 Base URL 是否通常以 `/v1` 结尾、API Key 是否支持兼容接口、模型 ID 是否是接口实际接受的名称。
反馈问题时需要提供什么?
请提供 macOS 版本、Codex App 版本、服务商名称、Base URL 是否以 `/v1` 结尾、Provider 测试错误信息,以及 App 内复制的诊断报告。