CheapAI
RU EN 中文
全部指南
OpenAI Codex CLI

Codex:接入低价 AI API

Codex 使用 /v1/responses 协议,我们这里是真正实现而非模拟的,上下文压缩和多步骤会话都能正常工作。配置只需在 ~/.codex/config.toml 里加一个 provider 块。

Codex

OpenAI Codex CLI

在密钥页面创建 API 密钥并复制。

安装 Node.js 18+,然后安装 Codex CLI:

bash
npm install -g @openai/codex

在 ~/.codex/config.toml 中添加 provider(只能是用户级配置,Codex 会忽略项目目录下的配置):

toml
model = "gpt-5.6-sol"
model_provider = "cheapai"

[model_providers.cheapai]
name = "CheapAI"
base_url = "https://cheapai.io/v1"
env_key = "CHEAPAI_API_KEY"
wire_api = "responses"
requires_openai_auth = true

创建 ~/.codex/auth.json,让 Codex 不再认为您登录的是 OpenAI 账号:

json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
这一步很容易漏掉,也是配置“毫无反应”最常见的原因:如果残留着 OpenAI 登录会话,Codex 会一直用它,根本不读您的 provider 配置,所以不会出现任何报错,只会消耗旧账号的额度。

导出密钥(macOS / Linux,写入 ~/.zshrc 可永久生效):

bash
export CHEAPAI_API_KEY="YOUR_API_KEY"

Windows PowerShell:$env:CHEAPAI_API_KEY = "YOUR_API_KEY"

运行 codex。模型可以填目录中的任意模型名(例如 gpt-5.6-sol、claude-opus-4-8),不带厂商前缀。

请使用 wire_api = "responses",Codex 在 2026 年初已移除 chat 模式。provider 的 id 不能是 openai / ollama / lmstudio(已被保留),所以我们用 cheapai。

把 YOUR_API_KEY 替换为密钥页面中的真实密钥。

Codex 常见问题

为什么 provider 不能叫 openai?

openai、ollama 和 lmstudio 这几个 id 在 Codex 内部被保留,无法覆盖它们的 base URL。请用其他名字新建一个 provider 块,例如 cheapai。

wire_api = "chat" 能用吗?

不能,这个模式早在 2026 年 2 月就从 Codex 中移除了。现在只剩 "responses",以前“切换到 chat”的建议已经不适用。

Codex 不读取项目里的配置?

这是正常的:Codex 只读取用户级的 ~/.codex/config.toml,项目目录下的 .codex/config.toml 会被忽略。

获取密钥并接入 Codex

一个密钥调用 Claude、GPT、Gemini 和 Grok · 支持 USDT 和银行卡付款

获取 API 密钥