企业官网建设流程全解析

Codex Tools 是一款面向多 Codex 账号场景的开源桌面工具，集Codex 账号快捷切换、用量监控、API 反代于一体，并支持多语言界面。本教程用 5 步带你从零完成 macOS / Windows 安装，快速实现首次 Codex 账号切换。

第一步：获取 Codex Tools 安装包

Codex Tools 提供两种使用形态，可按需选择：

Releases 中提供三个平台包：macOS Apple Silicon（arm64）、macOS Intel（x86_64）和Windows x64。按你的系统架构选择对应版本即可。

CLI 详细命令可参考 npm/ctc/README.md，不想全局安装时也可直接运行：

npx @170-carry/ctc list --json

第二步：安装应用并完成首次启动

macOS 安装

1. 将Codex Tools.app拖入「应用程序」文件夹；
2. 首次打开如提示"已损坏"或"无法验证开发者"，在终端执行以下命令移除隔离属性：

sudo xattr -r -d com.apple.quarantine /Applications/Codex\ Tools.app

Windows 安装

双击安装包，按向导完成安装。若任务栏左侧组件与 Windows 天气小组件冲突，可在设置页打开任务栏设置并关闭天气小组件。

首次启动：额度显示引导

首次打开新版时，Codex Tools 会弹出额度显示引导，让你选择如何查看账号剩余额度：

• macOS：可独立开启"文字额度栏"与五种紧凑额度图标样式，之后随时在设置中调整：

• Windows：可选择把额度显示在任务栏左侧、右侧或系统托盘（至少启用一种），默认口径为"一周剩余"：

完成引导后，额度信息就会常驻状态栏/任务栏，随时掌握账号余量。

第三步：导入你的第一个 Codex 账号

打开应用的「账号」页，点击右上角添加账号，支持三种导入方式：

1. OAuth 登录导入：调用官方codex login流程，登录后自动导入；
2. 上传账号文件：单个/多个.json账号文件，或导出的accounts.json备份；
3. 选择文件夹：批量读取目录中的所有账号文件。

也可以在终端里用 CLI 完成同样的事：

ctc login --label work # OAuth 登录并导入 ctc import ./auth.json # 导入本地账号 JSON

导入完成后，Codex Tools 会保留你机器上当前的登录状态，不会覆盖正在使用的账号，可以放心操作。导入相关界面见src/components/accounts/import/目录下的组件。

第四步：查看用量并完成首次账号切换

导入后先刷新一次用量，界面上会展示每个账号的关键信息：

• 5 小时额度与每周额度的剩余百分比，以及重置时间；
• 账号计划类型标签：PRO、PLUS、TEAM、FREE；
• 账号状态：可用 / 使用中 / 已耗尽 / 授权异常。

确认目标账号后，点击该行的切换按钮即可完成首次切换；也可以直接点智能切换，让工具自动挑选余量最合适的账号。切换的本质是把~/.codex/auth.json和~/.codex/config.toml指向目标账号，并优先启动新版 ChatGPT App（兼容旧 Codex App 与codex app回退）。

CLI 用户一条命令即可自动选号并启动：

ctc switch --best --launch

第五步（进阶）：开启 API 反代，接入其他工具

如果你有多个 Codex 账号、想让 Cursor、CC Switch、本地脚本等工具共用账号池，可以启用本地 API 反代：

1. 打开「API 反代」面板，确认端口（默认8787）；
2. 点击启动 API 反代；
3. 复制生成的Base URL（http://127.0.0.1:8787/v1）和sk-...API Key；
4. 在客户端中填入这两个参数即可。

反代会自动从账号池里轮换可用账号，支持平均、逐个与账号优先级策略，运行中随时切换；面板还提供「切到本机反代 / 恢复正常地址」一键绑定 Codex App/CLI。需要公网访问时可再集成 cloudflared 快速隧道。

更完整的反代说明见 docs/api-proxy.md 和 docs/codex-cli-config.md。

常见问题 FAQ

总结与延伸阅读

5 步回顾：下载安装包 → 首次启动设置额度栏 → 导入账号 → 刷新用量并切换 → 按需开启 API 反代。日常使用建议：新增账号后先刷新一次用量，额度不足时优先切到余量更高的账号。

• 快速上手指南：how to use.md
• 项目说明与命令参考：README.md
• API 反代详解：docs/api-proxy.md
• 账号页前端实现：src/components/accounts/
• 反代后端实现：src-tauri/src/proxy_service/

装好 Codex Tools 后，多账号管理、用量监控与 API 反代一站式搞定，祝你切换顺畅、额度充足！