Codex:接入低价 AI API
Codex 使用 /v1/responses 协议,我们这里是真正实现而非模拟的,上下文压缩和多步骤会话都能正常工作。配置只需在 ~/.codex/config.toml 里加一个 provider 块。
Codex
OpenAI Codex CLI
在密钥页面创建 API 密钥并复制。
安装 Node.js 18+,然后安装 Codex CLI:
npm install -g @openai/codex在 ~/.codex/config.toml 中添加 provider(只能是用户级配置,Codex 会忽略项目目录下的配置):
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 账号:
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "YOUR_API_KEY"
}导出密钥(macOS / Linux,写入 ~/.zshrc 可永久生效):
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 会被忽略。