Codex Pro API：把 Codex 变成 OpenAI 兼容接口，接入 Cline 和 Cursor

这篇也是我自己的使用整理，不是官方文档的搬运。如果你正在用 Cline 或 Cursor，想把 Codex 的模型接进去，可以看看这套方案。

项目地址

GitHub：https://github.com/violettoolssite/codexProapi

它是干什么的

简单说：把 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 安装包：https://github.com/violettoolssite/codexProapi/releases
  2. 安装运行，配置页会直接在软件窗口里打开
  3. 关闭软件后本地服务随之停止

桌面版目前只有 Windows，macOS 和 Linux 用命令行方式。

方式二：命令行

需要 Node.js 18+：

npm install -g codex-proapi
codex-proapi

启动后打开 http://localhost:1455/。

在 Cline / Cursor 里配置

配置项填写内容
Base URLhttp://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 接口：

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 反馈：

https://github.com/violettoolssite/codexProapi/issues