Codex Tools v1.5.4 超详细教程 - 多账号管理 + API 反代完整指南（2026 最新版）

步骤 1：访问发布页面#

打开浏览器访问：

• GitHub Releases：https://github.com/170-carry/codex-tools/releases

步骤 2：下载对应版本#

macOS 用户：

• Intel 芯片：下载 Codex_Tools_x64.dmg 或 Codex_Tools_x64.app.tar.gz
• Apple Silicon (M1/M2/M3)：下载 Codex_Tools_aarch64.dmg 或 Codex_Tools_aarch64.app.tar.gz

Windows 用户：

• 下载 Codex_Tools_x64-setup.exe 或 Codex_Tools_x64.zip

步骤 3：安装应用#

macOS：

1. 双击 .dmg 文件
2. 将 Codex Tools.app 拖拽到「应用程序」文件夹
3. 如果提示”已损坏”，执行以下命令修复：

1
sudo spctl --master-disable
2
sudo xattr -r -d com.apple.quarantine /Applications/Codex\ Tools.app

Windows：

1. 双击 .exe 安装包
2. 按照安装向导完成安装
3. 或在开始菜单找到应用

步骤 4：首次启动#

1. 打开「应用程序」文件夹（macOS）或开始菜单（Windows）
2. 找到并打开 Codex Tools
3. 首次启动可能会提示确认，点击”打开”即可

步骤 1：安装前置环境#

安装 Node.js 20+：

1
# macOS (使用 Homebrew)
2
brew install node@20
3

4
# Windows
5
# 访问 https://nodejs.org/ 下载安装包
6

7
# 验证安装
8
node --version  # 应显示 v20.x.x

安装 Rust：

1
# macOS/Linux
2
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
3
source $HOME/.cargo/env
4

5
# Windows
6
# 访问 https://rustup.rs/ 下载 rustup-init.exe
7

8
# 验证安装
9
rustc --version  # 应显示 rustc 1.x.x

安装 pnpm：

1
npm install -g pnpm
2

3
# 验证安装
4
pnpm --version  # 应显示 9.15.9+

步骤 2：克隆项目#

1
# 选择安装目录
2
cd /tmp  # macOS/Linux
3
# 或 D:\tools  # Windows
4

5
# 克隆项目
6
git clone https://github.com/170-carry/codex-tools.git
7

8
# 进入项目目录
9
cd codex-tools

步骤 3：安装依赖#

1
# 安装 Node.js 依赖
2
pnpm install
3

4
# 安装时间：约 2-5 分钟（取决于网络）

步骤 4：启动开发环境#

1
# 启动桌面应用（开发模式）
2
pnpm run tauri dev
3

4
# 启动时间：约 30-60 秒
5
# 启动后会打开应用窗口

开发模式特点：

• ✅ 支持热重载
• ✅ 修改代码后自动刷新
• ✅ 控制台会显示日志

步骤 1：完成方式二的所有步骤#

步骤 2：执行打包命令#

1
# macOS
2
pnpm run tauri build
3

4
# Windows
5
pnpm run tauri build

打包时间：约 5-15 分钟（首次打包需要编译 Rust 代码）

步骤 3：查找打包产物#

macOS：

1
ls -la src-tauri/target/release/bundle/dmg/
2
ls -la src-tauri/target/release/bundle/macos/

Windows：

1
dir src-tauri\target\release\bundle\msi\
2
dir src-tauri\target\release\bundle\app\

产物说明：

• .dmg / .app - macOS 安装包
• .exe / .msi - Windows 安装包

方法 1：OAuth 登录导入（推荐）#

1. 点击「账号管理」标签
2. 点击「+ 添加账号」按钮
3. 选择「OAuth 登录」
4. 应用会自动生成授权链接并打开浏览器
5. 在浏览器中登录你的 Codex/ChatGPT 账号
6. 授权完成后会自动跳转回应用
7. 账号会自动导入并保存

优点：

• ✅ 最简单快捷
• ✅ 自动获取完整认证信息
• ✅ 不需要手动操作文件

方法 2：上传 JSON 文件#

1. 点击「账号管理」标签
2. 点击「+ 添加账号」按钮
3. 选择「导入 JSON 文件」
4. 选择一个或多个 .json 账号文件
5. 点击「导入」

JSON 文件格式：

1
{
2
  "label": "我的账号 1",
3
  "account_id": "xxx-xxx-xxx",
4
  "auth_json": {
5
    "access_token": "xxx",
6
    "refresh_token": "xxx",
7
    "session_token": "xxx"
8
  },
9
  "plan_type": "free"
10
}

方法 3：读取文件夹#

1. 点击「账号管理」标签
2. 点击「+ 添加账号」按钮
3. 选择「读取文件夹」
4. 选择包含多个 .json 文件的文件夹
5. 应用会自动读取所有账号文件

适用场景：

