OpenAI Codex CLI

寻找 Codex CLI 官方文档？

Q: unsupported parameter: 'reasoning.summary' is not supported with the 'gpt-5.3-codex-spark' model.

reasoning.summary 是 Responses API 的一个可选字段，用于让模型返回推理摘要。并非所有推理模型都支持它——这条报错说明消息中点名的模型不接受该字段，请求因此被拒绝。 有两件事需要分开确认。第一是模型 ID：gpt-5.3-codex-spark 不在 CodeGateway 的模型目录中。我们提供的 Codex 模型是 gpt-5.3-codex，它只走 Responses API——请发到 POST /v1/responses，不要发到 /v1/chat/completions。如果调用 CodeGateway 时模型仍填 gpt-5.3-codex-spark，会得到 400 Unsupported model，可以用这个差异区分两种报错。 第二是参数：把请求体里的 reasoning.summary 去掉。该字段是可选的，不带它不影响正常请求。如果确实需要推理摘要，请先查目标模型自己的 API 文档——是否支持取决于模型和版本。如果该字段是工具自动加上的，在它的配置里找到对应的 reasoning 或摘要开关关掉，或换成文档中明确支持推理摘要的模型。

快速跳转到 OpenAI 官方文档的关键页面。还想知道怎么用更便宜、更稳定的 API 接入 Codex CLI？往下看。

(Unofficial)

本指南由社区独立维护，与被介绍的第三方工具厂商无官方隶属、背书或赞助关系，不代表其官方文档。文中第三方商标归其各自所有者所有。

查看官方文档 →↓ 为什么选 CodeGateway

快速导航

直达 Codex CLI 官方最常搜索的页面

安装与配置

90 秒完成 Codex CLI 安装，支持 macOS / Linux / Windows

官方文档

AGENTS.md 指南

用 AGENTS.md 自定义 AI 编码代理的行为和规则

官方文档

Codex CLI 安装与 config.toml 配置

两条安装命令 + 必配 config.toml 键；完整教程含 MCP 与报错排查。

Windows（winget）

winget install OpenAI.Codex

macOS / Linux（npm）

npm install -g @openai/codex

为什么用 CodeGateway 接 Codex CLI？

Codex CLI 默认连接 OpenAI 官方 API。想按量计费少花点钱，或者把模型调用统一到一把 Key 上——CodeGateway 可以直接作为后端。

更便宜

CodeGateway 按官方价格 × 服务倍率计费，无隐藏费用。消费倍率平坦 1.07×，充值另收 2% 服务费。没有月费，没有最低充值。

快速接入

经 Cloudflare 全球边缘网络接入，跨境链路更稳、延迟通常低于直连。个别模型的可用范围受上游地区政策限制，见下方说明。

Codex CLI 报错 FAQ

GSC 里唯一一条 ≥30 曝光、距首页一步的 Codex CLI 报错词

unsupported parameter: 'reasoning.summary' is not supported with the 'gpt-5.3-codex-spark' model.

reasoning.summary 是 Responses API 的一个可选字段，用于让模型返回推理摘要。并非所有推理模型都支持它——这条报错说明消息中点名的模型不接受该字段，请求因此被拒绝。

有两件事需要分开确认。第一是模型 ID：gpt-5.3-codex-spark 不在 CodeGateway 的模型目录中。我们提供的 Codex 模型是 gpt-5.3-codex，它只走 Responses API——请发到 POST /v1/responses，不要发到 /v1/chat/completions。如果调用 CodeGateway 时模型仍填 gpt-5.3-codex-spark，会得到 400 Unsupported model，可以用这个差异区分两种报错。

第二是参数：把请求体里的 reasoning.summary 去掉。该字段是可选的，不带它不影响正常请求。如果确实需要推理摘要，请先查目标模型自己的 API 文档——是否支持取决于模型和版本。如果该字段是工具自动加上的，在它的配置里找到对应的 reasoning 或摘要开关关掉，或换成文档中明确支持推理摘要的模型。