Codex CLI

通过自定义供应商连接 OneModel。Codex 使用 Responses 协议，不能将它替换为 Chat Completions 地址。

安装与准备

按 Codex CLI 官方指南 安装客户端，并准备好 API Key。

也可以使用 CC Switch 一键导入：在控制台选择「导入 CCS → 导入到 Codex」，确认后启用供应商。

手动配置

1. 打开配置文件

系统	文件位置
Windows	%USERPROFILE%\.codex\config.toml
macOS / Linux	~/.codex/config.toml

如果设置过 CODEX_HOME，使用该目录下的 config.toml。先备份已有文件，再合并以下配置；同名 TOML 键或表不要重复定义。

2. 添加供应商

以原教程中的 glm-5.2 为示例，实际使用前请确认模型和 Key 分组匹配。

model_provider = "one_model"
model = "glm-5.2"

[model_providers.one_model]
name = "OneModel"
base_url = "https://one-model.com/v1"
wire_api = "responses"
env_key = "ONEMODEL_API_KEY"

3. 设置密钥并启动

选择当前终端对应的命令，替换占位密钥后运行。环境变量对当前终端及从它启动的进程生效；重新打开终端时需要重新设置，或在系统环境变量中保存。

Windows PowerShell

$env:ONEMODEL_API_KEY = "sk-your-api-key"
codex

macOS / Linux

export ONEMODEL_API_KEY="sk-your-api-key"
codex

使用独立环境变量

此配置读取 ONEMODEL_API_KEY，不需要修改已有 auth.json。不要把真实密钥提交到项目仓库。

原教程的 auth.json 方式

如果你正在沿用原教程或 CC Switch 导入的配置，可以继续使用以下组合。不要与上面的 env_key 方式混用。

config.toml：

model_provider = "one_model"
model = "glm-5.2"

[model_providers.one_model]
name = "OneModel"
base_url = "https://one-model.com/v1"
wire_api = "responses"
requires_openai_auth = true

同目录下的 auth.json：

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

修改 auth.json 可能改变原有登录方式，操作前先备份。新配置建议使用前面的独立环境变量方式。

切换模型与推理强度

修改 config.toml 顶层的 model，填入 模型页面 上可用的模型 ID。

如果所选模型和上游支持推理强度，再在 [model_providers.one_model] 之前添加顶层配置：

model_reasoning_effort = "high"

不同模型支持的档位不同。遇到不支持的参数错误时，先移除这项设置，用最小配置验证。

验证

重新启动 codex，发送一句「你好」。收到正常回复后，在 用量页面 核对记录。

若提示环境变量未设置，确认设置 Key 与启动 Codex 使用的是同一个终端。若出现 404，确认 Base URL 为 /v1，没有写成 /v1/chat/completions。

参考

自定义供应商、base_url、env_key 和 wire_api 字段见 OpenAI 官方配置参考。平台地址和原有认证方式来自本项目原教程；本页不代表所有模型都支持 Responses 的全部功能。