简体中文 · English
在 macOS 上管理和切换 Codex 账号与 API Key。
Codex Account Manager(CAM)是一个本地 macOS 应用,用于管理 ChatGPT 账号和 OpenAI API Key,并查看 Codex 返回的账号额度。应用提供菜单栏入口和独立主面板。
当前版本要求 Codex 使用文件凭据存储,并仅管理官方账号和官方 API Key。
截图来自演示模式,账号与额度为模拟数据。
- 通过浏览器或设备代码登录 ChatGPT 账号;新账号登录在独立的临时 Codex 目录中完成。
- 添加 OpenAI API Key,在已保存的账号与 API Key 之间切换。
- 当前登录直接显示为“使用中”;切换前自动备份当前文件凭据。
- 优先显示账号提供的名称,没有名称时显示邮箱,也可以设置本地别名。
- 对已保存的账号重新登录时,核对账号与工作区身份。
- 将 Codex 返回的会员类型归类显示为
Free、Plus、Pro、Team或Unknown;实际订阅名称以 ChatGPT 设置为准。 - 显示服务端返回的额度周期、剩余比例、重置时间和积分等信息。
- 手动刷新当前登录的额度;其他账号显示上次获取的结果。
- 为 API Key 配置独立的 Admin API Key 后,显示本月费用、输入/输出 Token、缓存输入 Token 和生成请求数;填写项目 ID 后还可查看模型速率上限。
- API Key 的计费与 ChatGPT 额度分开,本应用不显示 API Key 余额。
- 菜单栏和主面板均可切换配置;主窗口打开时显示程序坞图标。
- 支持浅色、深色与跟随系统外观,以及开机自启和静默启动。
- 提供账号搜索、面板快捷键和本地诊断日志。
- 账号与 API Key 卡片默认展示概览,可展开查看详情;刷新期间显示加载动画。
- 操作提示在顶部显示并自动收起,待切换目标以独立提示卡持续展示。
- 可配置 Codex 目录、应用数据目录和会话历史分组。
- 在“关于”页面手动检查 GitHub 上的最新正式版本,并打开发布页面下载。
Codex Account Manager
├─ 登录新账号:临时 Codex 目录 → 官方登录 → CAM 本地凭据
├─ 备份当前登录:Codex Home/auth.json → CAM 本地凭据
└─ 切换登录:所选凭据 → Codex Home/auth.json
Codex 使用期间可能刷新令牌,CAM 会在切换前重新保存当前文件凭据。账号登录和 API Key 登录在同一时刻使用其中一种;添加配置后不会自动切换。
若切换失败,CAM 只在能够确认当前文件仍是本次写入的内容且原凭据存在时尝试恢复。切换前请结束其他 Codex CLI 会话,切换期间不要重新启动 Codex。
- macOS 13 或更高版本。
- 已安装 Codex CLI。
- 从源码构建需要 Xcode;运行应用不需要 Python。
从 GitHub Releases 下载 DMG,打开后将 Codex Account Manager.app 拖到“应用程序”文件夹。
发行包使用临时签名,未经过 Apple 开发者签名或公证。替换旧版本前,请先从菜单栏退出 CAM。
首次打开如果提示无法验证开发者,请先确认安装包来自可信来源,然后选择以下一种方式:
-
尝试打开应用后,进入“系统设置 → 隐私与安全性”,找到 CAM 并点击“仍要打开”。详见 Apple 的说明。
-
将应用拖入“应用程序”文件夹后,在“终端”执行:
xattr -dr com.apple.quarantine "/Applications/Codex Account Manager.app" open "/Applications/Codex Account Manager.app"
终端命令会移除该应用的下载隔离标记,跳过相应的首次来源检查;它不会为应用补上开发者签名或公证。如果应用安装在其他位置,请将命令中的路径替换为实际路径。
git clone https://github.com/StarRain/Codex-Account-Manager.git
cd Codex-Account-Manager
sh scripts/build.sh
open "dist/Codex Account Manager.app"也可以在 Xcode 中打开 CodexAccountManager.xcodeproj,选择 CodexAccountManager 方案构建运行。
安装 create-dmg(brew install create-dmg)后,运行 sh scripts/build-dmg.sh 可将构建好的应用打包为 DMG 安装包。
脚本生成的应用使用本地临时签名,未经过 Apple 开发者签名或公证。如果旧版 CAM 正在运行,请先从菜单栏退出,再打开新版。
- 打开主面板,查看当前使用中的账号或 API Key。
- 选择“登录新账号”或“添加 API Key”,按提示完成添加。API Key 保存时不会验证有效性。
- 在主面板或菜单栏中选择已保存的配置,切换前 CAM 会备份当前登录。
- 如果 Codex 桌面版正在运行,可以选择立即重启或等它退出后再切换。
- 点击“刷新额度”可重新查询当前 ChatGPT 登录;凭据失效时可对已保存的账号选择“重新登录”。
- 展开 API Key 卡片详情,点击“配置查询”,填写 Admin API Key,再选择“保存并查询”。项目 ID 和 API Key ID 可选;留空时明确显示整个组织的统计。普通调用密钥不能替代管理员密钥。
浏览器已经登录其他账号时,可以关闭自动打开浏览器,复制登录链接到其他浏览器或无痕窗口。设备代码登录需要在 ChatGPT 安全设置或工作区权限中启用。
API 用量按 UTC 自然月统计。费用来自官方 Costs API,Token 和请求数来自 Completions Usage API,项目限额来自 Project Rate Limits API;服务端数据可能延迟。刷新失败时保留并标注本月上次结果,跨月不会把上个月的结果当成本月数据。模型速率上限不代表剩余次数。更换调用密钥后需重新配置查询范围。
| 快捷键 | 操作 |
|---|---|
⌘1 / ⌘2 / ⌘3 |
打开全部、官方账号或官方 API Key 页面 |
⌘, / ⌘[ |
打开设置 / 返回账号页面 |
⌘F |
聚焦账号搜索框 |
⌘N |
登录新账号;在 API Key 页面添加 API Key |
⌘R |
刷新当前状态 |
⌘W / ⌘M |
关闭 / 最小化主面板 |
⌘A / ⌘C / ⌘V / ⌘X |
全选 / 复制 / 粘贴 / 剪切 |
Return / Esc |
在配置弹窗中保存 / 取消 |
搜索、新建和刷新快捷键仅在 CAM 面板的相应页面中生效。
账号和 API Key 使用同一个 Codex Home。开启“统一 Codex 会话历史”后,CAM 会在符合条件时保留当前的官方共享服务商分组,不修改现有会话文件。
该设置不会迁移其他服务商分组中的旧会话,也不会合并不同账号的云端会话。
- 应用数据默认存放在
~/.cam:账号信息位于profiles.json,凭据位于credentials/,诊断日志位于diagnostics.log。 - 凭据文件未加密;凭据目录权限为
0700,文件权限为0600。请勿提交或分享这些文件。 - 用量查询的 Admin API Key 单独存放在
credentials/<配置 ID>.admin.json,不会写入 Codex 登录文件;仅发送至官方api.openai.com的只读查询接口。移除查询配置会删除对应管理员密钥,迁移应用数据目录时会一并复制。 - Codex 的文件凭据默认位于
~/.codex/auth.json。CAM 启动时读取自身环境中的CODEX_HOME,也可在设置中手动指定目录。 - 从 Finder 启动的应用不一定能继承仅在终端中设置的环境变量;桌面版和 CLI 需要使用相同的 Codex Home 才能共享登录。
- 账号授权使用临时目录,完成或取消后会清理;异常退出时系统临时目录中可能残留文件。
keyring、auto、ephemeral凭据模式,以及无法安全识别的环境变量、组织限制或 OpenAI 地址,会阻止 CAM 切换。详情见 OpenAI 登录与凭据存储说明。- 本应用依赖 Codex 当前的凭据文件格式,并非 OpenAI 提供的多账号切换接口;真实账号和桌面版的完整切换与重启流程仍需在目标环境验证。
运行测试:
xcodebuild -project CodexAccountManager.xcodeproj -scheme CodexAccountManager -destination 'platform=macOS' test使用模拟数据预览,不读取或修改真实登录:
open -n "dist/Codex Account Manager.app" --args --demo
open -n "dist/Codex Account Manager.app" --args --demo --dark测试使用临时 Codex Home、模拟凭据和本机模拟服务。测试夹具及图标生成脚本需要 Python 3;图标源文件位于 assets/cam-app-icon-trimmed.png。
- Codex:OpenAI 的 Codex 工具。
欢迎通过 Issue 反馈问题或提交 Pull Request。涉及账号切换、凭据存储或登录流程的变更,请附上验证方式。
本项目基于 MIT License 开源。
CAM 是社区项目,与 OpenAI 无官方隶属或背书关系。
