DAL · Codex Guide

Codex 接入教程

使用 Codex CLI 连接到 https://cpa.dongailin.cn/v1。 这套入口兼容 Responses API,默认推荐模型为 gpt-5.4

客户端请使用管理员提供的 API Key,不要把管理密钥写进客户端配置。

1安装 Codex

使用 npm 全局安装 @openai/codex

npm install -g @openai/codex

2编辑 config.toml

编辑 ~/.codex/config.toml。Windows 通常对应 %USERPROFILE%\\.codex\\config.toml

model_provider = "dal"
# 推荐先用这个,已验证可用
model = "gpt-5.4"
# 可配置 high / medium / low / minimal
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.dal]
name = "dal"
base_url = "https://cpa.dongailin.cn/v1"
wire_api = "responses"

3编辑 auth.json

编辑 ~/.codex/auth.json,填入管理员分发的客户端 API Key。

{
  "OPENAI_API_KEY": "替换为您的客户端 API Key"
}
这里填写的是客户端 API Key,不是管理后台的管理密钥。

4开始使用

配置完成后直接运行 codex 即可。也可以在启动时临时指定模型。

codex

# 临时切换模型
codex -m gpt-5.3-codex

常用模型

gpt-5.4 gpt-5.4-mini gpt-5.3-codex gpt-5.3-codex-spark gpt-5.2 gpt-5.2-codex gpt-5-codex

如果模型列表后续更新,以 /v1/models 的实时返回为准。

常见问题

  • base_url 必须写成 https://cpa.dongailin.cn/v1,不要省略 /v1
  • wire_api 必须是 responses
  • 如果启动失败,先检查 auth.json 填的是客户端 API Key,而不是管理密钥。
  • 如果模型名报错,先访问 /v1/models 确认当前可用列表。