DigitSpace
全部应用

编程助手

Codex CLI

OpenAI 出品的终端编程智能体，走 Responses 接口。

官网官方文档

Codex CLI 是在终端里运行的编程智能体，能读写项目文件、执行命令。在它的配置文件里加一个自定义模型服务，指向 DigitSpace 的 Responses 接口，就能用国内模型写代码。

适合谁

习惯 Codex CLI、想换用国内模型的开发者。

接入地址

OpenAI Responses 接口

OpenAI 兼容地址
https://api.digitspace.cn/v1

推荐模型

接入步骤

  1. 1

    创建 API 密钥

    登录 DigitSpace 控制台，打开「API 密钥」页，新建一个密钥并复制。密钥只显示一次，请先保存好。

    打开「API 密钥」页
  2. 2

    把密钥放进环境变量

    Codex CLI 从环境变量读取密钥，变量名要和下一步配置里的 env_key 一致。想长期生效就写进 ~/.zshrc 或 ~/.bashrc。

    bash
    export GATEWAY_API_KEY=sk-你的密钥
  3. 3

    编辑配置文件

    打开 ~/.codex/config.toml（没有就新建），加入下面的内容。wire_api 必须是 responses；顶部两行要放在所有 [...] 表之前。

    toml
    model_provider = "gateway"
model = "qwen3.7-plus"

[model_providers.gateway]
name = "DigitSpace"
base_url = "https://api.digitspace.cn/v1"
wire_api = "responses"
env_key = "GATEWAY_API_KEY"
  4. 4

    启动 Codex CLI

    在项目目录里运行 codex。换模型时改配置里的 model，或者启动时加 -m 模型名。

    bash
    codex

验证是否接通

在 Codex CLI 里发一句话，能收到回复就接入成功了。控制台「调用来源」页会出现 Codex 的调用。

常见问题

返回 401 怎么办？

密钥填错了，或者启动 codex 的终端里没有 GATEWAY_API_KEY。在同一个终端里执行 echo $GATEWAY_API_KEY 看看，确认它和 env_key 的名字一致。

返回 402 怎么办？

账户余额用完了。到控制台「账单」页查看余额，按页面提示充值（国内版请联系客服充值），充值后再试，应用里的配置不用改。

返回 404 或提示模型不存在？

model 要写模型目录里的模型名，例如 qwen3.7-plus。base_url 要带 /v1，wire_api 要是 responses。

启动时提示配置文件有错？

~/.codex/config.toml 里如果已经有 model 或 model_provider 这两行，要直接改掉原来那行，不要再加一行。同一个键写两次，配置文件就不合法，Codex CLI 会报错退出。

请求超时，或者很久没有回复？

先确认这台电脑或服务器能访问 API 地址。长文本和深度思考模型出第一个字会慢一些，可以把应用里的超时时间调大，或者换响应更快的模型（例如 qwen-flash）试试。

以上步骤已于 2026-11-01 按官方文档核对。