Codex Tools

一个基于 React + Tauri 的桌面工具，用来管理多个 Codex 账号，并提供本地 API 反代能力：

• 查看账号用量
• 快速切换和启动 Codex
• 本地 /v1 反代
• cloudflared 公网访问

仓库地址：https://github.com/170-carry/codex-tools

更新日志

更新日志

Cursor API反代功能提示

1. 通过 Cursor 官网 下载并安装 Cursor。

2. 在 Cursor 中，点击2026-02-03_16-52-37图标，单击Cursor Settings，选择Models页面。

3. 开启 OpenAI API Key，填入您的 API Key。

4. 开启 Override OpenAI Base URL，填入可被 Cursor 访问的地址。

5. 在Add or search model文本框中，输入Coding Plan支持的模型中的模型名称，点击Add Custom Model。

6. 添加模型名称建议使用 gpt-5.4；同时兼容 gpt-5-4 别名

Cursor 接入注意事项

• ChatWise、本地脚本、curl 这类本机直连客户端，可以直接使用本地 Base URL，例如 http://127.0.0.1:8787/v1
• Cursor 不建议填写 127.0.0.1、localhost、192.168.x.x、10.x.x.x 这类本地或私网地址
• 如果在 Cursor 里看到 ssrf_blocked 或 connection to private IP is blocked，通常不是代理本身报错，而是 Cursor 的模型提供方拦截了私网地址
• 给 Cursor 使用时，请改用以下任意一种地址：
• 使用应用内 cloudflared 生成的公网 Public URL
• 使用“远程 Linux 反代”部署出来的公网服务器地址
• 使用你自己的公网域名反向代理到本地或远程反代

应用截图

解决codex-tools app 已损坏的方案

https://zhuanlan.zhihu.com/p/135948430

省流:

sudo spctl --master-disable

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

快速启动（本地开发）

1) 环境准备

• Node.js 20+
• Rust stable
• macOS 或 Windows（优先支持 macOS）

2) 安装依赖

npm install

3) 启动桌面应用

npm run tauri dev

就这三步。

主要功能

1. 账号管理

• 支持 OAuth 登录导入
• 支持上传单个或多个 .json 文件批量导入，也支持回导入导出的 accounts.json 备份
• 支持直接读取文件夹下的全部 .json 文件
• 导入结束后会恢复当前本机登录态，不覆盖你正在使用的账号

2. 用量查看与智能切换

• 展示每个账号的 5h、1week 用量窗口和计划类型
• 支持手动刷新，也会定时自动刷新
• 支持按余量排序和智能切换到更合适的账号

3. 切换账号并联动本机环境

• 一键切换账号并启动 Codex
• 找不到桌面应用时自动回退到 codex app
• 可选同步 Opencode OpenAI 授权
• 可选在切换后重启已选编辑器

4. API 反代

• 本地提供 OpenAI 兼容的 /v1 接口
• 使用已登录的 Codex 账号作为上游能力来源
• 支持固定端口、自定义端口、固定 API Key 和手动刷新 API Key
• 按账号余量自动挑选可用账号进行转发
• 可设置应用启动时自动启动 API 反代
• 可作为 CC Switch 的 Codex 自定义 provider 上游，按 responses 协议接入

5. 公网访问与桌面能力

• 集成 cloudflared，可将本地反代暴露到公网
• 支持快速隧道和命名隧道，可选 HTTP/2
• 支持后台驻留、状态栏菜单、应用内更新和多语言界面

API 反代详细链路见 docs/api-proxy.md。

打包与发布（简版）

本项目已配置 GitHub Actions 自动发布（mac 双架构 + Windows）。

触发发布：

git tag v0.1.3
git push origin v0.1.3

查看：

• 代码仓库: https://github.com/170-carry/codex-tools
• 版本发布: https://github.com/170-carry/codex-tools/releases

目录说明

• 前端：src/
• Tauri / Rust：src-tauri/
• 发布流程：.github/workflows/release.yml

Star History

License

MIT，详见 LICENSE。

Codex Tools 快速上手指南

Codex Tools 是一款基于 React + Tauri 的桌面应用，旨在高效管理多个 Codex 账号，并提供本地 API 反代及公网访问能力。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：优先支持 macOS，同时也支持 Windows。
• Node.js：版本需为 20 或更高 (Node.js 20+)。
• Rust：需安装稳定版 (Rust stable)。

提示：国内开发者若下载 Rust 或 Node 依赖较慢，建议配置国内镜像源（如清华源、中科大源）进行加速。

2. 安装步骤

克隆项目仓库并安装依赖，具体命令如下：

# 克隆仓库（如果尚未克隆）
git clone https://github.com/170-carry/codex-tools.git
cd codex-tools

# 安装前端依赖
npm install

3. 基本使用

完成依赖安装后，即可启动桌面应用进行开发和测试：

# 启动 Tauri 桌面应用
npm run tauri dev

核心功能速览：

• 账号管理：支持 OAuth 登录或通过 .json 文件批量导入账号，自动查看用量并智能切换。
• API 反代：应用启动后，本地将提供 OpenAI 兼容的 /v1 接口（默认端口可配置），自动利用已登录的 Codex 账号作为上游。
• Cursor 集成：
  • 对于本地直连工具（如 curl），可直接使用 http://127.0.0.1:8787/v1。
  • 对于 Cursor 编辑器，由于安全限制无法直接访问本地地址，请使用应用内集成的 cloudflared 生成公网 URL，或部署远程反代地址填入 Cursor 设置中。