为什么 Codex 多账号使用容易变得繁琐
开发者常常把个人项目、公司工作区和获准使用的客户项目放在不同 ChatGPT 账号中。Codex Desktop 与 Codex CLI 会读取一个当前认证文件,手动更换身份往往需要退出登录、打开浏览器、重新完成认证,再确认当前到底使用了哪个账号。
Codex Account Switcher 为每个已保存身份保留相互独立的本地认证快照。在切换前,菜单直接显示当前账号、每周剩余用量与重置时间。
请只使用你本人拥有或获准访问的账号。应用提供本地账号选择流程,不会改变 OpenAI 账号权限、账单、工作区策略或用量限制。
开始前需要准备什么
- 搭载 Apple Silicon、运行 macOS 14 Sonoma 或更高版本的 Mac。
- Codex Desktop、Codex CLI,或同时安装两者。
- 至少两个可以使用 Codex 的 ChatGPT 账号。
- 从 GitHub Releases 下载的最新签名并经过 Apple 公证的 Codex Account Switcher DMG。
把应用移入“应用程序”并启动一次。切换器会出现在 macOS 菜单栏中,也可以设置为登录 Mac 后自动启动。
第一步:一次保存每个 Codex 账号
保存 Codex 当前正在使用的账号
打开管理账号并导入当前 Codex 登录状态。应用会读取当前配置中的身份,并以用户专属权限保存本地快照。
添加另一个个人、工作或客户账号
选择添加账号。切换器会在新的本地配置目录中启动标准 Codex 登录流程,因此添加账号时不会覆盖当前正在使用的配置。完成浏览器登录后,为账号设置清晰名称。
对每个获准使用的身份重复这一过程。菜单会把所有已保存账号放在一起,并用整行高亮标记当前账号。
第二步:比较 Codex 每周用量
开始长时间 Codex 任务前打开菜单。每个账号行都会显示每周剩余百分比与对应重置时间。成功获取的用量会缓存在本地,刷新过程中继续显示,拿到新数据后再更新。
这些信息帮助你在切换前做决定。应用不会推荐账号,也不会自动轮换配置;最终选择始终由你完成。
第三步:切换当前 Codex 账号
- 选择一个当前没有高亮的已保存账号。
- 阅读确认页面中关于 Codex Desktop 与 CLI 的影响说明。
- 确认切换。
- 应用依次保存当前配置、激活所选认证、验证所选身份,并重新打开 Codex Desktop。
整个操作按明确顺序执行。任一阶段失败时,切换会立即停止并显示原始错误,方便准确定位问题发生的位置。
Codex Desktop 与 CLI 会发生什么
Codex Desktop 会在确认切换后关闭并重新打开。Desktop 中正在运行的任务可能在交接时停止,因此建议在开始重要工作前完成切换。
已经运行的 Codex CLI 进程会保留此前加载的状态。切换器不会终止它们。需要让终端使用新账号时,请启动一个新的 Codex CLI 进程。
账号配置保存在哪里
Codex 当前认证文件仍位于 ~/.codex/auth.json。切换器保存的账号配置与元数据位于 ~/Library/Application Support/Codex Account Switcher/。
应用完全在本机运行,账号目录仅供当前用户访问,也不使用账号代理、流量路由、云端配置同步或自动账号轮换。删除非当前账号时,只会删除切换器中的本地副本,不代表撤销所有服务端会话。
选择适合你的多账号方式
当一个 Codex Desktop 实例需要在某个时刻使用一个明确身份时,菜单栏切换器会很合适。如果需要让多个 Codex 进程同时使用不同账号,分别设置 CODEX_HOME 或使用隔离的应用环境可能更适合。
Codex Account Switcher 专注于前一种工作流:用量清晰可见、切换由用户手动确认、没有后台账号路由。
开源 macOS 工具
让每个获准使用的 Codex 账号始终一步直达。
下载已签名的 Apple Silicon DMG,或在 GitHub 查看 Swift 源码与产品设计文档。