Code2AI Codex

Codex 配置指南

按以下步骤完成 Codex 的安装和配置。

完成一次 Code2AI 配置后，你可以在 Codex CLI、VS Code 插件 或 Codex App 中使用 Code2AI 服务。

准备：获取 API Key

注册并订阅套餐后，在控制台的「API Key」页面创建一个 Key，以 sk-codex- 开头。下方所有命令里的 sk-codex-xxxxxxxxxxxxxxxx 都替换成你自己的 Key。

完成 Code2AI 配置

下面两步完成后，Codex 就会切换到 Code2AI。三端共用这份配置，无需重复设置。

1

设置环境变量（必做）

⚠ 这一步是必须的。如果跳过或环境变量没生效，启动 Codex 会报 Missing environment variable: `OPENAI_API_KEY`。
以下示例以 bash 为例。

临时设置（当前会话有效）

export OPENAI_API_KEY="sk-codex-xxxxxxxxxxxxxxxx"

永久设置（~/.bashrc）

echo 'export OPENAI_API_KEY="sk-codex-xxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

设置完后先验证一下再启动 Codex，应该能回显你的 Key：

echo $OPENAI_API_KEY

回显为空说明上一步没生效，再检查一下命令是否粘贴正确，或者是否在对应 Shell 中执行。

2

配置 Codex

运行以下命令创建配置文件，跳过 ChatGPT 官方登录流程：

mkdir -p ~/.codex && cat <<'EOF' > ~/.codex/config.toml
model_provider = "code2ai"

[model_providers.code2ai]
name = "Code2AI Codex"
base_url = "https://proxy-codex.code2ai.codes/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
EOF
⚠ 注意：仅设置 OPENAI_BASE_URL 环境变量是不够的。Codex CLI 默认走 WebSocket 协议， 而 OPENAI_BASE_URL 只对 HTTPS 协议生效，会回退到官方 wss://api.openai.com 导致 401。必须按上面方式写入 config.toml 显式配置 model_provider。
🔀 用 CC Switch 等图形化工具切换的用户
如果你用 CC Switch 这类工具管理多个服务商，可跳过上面的「环境变量 / 删 auth.json」两步，直接在工具里新建一个 自定义 供应商（Codex 面板），按下面填：
  • API 请求地址：https://proxy-codex.code2ai.codes/v1
  • 「需要本地路由映射 / 协议转换」开关：保持关闭（本服务本就是原生 OpenAI Responses 格式）
  • auth.json 里 OPENAI_API_KEY 填你的 sk-codex- Key，model 填下方任一支持的模型
保存后切换到该供应商，并完整重启 Codex 生效。务必填当前在期订阅的 Key——填错 / 用过期 Key 时这类工具会自动反复重连，容易触发上面的 403 临时封禁。

选择你的使用方式

选择你常用的 Codex 使用方式。不同方式只影响后续的安装、启动和验证步骤，前面的 Code2AI 配置不需要重复设置。

适合习惯终端使用 Codex 的用户。

1

安装 Node.js LTS

以 Debian/Ubuntu 为例，使用 Nodesource 提供的脚本安装 Node.js LTS：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证版本：

node --version
2

全局安装 Codex CLI

在终端 / PowerShell 运行：

npm install -g @openai/codex@latest

验证安装：

codex --version
3

开始使用 Codex

进入项目目录，启动 Codex CLI：

cd your-project-folder
codex

或指定模型：

codex --model gpt-5.4

⚠️ 遇到 401 错误？

Codex CLI 能用，但 VS Code 插件 / Codex App 报 401？通常有两种原因：

  1. 环境变量在客户端启动前没有设置好，需要 完整重启 对应应用；
  2. ~/.codex/auth.json 中残留了 ChatGPT 官方账号的登录态。删掉 auth.json 再完整重启：
rm -f ~/.codex/auth.json

⚠️ 遇到 403「Your IP has been temporarily blocked」？

这是临时性的、可自助恢复，不是封号。常见原因是：填错或用了 已过期的 Key，客户端（尤其是会自动重连的工具）短时间内反复重试，触发了我们的防护机制，临时封禁了你的 IP 约 1 小时。

  1. 先停止重连：关掉正在不断重试的 Codex / 工具，不要让它继续撞，否则解封后会被立刻重新封；
  2. 换成正确的 Key：回控制台「API Key」页，复制当前在期订阅对应的 Key（旧套餐到期后，它的 Key 会自动失效，不能再用）；
  3. 等待自动解封：约 1 小时后会自动恢复；急用可把 request_id（形如 req_relay_xxxx）发给客服手动解封。

支持的模型

  • gpt-5.5 — 最新一代主力
  • gpt-5.4-pro — 上一代顶配，稳定可靠
  • gpt-5.4 — 通用主力，性价比高
  • gpt-5.3-codex — 编码特化，适合代码场景
  • gpt-5.4-mini — 轻量快速，适合简单任务

所有套餐均可使用全部模型，在 Codex CLI 里通过 --model 参数切换。

常见问题

Q: 和 OpenAI 官方 API 有区别吗？

接口兼容 OpenAI Responses API（Codex CLI 使用的格式），不支持 /v1/chat/completions。

Q: 能用在 Cursor / Continue 里吗？

Cursor / Continue 使用 Chat Completions 格式，当前版本暂未完全兼容，建议用 Codex CLI / VS Code Codex 插件 / Codex App。

Q: 已达 5 小时 / 7 天额度上限怎么办？

套餐有 5h 滑动窗口和 7d 滑动窗口的额度限制。等待重置或在控制台升级到更高档套餐。

Q: 报错时怎么提供给客服？

响应中会包含 request_id（形如 req_xxxxxxxx），把这个 ID 发给我们就能快速定位。错误体里的 source 字段有助于判断来源：

  • source: “client” — 请求参数问题（API Key 错误、JSON 格式错误等）
  • source: “relay” — 平台侧限制（套餐额度、Key 被禁用）
  • source: “upstream” — 上游 ChatGPT 暂时故障，稍后再试
Q: 连接被代理工具拦截？

如果本机有 V2Ray / Clash 等代理，请把 proxy-codex.code2ai.codes / codex.code2ai.codes / api-codex.code2ai.codes 加到 NO_PROXY 或代理工具的直连白名单中。