Appearance
Codex 反代工具 codex-tools 全流程使用教程
1. 简短结论
核心要点：
- codex-tools 是一个 Codex API 反代工具，比 CLIProxyAPI 更方便
- 支持开机自启动，后台挂载运行
- 支持 5.5、5.4、5.4-mini 等模型
- 支持账号管理、用量查看、智能切换
- 可将本地反代暴露到公网，支持固定端口、自定义 Key
2. 工具简介
codex-tools 是一款反代 Codex API 的桌面工具，开机自启挂后台即可使用，比命令行工具更简单易用。
支持功能：
- OAuth 登录导入
- 批量导入 json 文件
- 用量查看与智能切换
- API 反代
- 公网访问（集成 Cloudflare Tunnel）
3. 主要功能详解
3.1 账号管理
- OAuth 登录导入：支持官方账号一键登录
- 批量导入：支持上传单个或多个 .json 文件
- 文件夹导入：支持直接读取文件夹下的全部 .json 文件
- 备份恢复：支持导入/导出 accounts.json 备份
- 不覆盖原则：导入结束后恢复当前本机登录态，不覆盖正在使用的账号
3.2 用量查看与智能切换
- 每个账号的 1h、1week 用量窗口和计划类型
- 支持手动刷新
- 支持定时自动刷新
- 支持按余量排序
- 支持智能切换到更合适的账号
3.3 切换账号并联动本机环境
- 自动切换账号并启动 Codex
- 找不到桌面应用时自动回退到 Codex app
- 可选同步 OpenCode OpenAI 授权
- 可选在切换后重启已选编辑器
3.4 API 反代
- 供 OpenAI 兼容的 /v1 接口
- 使用已登录的 Codex 账号作为上游能力来源
- 支持固定端口、自定义端口
- 支持自定义 API Key
- 支持手动刷新 API Key
- 按账号余量自动挑选可用账号进行转发
- 可设置应用启动时自动启动 API 反代
- 可作为 CC Switch 的 Codex 自定义 provider 上游，按 responses 协议接入
3.5 公网访问与桌面能力
- 集成 Cloudflare Tunnel，可将本地反代暴露到公网
- 支持快速隧道和命名隧道
- 可选 HTTP/2
- 支持后台驻留
- 支持状态栏菜单
- 支持应用内更新
- 支持多语言界面
4. 安装步骤
4.1 下载工具
访问 GitHub 搜索 codex-tools 或直接访问：
https://github.com/codex-tools4.2 安装
- 下载对应系统的安装包（Windows/macOS/Linux）
- 运行安装程序
- 首次启动完成初始配置
4.3 配置开机自启
- 在设置中开启「开机自启」
- 工具将后台常驻
4.4 导入账号
- 点击「导入账号」
- 选择登录方式：
- OAuth 登录（官方账号）
- 导入 json 文件（批量导入）
- 等待导入完成
5. 配置 API 反代
5.1 基本设置
- 打开「API 反代」设置
- 配置端口（默认 8080）
- 设置 API Key
- 开启「自动选择可用账号」
- 启用「启动时自动开启反代」
5.2 高级设置
- 固定账号：指定使用某个账号
- 智能切换：按余量自动切换
- 刷新频率：设置自动刷新间隔
5.3 对接 CC Switch
- 在 CC Switch 中添加自定义 provider
- 选择 Codex Tools 作为上游
- 配置接口地址：
http://localhost:端口/v1 - 填入 API Key
6. 使用示例
6.1 对接 Claude Code
json
{
"provider": "openai-compatible",
"name": "codex",
"baseURL": "http://localhost:8080/v1",
"apiKey": "your-api-key"
}6.2 对接 Cursor/Windsurf
- 打开 IDE 设置
- 找到 API 配置
- 选择「自定义 API」
- 填入地址和 Key
6.3 查看用量
- 在工具主界面查看各账号用量
- 点击「刷新」手动更新
- 按余量排序查看可用账号
7. 常见问题
Q1：端口被占用
解决： 更换为其他端口，如 8081、8888 等
Q2：账号切换后 IDE 连接失败
解决： 重启 IDE 或重新连接 API
Q3：用量刷新不及时
解决： 在设置中缩短刷新间隔
Q4：需要代理吗
解决： 国内可能需要代理访问 Codex 官方
8. 相关链接
作者：Niaoyu发布时间：2026-05-10（4小时前）来源：嘿市社区免责声明：本文为用户投稿整理，版权归原作者所有。