Codex
在 Codex 中使用平台的模型：安装、config.toml 配置、环境变量、启动，以及平台对 Codex 请求的处理。
更新于 2026-10-24·阅读约 2 分钟
Codex（命令行与 IDE 插件）通过 OpenAI Responses 格式（POST /v1/responses）调用平台的模型，平台上的对话模型均可使用。配置前先完成编程工具概览「准备」中的三步。
安装
#bashnpm install -g @openai/codex
codex --version输出版本号表示安装成功。
配置
#Codex 的配置文件：
| 系统 | 文件路径 |
|---|---|
| macOS / Linux | ~/.codex/config.toml |
| Windows | C:\Users\<用户名>\.codex\config.toml |
文件不存在时新建。写入以下内容，将 YOUR_MODEL_ID 换成平台的模型 id：
tomlmodel = "YOUR_MODEL_ID"
model_provider = "scirouter"
[model_providers.scirouter]
name = "SciRouter"
base_url = "https://api.scirouter.cn/v1"
env_key = "SCIROUTER_API_KEY"
wire_api = "responses"model 与 model_provider 两行须写在所有 [...] 段之前；文件中已有这两项时，改为上面的值。
| 配置项 | 取值 | 说明 |
|---|---|---|
model | 平台的模型 id | 默认使用的模型 |
model_provider | scirouter | 与 [model_providers.scirouter] 中的名称一致 |
name | SciRouter | 界面上显示的服务商名称 |
base_url | https://api.scirouter.cn/v1 | 带 /v1 |
env_key | SCIROUTER_API_KEY | Codex 从该环境变量读取 Key，Key 不写入配置文件 |
wire_api | responses | 使用 Responses 格式 |
启动
#确认环境变量 SCIROUTER_API_KEY 已设置（见编程工具概览「准备」），然后启动：
bashcd my-project
codex发送一条消息，收到回答即接入成功。临时使用其他模型时，在启动命令中指定：
bashcodex --model YOUR_MODEL_IDIDE 插件读取同一份 config.toml。
平台对 Codex 请求的处理
#| 项 | 平台的处理 |
|---|---|
| 对话历史 | Codex 每轮将完整对话（含其带回的推理项）放入 input，store 为 false，与平台的无状态约束一致，见 Responses（OpenAI Responses 格式）「不支持的字段」 |
shell / apply_patch 工具 | 函数工具，所有模型均可使用 |
| MCP 工具 | 按 namespace 发送，平台展开为 {namespace}__{name} 的函数工具（展开后重名时返回 400），所有模型均可使用 |
| 推理项续接 | 只有线路标为「原生 Responses」的模型原样续接厂商的加密推理项。其他模型走转换，平台生成的 rs_ 推理项带 encrypted_content（可验证思考块的序列化），Codex 下一轮原样带回即可续接，见 Responses（OpenAI Responses 格式）「转换」 |
| 上下文超长 | 平台发送 event: response.failed，response.error.code 为 context_length_exceeded。Codex 只在收到该事件时自动压缩对话，因此流式请求即使在开流前判定超长，也返回 HTTP 200 加该事件，不返回 400 |
| 退避 | Codex 只读取 Retry-After（不读取 retry-after-ms），平台的 429 均带该响应头 |
Codex 中接入平台的 MCP 工具见 MCP 与托管工具。