这篇也是我自己的使用整理，不是官方文档的搬运。如果你正在用 Cline 或 Cursor，想把 Codex 的模型接进去，可以看看这套方案。 --- ## 项目地址 GitHub： --- ## 它是干什么的 简单说：**把 Codex（gpt-5.5、gpt-5.4、gpt-5.4-mini、gpt-5.3-codex、gpt-image-2 等）以 OpenAI 兼容 API 的形式暴露出来**，让你可以在 Cline、Cursor 或任何支持 OpenAI 接口的客户端里直接用。 支持两种能力： - **文本对话**：`/v1/chat/completions` - **图像生成**：`/v1/images/generations`（gpt-image-2 等） 如果你本身就在用 Cline 或 Cursor 写代码，这个工具能让你直接调用 Codex 的模型，不用等官方接口开放。 --- ## 核心功能 我挑几个我觉得比较实用的说： ### 1）多账号轮询与故障切换 可以配置多个 Codex 贐号，请求会在账号之间自动轮询。如果某个账号挂了，代理会自动用下一个账号重试，不用你手动切换。 这对稳定性帮助很大，尤其是账号多的时候。 ### 2）独立账号代理 每个账号可以绑定单独的代理（支持 HTTP、HTTPS、SOCKS）。这个账号的所有请求和 Token 刷新都会走这个独立代理。 如果你有多个节点，或者某些账号需要走特定线路，这个功能很实用。 ### 3）Token 自动刷新 后台会自动定时刷新 OAuth access_token，最小间隔 5 分钟。刷新成功后，之前标记为"不可用"的账号会自动恢复参与轮询。 基本上配好之后就不用管了。 ### 4）批量导入 支持通过粘贴或上传 `.txt` 文件批量导入 Refresh Token（一行一个），系统会自动换取 access_token 并保存账号。 如果你手上有多个账号，批量导入比一个一个加快很多。 ### 5）交互式看板 有一个 Web 管理界面（默认 `http://localhost:1455/`），可以： - 管理账号和代理配置 - 查看实时请求和日志 - 探测模型可用性 - 查看用量统计 中英双语支持。 --- ## 怎么用 ### 方式一：桌面版（推荐） 1. 去 GitHub Releases 下载 Windows 安装包： 2. 安装运行，配置页会直接在软件窗口里打开 3. 关闭软件后本地服务随之停止 桌面版目前只有 Windows，macOS 和 Linux 用命令行方式。 ### 方式二：命令行 需要 Node.js 18+： ```bash npm install -g codex-proapi codex-proapi ``` 启动后打开 `http://localhost:1455/`。 --- ## 在 Cline / Cursor 里配置 | 配置项 | 填写内容 | |--------|----------| | Base URL | `http://localhost:1455/v1` | | 模型 | `gpt-5.4`、`gpt-5.5` 或其他支持的模型 | | API Key | 随意填（不校验，认证基于你配置的账号） | 操作步骤： 1. 在 `http://localhost:1455/` 的账号页添加 Codex 账号（OAuth 登录、粘贴 JSON、或批量导入） 2. 如果需要代理，给账号绑定独立代理 URL 3. 在客户端里设置 Base URL 和模型 4. 直接用，代理会自动处理轮询、重试和 Token 刷新 --- ## 图像生成 也支持图像生成，走的是 `/v1/images/generations` 接口： ```bash curl -X POST http://localhost:1455/v1/images/generations \ -H "Content-Type: application/json" \ -d '{"model":"gpt-image-2","prompt":"a cat","n":1,"size":"1024x1024"}' ``` 支持的模型：`gpt-image-2`（默认）、`gpt-image-1.5`、`gpt-image-1`、`gpt-image-1-mini`。 --- ## 遇到问题怎么办 几个常见情况： - **登录时提示地区不支持**：确保登录页面也走了代理，试试换节点 - **请求报 `fetch failed`**：检查账号是否激活，服务器能不能访问 chatgpt.com - **400 错误 `Missing required parameter: tool...`**：在客户端里关掉 function calling / tools，代理会自动注入 `tool_choice: none` --- ## 适合什么人 - 在用 Cline 或 Cursor 写代码，想接入 Codex 模型 - 手上有多个 Codex 账号，想做轮询和故障切换 - 需要给不同账号配置不同代理线路 - 想要一个本地可控的 API 中间层 --- ## 总结 如果你在用 Cline 或 Cursor，又想用 Codex 的模型，这个工具基本就是"装上就能用"。多账号轮询、独立代理、Token 自动刷新这些功能省了不少手动操作的麻烦。 项目开源，MIT 协议，有问题可以去 GitHub Issues 反馈：