Codex CLI 接第三方 API 配置指南
截至 2026-10-07，Codex CLI 接第三方或自定义 API 端点的做法是：在 ~/.codex/config.toml 里新建一张 model_providers 自定义表，写上 base_url、wire_api 与 env_key（存放 key 的环境变量名），再让顶层的 model_provider 指向它；官方配置参考写明 wire_api 只支持 responses。接 QCode 时 base_url 填 https://api.qcode.cc/openai，env_key 填你自己命名、用来存放 QCode key 的环境变量名。本页逐项讲清配置项、常见报错和推荐模型。
更新于 2026-10-07
先记住这四个值
wire_api 唯一取值
官方配置参考写明 responses 是唯一支持的值，省略时也默认它。QCode 文档同样把 wire_api 写成 responses，对应 /openai/v1/responses 这条路径。
存放 key 的环境变量名
env_key 填的是环境变量的名字，不是 key 本身；官方说明是「提供该 provider API key 的环境变量」。QCode 的 key 以 cr_ 开头。 变量名可以自己定，QCode 文档的示例用的是 CRS_OAI_KEY。
QCode 的 base_url 结尾
QCode 文档写明 Codex 的 base_url 必须是 https://api.qcode.cc/openai；Codex 走 Responses 协议，请求落到 /openai/v1/responses。
官方变更日志里最新的 CLI
官方变更日志 2026-10-05 发布 Codex CLI 0.160.1；2026-09-29 的 0.159.1 起，内置模型目录把 GPT-6.1 Sol 设为默认模型。
Codex 怎么认第三方端点
截至 2026-10-07，Codex CLI 由 config.toml 里的 model_provider 决定请求发往哪里：它的值是 model_providers 下某张表的 id，不写时默认 openai。官方文档说 model provider 定义了 Codex 如何连接模型，包括 base URL、wire API、认证和可选的 HTTP 头；自定义 provider 不能复用内置的 openai、ollama、lmstudio 三个 id。用户级配置在 ~/.codex/config.toml（Windows 在 %USERPROFILE%\.codex\），项目里的 .codex/config.toml 只在项目被信任后才加载，而且写在项目层的 model_provider 与 model_providers 会被忽略。QCode 文档给出的 provider 名叫 crs，协议走 OpenAI Responses，同一把 key 在 api.qcode.cc、us.qcode.cc、asia.qcode.cc 三个域下都能用。
近期版本里与 provider 有关的改动
官方变更日志显示：2026-09-22 起 GPT-6 Sol 与 GPT-6 Luna 开始向 Codex 推送，CLI 里可用 /model 或 codex --model gpt-6-sol 选择；2026-09-29 的 Codex CLI 0.159.1 把 GPT-6.1 Sol 设为内置模型目录的默认模型；2026-10-01 的 0.160.0 补充说明了 env_key 如何指定存放 API key 的环境变量，显式指定的 provider 模型目录不再混入不支持的内置模型，终端界面也会保留服务端的 provider 设置；2026-10-05 发布 0.160.1。另据官方 2026-09-14 的公告，GPT-5.5 将于 2026-10-14 从 ChatGPT、ChatGPT Work 与 Codex 退役（该退役不适用于 OpenAI API），官方提示更新仍在选用 gpt-5.5 的模型设置、自定义智能体与脚本。本机版本用 codex --version 查看。
时间线
GPT-6 Sol 与 GPT-6 Luna 开始向 Codex 推送；官方建议 Sol 用于复杂编码与智能体工作流，CLI 里用 /model 或 codex --model gpt-6-sol 切换。
GPT-6.1 Sol 进入 Codex；同日 Codex CLI 0.159.1 把它设为内置模型目录的默认模型。QCode 文档把 gpt-6.1-sol 列为 GPT-6 Sol 更新版。
Codex CLI 0.160.1 发布，是 2026-10-07 核对时官方变更日志里最新的 CLI 版本；此前 2026-10-01 的 0.160.0 补充了 env_key 的说明。
已确认 vs 没核实到的
已确认（官方页与 QCode 文档逐字可核）
官方 Codex 文档：model_provider 默认 openai；openai、ollama、lmstudio 是保留 id，不能覆盖；wire_api 只支持 responses，省略时也是 responses；env_key 是提供 API key 的环境变量；requires_openai_auth 默认 false；官方不鼓励把 token 直接写进 experimental_bearer_token；model 与 model_provider 要写在第一个 TOML 表之前。官方变更日志：0.159.1 起 GPT-6.1 Sol 是内置目录的默认模型，0.160.1 于 2026-10-05 发布。QCode 文档：base_url 为 https://api.qcode.cc/openai，wire_api 为 responses，requires_openai_auth 为 true，env_key 为 CRS_OAI_KEY，key 以 cr_ 开头，auth.json 与环境变量同时存在时 auth.json 优先。
未核实与文档没写的
四件事本页没有核实到，别据此下结论：① QCode 文档的示例里有 preferred_auth_method 一行，而本页 2026-10-07 抓取的官方配置参考里查不到这一项，它在当前版本里起什么作用未核实；② 官方配置项里还有用命令取 token 的 auth 表、http_headers、supports_websockets 等，QCode 文档没有写，本页不承诺它们能与 QCode 配合；③ 0.159.1 以前的 Codex 是否认得 gpt-6.1-sol 这个名字，本页没有核实，官方网关文档只提示：不配自定义模型目录时，要先确认你的 Codex 版本认得该模型；④ 官方称 GPT-6.1 Sol 接近 Astra 的表现、成本低于 Astra，这是 OpenAI 自述，没有第三方测量。
两组选择怎么定
自定义 provider 对 openai_base_url
官方给了两条路：只想把内置的 openai provider 指向代理或路由时，可以只设 openai_base_url，不必另建 provider；需要自己的 key 变量和协议设置时，在 model_providers 下新建一张表。注意不能新建名为 openai 的表，官方写明内置 id 不可覆盖。QCode 文档用的是第二种（provider 名 crs），没有写 openai_base_url 的接法，本页也不推荐用它接 QCode。
auth.json 对环境变量
QCode 文档写明二选一：在 ~/.codex/auth.json 里写 OPENAI_API_KEY，或设置环境变量 CRS_OAI_KEY；两者同时存在时 auth.json 优先，所以改用环境变量时要把 auth.json 里的 OPENAI_API_KEY 设为 null。官方建议不要把凭据写进 TOML 或代码仓库，并提醒在终端里设置的变量，从桌面启动的应用未必读得到。
接 QCode 的五步
按 QCode 文档的写法：① 建好配置目录 ~/.codex（Windows 为 %USERPROFILE%\.codex）；② 在 config.toml 开头写顶层键：model_provider 设为 crs，model 设为 gpt-6-sol 或 gpt-6.1-sol，可选 model_reasoning_effort；这些顶层键必须放在第一个表头之前，否则会被算进那张表；③ 新建 model_providers.crs 表，写 name 为 crs、base_url 为 https://api.qcode.cc/openai、wire_api 为 responses、requires_openai_auth 为 true、env_key 为 CRS_OAI_KEY（北美与欧洲用户可把域名换成 us.qcode.cc）；④ 提供 key：export CRS_OAI_KEY 为你那把 cr_ 开头的 key，或写进 ~/.codex/auth.json 的 OPENAI_API_KEY，二选一；⑤ 启动 codex，用 /status 确认当前的 model 与 provider，也可以跑 codex doctor 检查配置。
在 QCode 上用 Codex
在 QCode 控制台复制一把以 cr_ 开头的 key，按上面五步填好即可；也可以用 QCode 文档里的一键配置脚本，它会自动安装 CLI、写入 ~/.codex 配置并做连通验证。Codex 走 OpenAI Responses 协议，所以在 QCode 上它用的是 GPT 系：gpt-6.1-sol、gpt-6-sol、gpt-5.6-sol、gpt-5.6-terra、gpt-6-astra、gpt-6-luna 在 QCode 都可调，切换只改 model；Claude 与 GLM、Kimi、DeepSeek、Qwen 不走这条协议。同一把 key 也能给 Claude Code 用。按 token 计费，各模型单价见 /models。
常见问题
Codex CLI 接第三方 API 要改哪几项？
改 ~/.codex/config.toml 里的两处：顶层的 model_provider 指向你自定义的 provider id，再在 model_providers 下为这个 id 建一张表，写 base_url、wire_api 和 env_key。官方配置参考写明 wire_api 只支持 responses，env_key 是提供 API key 的环境变量名；requires_openai_auth 表示该 provider 使用 OpenAI 认证，默认 false，QCode 文档把它设为 true。
base_url 该填什么？要不要带 /v1？
接 QCode 填 https://api.qcode.cc/openai，不带 /v1，也不带尾斜杠。QCode 文档写明 Codex 的 base_url 必须是这个值，Codex 走的是 /openai/v1/responses 路径。接入点文档的通用说明是不要带尾斜杠，否则会拼出双斜杠路径并返回 404；返回 404 通常说明路径前缀写错了。亚洲备用地址是 https://asia.qcode.cc/openai，北美与欧洲可用 us.qcode.cc。
报 401 或 API key not found 怎么办？
先查三处：key 是否以 cr_ 开头、auth.json 里的 key 有没有多余的空格或换行；用环境变量时，变量名是否正是 config.toml 里 env_key 写的那个（QCode 文档里是 CRS_OAI_KEY），以及当前终端里是否真的设上了；最后到 QCode 控制台确认 key 的状态。注意 auth.json 和环境变量同时存在时 auth.json 优先，用环境变量就把 auth.json 的 OPENAI_API_KEY 设为 null。
改了 config.toml，为什么 provider 没生效？
最常见的是顶层键放错了位置：官方文档要求 model、model_provider 写在第一个 TOML 表之前，写在表头之后的键会被当成那张表的内容。其次，项目目录里的 .codex/config.toml 会忽略 model_provider 与 model_providers，provider 必须写在用户级的 ~/.codex/config.toml，表名也不能叫 openai。再者，QCode 文档提到 Codex 0.134.0 起 config.toml 里的 profiles 老写法已作废，留着老表再用 --profile 会直接报错。启动后用 /status 看当前生效的 model 与 provider。
Codex 里能用 Claude 模型吗？model_not_available_on_endpoint 是什么意思？
在 QCode 上不能。QCode 文档写明 Codex 走 OpenAI Responses 协议，这条协议只服务 GPT 系，Claude 与 GLM、Kimi、DeepSeek、Qwen 都不走；Claude 模型只能走 Anthropic 协议。文档的示例是：把 Claude 模型发到 /openai/v1/chat/completions 会返回 model_not_available_on_endpoint，而且这个校验发生在鉴权之前，所以看到它说明协议选错了，不是 key 的问题。要用 Claude，请改用 Claude Code，同一把 key 就能用。
Codex 接 QCode 推荐用哪个模型？
截至 2026-10-07，QCode 文档的默认推荐是 gpt-6-sol（1.05M 上下文，通用与复杂任务）；gpt-6.1-sol 是 2026-09-29 的 GPT-6 Sol 更新版，同为 1.05M 上下文，文档注明缓存读更便宜，它也是官方 Codex 0.159.1 起内置目录的默认模型；gpt-5.6-sol 属 GPT-5.6 旗舰系列，gpt-5.6-terra 针对代码优化，gpt-6-astra 是最强档、价格也高，gpt-6-luna 官方定位于专注、大批量的任务，单价以 /models 为准。这些在 QCode 都可调，切换只改 model，或用 codex --model。
信息来源
Codex 配置项的定义：OpenAI 官方 Codex 配置参考与高级配置文档（learn.chatgpt.com，2026-10-07 抓取），含 model_provider 默认值、保留 id、wire_api 取值、env_key 与 requires_openai_auth 的说明、openai_base_url 与项目层忽略的键。顶层键的位置、凭据存放与 /status 检查：官方 Connect to a gateway 文档（同日抓取）。版本与模型：ChatGPT 与 Codex 官方变更日志（同日抓取，0.159.1、0.160.0、0.160.1 以及 GPT-6 Sol、GPT-6.1 Sol 两条公告和 GPT-5.5 退役公告）。QCode 的接入写法、base_url、env_key 名称、key 前缀与模型清单：docs.qcode.cc 的 Codex 完整教程、Codex 快速上手、接入点与 API 格式三页（2026-10-07 抓取）。
相关阅读
Codex CLI 完全指南
OpenAI Codex CLI 的安装配置，以及和 Claude Code 的对比。
在 Codex CLI 中使用 GPT-5.6
四步在 Codex CLI 里跑起 gpt-5.6-sol 与 gpt-5.6-terra（经 QCode）。
Codex 5 小时滚动限额指南
5 小时滚动限额的机制、时间线，以及打满之后怎么应对。
本页配置项与版本信息核对于 2026-10-07（对照 OpenAI 官方 Codex 文档、变更日志与 QCode 文档），一切以官方页面为准，官方调整不另行通知。本页不承诺文档未写明的兼容性；模型可用性以 /models 为准。