Codex

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

准备工作

• 已开通云开发环境，获取环境ID cloudBase环境ID
• 在 AI 控制台中开启所需模型
• 在 AI 控制台中获取 Base URL 和 API Key

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 控制台中获取

CC Switch 配置

CC Switch 是一款开源的桌面应用，统一管理多个 AI 编程工具的供应商配置。安装方式参考 CC Switch 配置文档。

1. 打开 CC Switch，添加云开发供应商

字段	说明
API Key	在 AI 控制台 中获取
Base URL	https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
API 格式	Chat Completions（需开启本地路由）

2. 在高级选项中启用本地路由映射，填入模型 ID

3. 切换启用云开发供应商，重启 Codex 即可使用

配置文件

1. 打开或创建配置文件

备注

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

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

• Mac/Linux 配置路径

~/.codex/config.toml

• Windows 配置路径

C:\Users\<你的用户名>\.codex\config.toml

2. 新增或修改以下配置

model = "hy3"
model_provider = "cloudbase"

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

3. 重启 Codex

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

常见错误排查

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