跳到主要内容

Codex

Codex 是 OpenAI 推出的桌面端 AI 编程 Agent，支持通过配置文件接入第三方模型提供商。其配置方式与 Codex CLI 一致。

准备工作

Base URLhttps://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase

配置步骤​

Codex 与 Codex CLI 共享同一份 config.toml 配置文件。

配置字段对照表

字段解释
model大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入
model_provider提供商 ID，指向自定义的 [model_providers] 配置
base_url大模型 Base URL，在 AI 控制台中获取
experimental_bearer_token调用大模型 API Key，在 AI 控制台中获取
  1. 打开或创建配置文件
备注

如果通过您文件浏览器找到文件，文件浏览器默认会隐藏掉以"."开头的文件名的文件，您可能需要打开文件浏览器的隐藏文件选项才能看到。

Mac 通过访达快捷键 Command + Shift + . 打开，Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目" 打开。

  • Mac/Linux 配置路径
~/.codex/config.toml
  • Windows 配置路径
C:\Users\<你的用户名>\.codex\config.toml
  1. 新增或修改以下配置
model = "hy3-preview"
model_provider = "cloudbase"

[model_providers.cloudbase]
name = "CloudBase"
base_url = "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
experimental_bearer_token = "eyJhbGciOiJSUzI1N..."
  1. 重启 Codex

配置完成后重启 Codex，即可使用云开发的模型进行编程对话。

常见错误排查​

报错信息解决方法
404 模型未找到Base URL 填写不正确，请前往 AI 控制台中复制正确的 Base URL
401 Credentials are invalidAPI Key 填写错误，或者可能被删除
429 Token usage exceeded quota limit配置了错误的大模型名称，或者大模型未在 AI 控制台 中启用
模型不响应确认模型名称是否正确，以及模型是否已在控制台启用