Codex Tools
Codex 账号切换、用量监控与 API 反代工具
下载 Codex Tools
Apple 芯片（M1/M2/M3）安装包（.dmg）
其他可用下载（3）
提示「无法验证开发者」怎么办？
首次打开若提示无法验证开发者，前往 系统设置 → 隐私与安全性，点击「仍要打开」即可。开源软件通常未购买 Apple 开发者签名，属正常现象。
点击「下载」将先到来源确认页，确认后开始下载。
关于 Codex Tools
Codex Tools 是一个面向多 Codex 账号场景的开源工具，提供桌面图形界面和命令行入口（ctc）。你可以通过它导入和备份 Codex 账号，查看 5 小时和 1 周窗口的用量及计划类型，并在不同账号间快速切换本机 Codex 的登录状态。内置的本地 OpenAI 兼容 API 反代服务可将账号池暴露为 /v1 接口，供 Cursor、ChatWise 等本地工具调用，并支持运行中账号轮换。此外还集成了 cloudflared，可生成公网访问地址。支持 macOS（Intel/Apple Silicon）和 Windows x64。
下载或信息有问题？告诉我们
风险提示
macOS 安装包可能未通过 Apple 公证，首次启动可能被系统拦截，需要手动放行或去除 quarantine 属性。工具会修改 ~/.codex 下的 auth.json 与 config.toml，并可能通过 cloudflared 将本地服务暴露到公网，请确认使用环境安全并提前备份配置。
适合谁用
- 使用多个 Codex 账号并需要频繁切换的开发者
- 需要监控 Codex 用量和账号计划的用户
- 希望通过本地 API 反代调用 Codex 账号的 AI 工具用户
- 想在 macOS 或 Windows 上通过图形界面管理 Codex 登录态的用户
- 需要把 Codex 账号池暴露为 OpenAI 兼容接口的团队或个人
不适合谁
- 不使用 Codex 或没有 Codex 账号的用户
- 只需要单一账号且无需切换、查看用量等功能的用户
- 需要 Linux 桌面客户端或服务端代理的用户（本工具安装包仅面向 macOS 和 Windows）
安装指南
根据你的系统选择对应安装包：
- macOS Apple Silicon (M系列)：下载
Codex.Tools_2.5.0_aarch64.dmg，双击打开后将Codex Tools.app拖入 Applications 文件夹。 - macOS Intel：下载
Codex.Tools_2.5.0_x64.dmg，操作同上。 - macOS 免安装版：也可下载
Codex.Tools_aarch64.app.tar.gz（Apple Silicon）或Codex.Tools_x64.app.tar.gz（Intel），解压后直接使用。 - Windows x64：下载
Codex.Tools_2.5.0_x64-setup.exe（安装向导）或Codex.Tools_2.5.0_x64_en-US.msi（MSI 安装器），双击运行并按照提示完成安装。
安装完成后，打开应用即可导入账号、查看用量和切换。
如需使用命令行入口，可在终端执行：
npm i -g @170-carry/ctc然后使用 ctc ui 打开桌面应用，或直接使用 ctc list、ctc switch 等命令。
首次运行常见问题：
- macOS 提示“无法打开来自身份不明的开发者”：在“系统设置”->“隐私与安全性”中点击“仍要打开”；或执行
xattr -d com.apple.quarantine /Applications/Codex\ Tools.app（如果应用在其他位置，请修改路径）。 - Windows SmartScreen 提醒：点击“更多信息”->“仍要运行”即可。
- CLI 安装后缺少原生包：如果使用 npm 安装时禁用了 optional dependencies，请重新执行
npm i -g @170-carry/ctc --include=optional。
常见问题
Codex Tools 是免费的吗？
是的，项目以 MIT 协议开源，你可以免费下载使用，也可以查看和修改源码。
支持哪些操作系统和架构？
支持 macOS（Apple Silicon 和 Intel）以及 Windows x64。macOS 请选择 aarch64（Apple Silicon）或 x64（Intel）的 dmg 文件；Windows 请选择 x64 的 exe 或 msi。
如何更新到新版本？
桌面应用支持自动更新；你也可以从 GitHub Releases 页面（https://github.com/170-carry/codex-tools/releases/latest）下载最新安装包手动覆盖。
需要先安装 Codex CLI 吗？
部分功能（如 `ctc login` 调用官方登录）依赖本机已安装 Codex CLI；如果只使用桌面 GUI 导入已有账号和切换，则不一定需要。建议提前安装 Codex 并完成至少一次登录。
工具会修改我的 Codex 配置文件，安全吗？
工具会读写 `~/.codex/auth.json` 和 `config.toml` 以实现账号切换和 API 反代，操作前会尝试备份。由于涉及账号凭据，建议自行备份配置文件，并在可信环境中使用。