文档

把 CheapAI 接入您的工具所需的一切：常用智能体的配置指南、API 参考、常见问题。

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 替换为密钥页面中的真实密钥。