Codex CLI

适用边界

Codex 的 provider 配置应放在用户级 ~/.codex/config.toml，API Key 放在同目录 auth.json。Ling.AI 作为 OpenAI-compatible provider 时，Base URL 使用 https://api.lingyuncx.com/v1，一定要以 /v1 结尾。不要把真实密钥写进仓库，也不要把 model_providers、model_provider 或 openai_base_url 放进项目级 .codex/config.toml。

安装

• 建议准备 Node.js 22 或更高版本。
• 终端用户安装或更新 Codex CLI，确认 codex 命令可用。
• VS Code 或基于 VS Code 的 IDE 用户，可在扩展市场搜索并安装 Codex - OpenAI's coding agent 插件。
• CLI 与 IDE 插件任选其一即可；两种方式都读取同一套用户级 ~/.codex 配置。

npm install -g @openai/codex@latest
codex --version

准备

• 确认用户级配置目录存在：macOS / Linux 为 ~/.codex，Windows 通常为 C:\Users\你的用户名\.codex。
• 请求 GET https://api.lingyuncx.com/v1/models，复制一个适合 Codex 的模型 ID；不确定时可先不固定 model。
• 准备写入 ~/.codex/config.toml 和 ~/.codex/auth.json，不要把 API Key 写进项目目录。
• 如果用 CC Switch 统一管理 provider，先安装并启动 CC Switch。

直接配置

1. 打开用户级配置。 编辑 ~/.codex/config.toml。Codex App 中也可以从 Settings → Configuration 打开该文件。
2. 新增 provider。 添加 [model_providers.lingai]，Base URL 填 https://api.lingyuncx.com/v1，并设置 requires_openai_auth = true。
3. 禁用 websocket。 在 provider 下保留 supports_websockets = false，让 Codex 使用普通 HTTP Responses 请求。
4. 写入密钥文件。 在同目录创建或编辑 auth.json，把 Ling.AI API Key 写入 OPENAI_API_KEY 字段。
5. 选择 provider。 在配置顶部设置 model_provider = "lingai"；如需固定模型，再把 model 设置为 /v1/models 返回的真实模型 ID。
6. 重启 Codex。 保存后重启 Codex CLI、终端或 IDE 插件，再执行短 prompt 验证。

配置示例

# File: ~/.codex/config.toml
model_provider = "lingai"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

# 可选：固定模型；模型名请以 /v1/models 当前返回为准。
# model = "gpt-5.5"

[model_providers.lingai]
name = "Ling.AI"
wire_api = "responses"
base_url = "https://api.lingyuncx.com/v1"
requires_openai_auth = true
supports_websockets = false

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxx"
}

CC Switch 配置

CC Switch 支持 Codex app-specific provider。使用 CC Switch 时，仍然把 Ling.AI 配成 API Key provider，Base URL 填 https://api.lingyuncx.com/v1，并让工具写入用户级 config.toml 和 auth.json。不要使用 OAuth reverse proxy 方案替代 Ling.AI API Key。

1. 进入 Codex 工具页。 启动 CC Switch，选择 Codex。
2. 新增 provider。 点击加号或 Add Provider。
3. 选择类型。 使用 Custom Configuration、API Key Provider 或当前版本中等价的自定义供应商类型。
4. 填写名称。 Provider Name 建议填 Ling.AI。
5. 填写 Base URL。 输入 https://api.lingyuncx.com/v1。
6. 填写 API Key。 填 Ling.AI API Key，或按 CC Switch 支持的方式引用本机密钥。
7. 填写模型。 Model ID 填 /v1/models 当前返回的真实 ID。
8. 启用并重启。 保存后 Enable / Switch，确认 provider 使用 Responses wire API 且 websocket 已禁用，再重启 Codex CLI 或 IDE 插件。

验证

1. 运行 codex "用一句话说明当前目录的项目类型"。
2. 确认 Codex CLI 收到模型回复。
3. 回到 Ling.AI 控制台，核对请求状态、模型 ID、usage 和钱包扣费。
4. 如果 Codex 报配置警告，先确认 provider 配置在 ~/.codex/config.toml，不是项目级 .codex/config.toml。

排障

参考资料

• OpenAI Codex Config Reference
• OpenAI Codex Advanced Configuration
• CC Switch 官方仓库