Codex CLI

适用边界

Codex CLI 的 provider 配置应放在用户级 ~/.codex/config.toml。Ling.AI 作为 OpenAI-compatible provider 时，Base URL 使用 https://api.lingyuncx.com/v1，API Key 通过环境变量读取。不要把真实密钥写进仓库，也不要把 model_providers、model_provider 或 openai_base_url 放进项目级 .codex/config.toml。

准备

• 安装或更新 Codex CLI，确认终端中 codex 命令可用。
• 在 Ling.AI 控制台创建 API Key，并确认 Key、余额、套餐和模型授权可用。
• 请求 GET https://api.lingyuncx.com/v1/models，复制一个适合 Codex 的模型 ID。
• 如果用 CC Switch 统一管理 provider，先安装并启动 CC Switch。

直接配置

1. 设置环境变量。 在 ~/.zshrc、~/.bashrc 或当前终端中设置 LING_AI_API_KEY。
2. 打开用户级配置。 编辑 ~/.codex/config.toml。Codex App 中也可以从 Settings → Configuration 打开该文件。
3. 新增 provider。 添加 [model_providers.lingai]，Base URL 填 https://api.lingyuncx.com/v1。
4. 选择 provider。 在配置顶部设置 model_provider = "lingai"，并把 model 设置为 /v1/models 返回的真实模型 ID。
5. 选择 wire API。 对支持 Responses 语义的模型，使用 wire_api = "responses"；如果模型只支持 Chat Completions，需要按当前 Codex 版本能力单独验证。

配置示例

export LING_AI_API_KEY="<YOUR_LING_AI_API_KEY>"

# File: ~/.codex/config.toml
model = "your-model-id-from-v1-models"
model_provider = "lingai"

[model_providers.lingai]
name = "Ling.AI"
base_url = "https://api.lingyuncx.com/v1"
env_key = "LING_AI_API_KEY"
wire_api = "responses"

CC Switch 配置

CC Switch 支持 Codex app-specific provider。使用 CC Switch 时，仍然把 Ling.AI 配成 API Key provider，Base URL 填 https://api.lingyuncx.com/v1，不要使用 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，重启 Codex CLI 或重新打开终端，再执行短 prompt。

验证

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 官方仓库