无量AI开放平台

简体中文

English

简体中文

English

主题

接入 Codex CLI / App ​

功能概述 ​

OpenAI Codex 是 OpenAI 推出的 AI 编程助手，提供两种客户端：

  • Codex CLI（@openai/codex）：终端版，通过 OPENAI_BASE_URL 环境变量或配置文件接入自定义后端。
  • Codex App：桌面图形界面版，只能通过 ~/.codex/config.toml 中的 model_providers 字段指定自定义后端。

从 Codex v0.92 起，Codex 默认调用 OpenAI 的 Responses API（POST /v1/responses），并在 v0.134 后彻底移除对 Chat Completions 协议的回退（wire_api = "chat" 配置项不再有效）。无量AI开放平台已完整实现 Responses API 适配层，可直接作为 Codex 的后端。

前提条件 ​

  • Codex CLI：npm install -g @openai/codex
  • Codex App：在终端执行 codex app 会自动引导安装桌面版
  • 已在无量AI开放平台创建 API Key（前往创建）

配置步骤 ​

方式一：配置文件（推荐，Codex CLI 和 Codex App 都适用） ​

⚠️ Codex App 不会读取 OPENAI_BASE_URL 环境变量，必须通过 ~/.codex/config.toml 配置 model_providers 字段。CLI 用环境变量也可以，但配置文件方式统一更省心。

编辑 ~/.codex/config.toml（文件不存在则新建），把 your-api-key 替换为您的 API Key：

toml
model = "gpt-5.5"
model_provider = "dieyuyun"

[model_providers.dieyuyun]
name = "无量AI开放平台"
base_url = "https://open.dieyuyun.com/v1"
env_key = "OPENAI_API_KEY"

并在 shell 配置（~/.zshrc / ~/.bashrc）中导出 API Key，让 Codex 读取：

bash
export OPENAI_API_KEY="your-api-key"

保存后执行 source ~/.zshrc（或重启终端）。

方式二：环境变量（仅 Codex CLI 可用） ​

Codex CLI 会读取 OPENAI_BASE_URL 和 OPENAI_API_KEY 环境变量。Codex App 不支持此方式。

macOS / Linux ​

将以下内容添加到 ~/.zshrc 或 ~/.bashrc，把 your-api-key 替换为您的 API Key：

bash
export OPENAI_API_KEY="your-api-key"
export OPENAI_BASE_URL="https://open.dieyuyun.com/v1"

保存后执行：

bash
source ~/.zshrc   # 或 source ~/.bashrc

Windows ​

在命令提示符或 PowerShell 中运行：

cmd
setx OPENAI_API_KEY "your-api-key"
setx OPENAI_BASE_URL "https://open.dieyuyun.com/v1"

关闭并重新打开终端使变量生效。

启动 Codex ​

终端 CLI ​

bash
codex

桌面 App ​

bash
codex app

或在应用列表里直接打开 Codex 图标。启动后在模型选择下拉框中应能看到 deepseek-v4-flash，输入 hi 即可验证连通性。

Codex CLI 启动成功

平台接口说明 ​

无量AI开放平台同时兼容两种 OpenAI 协议：

协议路径说明
Responses APIPOST /v1/responsesCodex CLI / App 默认使用，新客户端推荐协议
Chat CompletionsPOST /v1/chat/completions经典协议，兼容大多数 OpenAI 客户端（如 ChatBox、NextChat）
配置项值
Base URLhttps://open.dieyuyun.com/v1
认证请求头Authorization: Bearer your-api-key
数据格式JSON

Responses API 请求示例：

bash
curl --request POST 'https://open.dieyuyun.com/v1/responses' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "input": "你好，请介绍一下你自己",
    "instructions": "你是一个有用的助手",
    "temperature": 0.7,
    "max_output_tokens": 1024
  }'

Chat Completions 请求示例（经典协议）：

bash
curl --request POST 'https://open.dieyuyun.com/v1/chat/completions' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

常见问题 ​

Codex App 报 Incorrect API key 或请求打到 api.openai.com ​

原因：Codex App 不读取 OPENAI_BASE_URL 环境变量，导致请求仍发往 OpenAI 官方。

解决：按「方式一」配置 ~/.codex/config.toml，在 [model_providers.dieyuyun] 中显式声明 base_url。

Codex CLI 报 404 /v1/responses not found ​

原因：使用的 Codex CLI 版本较新，默认调用 Responses API，但目标后端未实现该协议。

解决：升级无量AI网关（已支持）或回退到旧版 Codex CLI 并设置 wire_api = "chat"（仅 v0.92 之前有效，新版已移除）。

模型不在允许列表 ​

在无量AI控制台中给当前 API Key 添加 gpt-5.5 模型权限，详见 管理 API Key。

注意事项 ​

  • 配置文件优先：~/.codex/config.toml 是 Codex CLI 与 App 都能识别的统一配置，推荐作为默认接入方式。
  • API Key 安全：不要把包含真实 API Key 的 config.toml 或 shell 配置提交到版本控制系统。
  • 模型指定：CLI 可通过命令行参数 --model gpt-5.5 临时覆盖配置中的模型。

相关文档 ​