Codex 是 OpenAI 推出的 AI 编程工具，可以通过自然语言完成代码库理解、文件编辑和编程任务。本文介绍如何在 Codex 中配置使用腾讯云模型路由 CMR。
安装 Codex
安装完成后，执行以下命令查看版本。终端显示版本号，表示安装成功。
codex --version
注意：
新版 Codex 通过 OpenAI Responses API 调用模型。配置前，请确认模型路由实例及目标模型支持 Responses API。
获取 API Key
注意：
创建完成后，请您务必复制并妥善保管 API Key，关闭创建成功弹窗后，将无法再次查看完整的 API Key。
配置 Codex
配置模型
1. 打开 Codex，单击左下角的设置。
2. 在设置页面选择配置，然后单击打开 config.toml，使用系统默认编辑器打开配置文件。
说明：
您也可以直接打开用户级配置文件：macOS/Linux 为
~/.codex/config.toml，Windows 为 $HOME\\.codex\\config.toml。如果文件不存在，请先创建 .codex 目录和 config.toml 文件。3. 在
config.toml 文件顶部写入以下内容。文件中已有其他配置时，将以下配置添加至文件开头。model_provider = "tencent-cloud-cmr"model = "ModelRouter/auto"disable_response_storage = true[model_providers.tencent-cloud-cmr]name = "Tencent Cloud CMR"base_url = "https://<用户域名>/v1"env_key = "CMR_API_KEY"wire_api = "responses"
配置项说明如下：
配置项 | 说明 |
model_provider | 指定 Codex 使用的自定义模型提供商，值需与 [model_providers.tencent-cloud-cmr] 中的名称保持一致。 |
model | 指定 Codex 调用的模型。 ModelRouter/auto 表示按照 L1 模型路由策略选择可用模型，也可填写实例已关联的模型名称或意图路由名称。 |
disable_response_storage | 禁止上游服务存储响应数据。 |
name | 指定客户端中对外展示的模型名称。 |
base_url | 填写模型路由实例域名，并在末尾添加 /v1。Codex 会自动请求 /v1/responses 。 |
env_key | 指定保存模型路由 API Key 的环境变量名称。 |
wire_api | Codex 使用的接口协议，固定填写 responses 。 |
4. 保存并关闭
config.toml。配置 API Key
请根据操作系统配置
CMR_API_KEY 环境变量。在终端中执行以下命令：
launchctl setenv CMR_API_KEY "<USER_API_KEY>"
1. 在 CMD 中运行以下命令，设置环境变量。
setx CMR_API_KEY "<USER_API_KEY>"
2. 打开一个新的 CMD 窗口，运行以下命令检查环境变量是否生效。
echo %CMR_API_KEY%
1. 在 PowerShell 中运行以下命令，设置环境变量。
[Environment]::SetEnvironmentVariable("CMR_API_KEY ", "USER_API_KEY", [EnvironmentVariableTarget]::User)
2. 打开一个新的 PowerShell 窗口，运行以下命令检查环境变量是否生效。
echo $env:CMR_API_KEY
警告：
请勿泄露 API Key，或将包含真实 API Key 的命令、Shell 配置和日志提交到代码仓库。
验证配置
1. 完全退出 Codex。仅关闭窗口不会结束 Codex 进程。
2. 重新启动 Codex，使
config.toml 和环境变量生效。客户端右下角显示 Tencent Cloud CMR，与配置的模型名称一致。
3. 在 Codex 输入框中输入测试消息，例如“请用一句话说明当前使用的模型”，然后发送。
4. Codex 正常返回响应，表示 CMR 配置已生效。
5. 如果调用失败，请按以下顺序检查：
base_url 是否为模型路由实例域名，并以 /v1 结尾。CMR_API_KEY 是否已在 Codex 进程环境中生效。model 是否为当前实例可用的模型名称、意图路由名称。目标模型是否支持 Responses API。