• ✅ 有大量账号需要批量导入
• ✅ 从其他工具迁移账号

方法 4：同步当前设备登录#

1. 确保你已经在 Codex 桌面应用或网页版登录
2. 点击「账号管理」标签
3. 点击「+ 添加账号」按钮
4. 选择「同步当前登录」
5. 应用会自动读取本机的登录凭证

注意：

• ⚠️ 只会同步当前登录的账号
• ⚠️ 不会覆盖正在使用的账号

手动刷新#

1. 进入「账号管理」页面
2. 点击「刷新」按钮
3. 等待几秒钟，用量信息会更新

自动刷新#

1. 进入「设置」页面
2. 找到「用量自动刷新」选项
3. 设置刷新间隔（默认 30 分钟）
4. 开启自动刷新

用量信息说明#

每个账号会显示：

按余量排序#

1. 点击「用量」列标题
2. 账号会按余量从高到低排序
3. 再次点击会从低到高排序

一键切换#

1. 在账号列表中选择一个可用账号
2. 点击「切换账号」按钮
3. 等待应用切换到目标账号
4. 切换成功后会显示提示

切换并启动 Codex#

1. 在账号列表中选择一个可用账号
2. 点击「启动 Codex」按钮
3. 应用会：
   • 切换到目标账号
   • 自动启动 Codex 桌面应用
   • 如果找不到桌面应用，会回退到 codex app

编辑器联动（可选）#

1. 进入「设置」页面
2. 找到「编辑器联动」部分
3. 开启「切换账号后重启编辑器」
4. 选择你的编辑器（Cursor / VSCode 等）

效果：

• 切换账号后会自动重启编辑器
• 编辑器会使用新的账号认证

Opencode 授权同步（可选）#

1. 进入「设置」页面
2. 找到「Opencode」部分
3. 开启「同步 Opencode 授权」

效果：

• 切换 Codex 账号时会同步更新 Opencode 的认证
• 适合同时使用两个工具的用户

什么是 API 反代？#

简单说，就是在你的电脑上运行一个本地的 API 服务，让其他工具可以通过 OpenAI 兼容的接口调用 Codex 能力。

工作原理：

1
客户端（如 Cursor） → 本地 API (127.0.0.1:8787) → Codex 上游

启动 API 反代#

1. 点击底部导航栏的「API 反代」标签
2. 设置端口号（默认 8787）
3. 点击「启动」按钮
4. 等待服务启动成功
5. 界面会显示：
   • Base URL: http://127.0.0.1:8787/v1
   • API Key: sk-xxxxxxxx（自动生成）

在 Cursor 中使用#

1. 打开 Cursor
2. 点击设置图标 → Cursor Settings
3. 选择「Models」页面
4. 开启「OpenAI API Key」
5. 填入 API Key（从 Codex Tools 复制）
6. 开启「Override OpenAI Base URL」
7. 填入 Base URL：http://127.0.0.1:8787/v1
8. 在「Add or search model」中输入 gpt-4（或其他支持的模型）
9. 点击「Add Custom Model」

完成！ 现在你可以在 Cursor 中使用 Codex 的能力了。

在其他客户端中使用#

通用配置：

支持的工具：

• ✅ Cursor
• ✅ VSCode (Continue 插件)
• ✅ JetBrains IDEs
• ✅ Any API 客户端

支持的接口#

请求示例#

1
# 健康检查
2
curl http://127.0.0.1:8787/health
3

4
# 获取模型列表
5
curl http://127.0.0.1:8787/v1/models \
6
  -H 'Authorization: Bearer sk-xxxx'
7

8
# 聊天补全
9
curl http://127.0.0.1:8787/v1/chat/completions \
10
  -H 'Content-Type: application/json' \
11
  -H 'Authorization: Bearer sk-xxxx' \
12
  -d '{
13
    "model": "gpt-4",
14
    "messages": [
15
      {"role": "user", "content": "1+1 等于几？"}
16
    ]
17
  }'

自动启动 API 反代#

1. 进入「设置」页面
2. 找到「API 反代」部分
3. 开启「应用启动时自动启动」
4. 设置端口和 API Key（可选）

效果：

• ✅ 每次打开应用都会自动启动 API 反代
• ✅ 不需要手动操作

公网访问（Cloudflared）#

如果你想让其他设备也能访问 API 反代：

1. 点击「API 反代」标签
2. 找到「Cloudflared 公网访问」部分
3. 选择隧道类型：
   • 快速隧道：临时隧道，重启后失效
   • 命名隧道：持久隧道，需要配置
4. 点击「启动隧道」
5. 等待隧道建立成功
6. 复制公网地址（如 https://xxx.trycloudflare.com）

注意：

• ⚠️ 公网访问会暴露你的 API 到互联网
• ⚠️ 请确保 API Key 足够安全
• ⚠️ 建议设置访问限制