Codex CLI 接第三方 API 配置指南
截至 2026-11-20,Codex CLI rust-v0.171.0(2026-11-20 发布)已把 GPT-6.2 Sol 与 Astra 加入模型目录、并以 Sol 作为目录默认(英文原句 Added GPT-6.2 Sol and Astra to model catalogs, with Sol as the default catalog selection.);自定义 provider 想固定型号,就在 ~/.codex/config.toml 里显式写 model = "gpt-6.2-sol",临时换型号用 codex --model gpt-6.2-sol。Codex 中转指的是把 Codex CLI 的请求发往一个支持 OpenAI Responses 协议的接入点,用 cr_ 开头的 Key 按 token 计费,与 ChatGPT 订阅是两套平行系统;截至 2026-11-04,QCode 文档里 Codex 的 base_url 填 https://api.qcode.cc/openai。截至 2026-10-07,Codex CLI 接第三方或自定义端点的做法是:在 ~/.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;QCode 文档的写法是在这张表里设 requires_openai_auth = true、把 key 写进 ~/.codex/auth.json,想改用环境变量时才把它换成 env_key,两种写法只能选一种。本页逐项讲清配置项、常见报错和推荐模型。
更新于 2026-11-20
把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费,实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
先记住这四个值
wire_api 唯一取值
官方配置参考写明 responses 是唯一支持的值,省略时也默认它。QCode 文档同样把 wire_api 写成 responses,对应 /openai/v1/responses 这条路径。
存放 key 的环境变量名
env_key 填的是环境变量的名字,不是 key 本身;官方说明是「提供该 provider API key 的环境变量」。QCode 的 key 以 cr_ 开头。 变量名可以自己定,QCode 文档的示例用的是 QCODE_API_KEY。
QCode 的 base_url 结尾
QCode 文档写明 Codex 的 base_url 必须是 https://api.qcode.cc/openai;Codex 走 Responses 协议,请求落到 /openai/v1/responses。
官方发布页里最新的 CLI
截至 2026-11-04,OpenAI 官方 GitHub releases 里最新的是 Codex CLI 0.166.0(2026-10-29 发布)。此前 2026-10-05 的 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 名叫 qcode,协议走 OpenAI Responses,同一把 key 在 api.qcode.cc、us.qcode.cc、asia.qcode.cc 三个域下都能用。
近期版本里与 provider 有关的改动
截至 2026-11-20:Codex CLI rust-v0.171.0 于 2026-11-20 发布,把 GPT-6.2 Sol 与 Astra 加入模型目录、Sol 为目录默认;gpt-6.2-sol 在 OpenAI 官方 API 的 Standard 标价为输入 $2.00、输出 $10.00、缓存读 $0.10,与 gpt-6.1-sol 的 Standard 标价相同。
此前的版本改动如下:官方变更日志显示 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-10-23 发布 0.164.0,2026-10-29 发布 0.166.0,截至 2026-11-04 官方 GitHub releases 里最新的是 0.166.0。
另据官方 2026-09-14 的公告,GPT-5.5 从 ChatGPT、ChatGPT Work 与 Codex 退役的日期是 2026-10-14(该退役不适用于 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 的说明。 此后 2026-10-23 发布 0.164.0、2026-10-29 发布 0.166.0;截至 2026-11-04,最新为 0.166.0。
已确认 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,key 以 cr_ 开头、写在 ~/.codex/auth.json 的 OPENAI_API_KEY;改用环境变量时把 requires_openai_auth = true 换成 env_key = "QCODE_API_KEY",两种写法只能选一种。
未核实与文档没写的
以下四件事没有核实到,别据此下结论
- 1本页 2026-10-07 抓取的官方配置参考里查不到 preferred_auth_method 这一项,QCode 文档现行的示例也已不写这一行,旧配置里还留着它时在当前版本起什么作用未核实
- 2官方配置项里还有用命令取 token 的 auth 表、http_headers、supports_websockets 等,QCode 文档没有写,我们不承诺它们能与 QCode 配合
- 30.159.1 以前的 Codex 是否认得
gpt-6.1-sol这个名字未经核实,官方网关文档只提示:不配自定义模型目录时,要先确认你的 Codex 版本认得该模型 - 4官方称 GPT-6.1 Sol 接近 Astra 的表现、成本低于 Astra,这是 OpenAI 自述,没有第三方测量。
两组选择怎么定
自定义 provider 对 openai_base_url
官方给了两条路:只想把内置的 openai provider 指向代理或路由时,可以只设 openai_base_url,不必另建 provider;需要自己的 key 变量和协议设置时,在 model_providers 下新建一张表。注意不能新建名为 openai 的表,官方写明内置 id 不可覆盖。QCode 文档用的是第二种(provider 名 qcode),没有写 openai_base_url 的接法,本页也不推荐用它接 QCode。
auth.json 对环境变量
QCode 文档写明两种写法只能选一种:一是在 provider 表里写 requires_openai_auth = true,并在 ~/.codex/auth.json 里写 OPENAI_API_KEY(文档的主写法);二是把 requires_openai_auth = true 换成 env_key = "QCODE_API_KEY",再 export QCODE_API_KEY。
官方文档写明 requires_openai_auth = true 时 Codex 会忽略 env_key,所以两项都写时环境变量不起作用。官方建议不要把凭据写进 TOML 或代码仓库,并提醒在终端里设置的变量,从桌面启动的应用未必读得到。
接 QCode 的五步
截至 2026-11-20,内置目录的默认型号已是 GPT-6.2 Sol,要固定型号就在配置里显式写 model。按 QCode 文档的写法
- 1建好配置目录
~/.codex(Windows 为 %USERPROFILE%\.codex) - 2在
config.toml开头写顶层键:model_provider 设为 qcode,model 显式写gpt-6.2-sol(截至 2026-11-20 的 rust-v0.171.0 目录默认)、gpt-6.1-sol或gpt-6-sol,可选 model_reasoning_effort;临时换型号用 codex--modelgpt-6.2-sol;这些顶层键必须放在第一个表头之前,否则会被算进那张表 - 3新建 model_providers.qcode 表,写 name 为 qcode、base_url 为
https://api.qcode.cc/openai、wire_api 为 responses、requires_openai_auth 为 true(北美与欧洲用户可把域名换成 us.qcode.cc) - 4提供 key:把 cr_ 开头的 key 写进
~/.codex/auth.json的OPENAI_API_KEY;想改用环境变量传 key,就把表里的 requires_openai_auth = true 换成 env_key = "QCODE_API_KEY",再 exportQCODE_API_KEY。两种写法只能选一种:官方文档写明 requires_openai_auth = true 时 Codex 会忽略 env_key - 5启动 codex,用 /status 确认当前的 model 与 provider,也可以跑 codex doctor 检查配置。
在 QCode 上用 Codex
在 QCode 控制台复制一把以 cr_ 开头的 key,按上面五步填好即可;也可以用 QCode 文档里的一键配置脚本,它会自动安装 CLI、写入 ~/.codex 配置并做连通验证。Codex 走 OpenAI Responses 协议,所以在 QCode 上它用的是 GPT 系:gpt-6.2-sol、gpt-6.2-astra、gpt-6.2-sol、gpt-6.2-astra、gpt-6.2-sol、gpt-6.2-astra、gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol、gpt-6-astra、gpt-5.6-terra(docs Codex 页 2026-11-04 的可用模型表)以及仍在 /models 在售的 gpt-5.6-sol 在 QCode 都可调,切换只改 model(QCode 暂不提供 gpt-6-luna 与 gpt-5.6-luna,请使用上面这些 GPT 模型);Claude 与 GLM、Kimi、DeepSeek、Qwen 不走这条协议。
同一把 key 也能给 Claude Code 用。按 token 计费,各模型单价见 /models。截至 2026-11-04,充值页的付款方式是支付宝、微信支付、银行卡与加密货币。支付宝、微信支付、银行卡、Apple Pay、Google Pay 通常 1 分钟内到账;СБП 和俄罗斯银行卡可能需要几分钟;加密货币为人工核对,1 天内到账。
不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。怎么挑接入服务写在 /how-to-choose-ai-api-relay。
常见问题
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;它为 true 时 Codex 会忽略 env_key,所以两者只能选一种。QCode 文档的主写法是设 requires_openai_auth = true、把 key 写进 ~/.codex/auth.json,改用环境变量时才换成 env_key。
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 文档里是 QCODE_API_KEY)、表里是否还留着 requires_openai_auth = true(有它时 Codex 会忽略 env_key),以及当前终端里是否真的设上了;最后到 QCode 控制台确认 key 的状态。
改了 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。
同一把 Key 能不能同时给 Codex 和 Claude Code 用?
能。截至 2026-11-04 复核的 QCode 文档写的是:Claude Code 与 Codex 使用同一把 QCode API Key,切换模型不需要额外开通。但把 Claude 模型发到 Codex 是不行的: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 中转和 Claude Code 中转有什么区别?
截至 2026-11-20,目录默认已是 GPT-6.2 Sol(rust-v0.171.0),gpt-6.2-sol 与 gpt-6.1-sol 的 OpenAI 官方 API Standard 标价相同。区别在协议与可用模型:Codex 走 OpenAI Responses 协议,只能用 GPT 系;Claude Code 走 Anthropic 协议,用 Claude。其余口径照旧。截至 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 官方定位于专注、大批量的任务。除 gpt-6-luna 外,这些在 QCode 都可调,切换只改 model,或用 codex --model。QCode 暂不提供 gpt-6-luna 与 gpt-5.6-luna(QCode 暂不提供),请使用其他 GPT 模型,例如 gpt-6.1-sol、gpt-6-sol 或 gpt-5.6-terra。2026-11-04 复核 docs 的 Codex 页,model 一行现在写的是默认模型推荐 gpt-6.1-sol。 截至 2026-11-04,docs 的 Codex 页「可用模型」表列出 gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol、gpt-6-astra、gpt-5.6-terra;gpt-6.1-terra 是 GPT-6.1 中档,用于日常编码与批量任务。gpt-5.6-sol 不在这张表里,但仍在 /models 在售。
信息来源
截至 2026-11-20 核对:Codex CLI rust-v0.171.0 官方 release(github.com/openai/codex/releases/tag/rust-v0.171.0,2026-11-20 发布)、OpenAI 官方 Codex 模型文档(developers.openai.com/codex/models,含 codex --model gpt-6.2-sol 与 model = "gpt-6.2-sol" 的写法)与 OpenAI 官方 API 定价文档(Standard 档 gpt-6.2-sol 与 gpt-6.1-sol 同价)。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 核对)。2026-11-04 复核 docs.qcode.cc 的 Codex 完整教程、接入点与 API 格式、付款方式总览、订阅、官方 API 与 QCode Key 四页。
相关阅读
Codex CLI 完全指南
OpenAI Codex CLI 的安装配置,以及和 Claude Code 的对比。
Codex CLI 0.171.0 默认 GPT-6.2 Sol:config.toml 接第三方 base_url 的写法(2026-11)
截至 2026-11-20 核对:0.171.0 起 Sol 是目录默认,自定义 provider 要在用户级 config.toml 写 model、model_provider、base_url、wire_api = "responses" 与 env_key。
Codex CLI 云服务器部署
2026 年 10 月核对:云服务器上部署 Codex CLI 的流程、config.toml 与 auth.json 配置、codex exec 非交互运行、试用与时长规则。
加密货币充值指南
9 种币、56 条网络,0 平台手续费购买 AI 编程 API 额度。
本页配置项与版本信息核对于 2026-10-07(对照 OpenAI 官方 Codex 文档、变更日志与 QCode 文档),一切以官方页面为准,官方调整不另行通知。本页不承诺文档未写明的兼容性;模型可用性以 /models 为准。