在 Codex CLI 中用上 GPT-5.6
截至 2026-11-10,在 Codex CLI 里用 GPT-5.6 有三种写法:启动时加 codex -m gpt-5.6-sol,在 ~/.codex/config.toml 里写 model = "gpt-5.6-sol",或在会话里用 /model 选择(Terra 与 Luna 切换方式相同);Codex CLI 当前稳定版是 0.167.0(2026-11-06)。现在卡的不是「5.6 出了没」,而是 /model 里找不到 Sol 怎么办:官方说明 /model 只显示你的账号和工作区可用的型号,用 API key 时可选型号取决于 API 组织和项目;ChatGPT 登录态自 2026-08-31 起不再提供 GPT-5.4。接 QCode provider 时,Codex 用 QCode 的 base_url 和 Key,型号选 gpt-5.6-sol 或 gpt-5.6-terra,也可以选 /models 上的 GPT-6 型号。
为什么 /model 里看不到 gpt-5.6?
两张模型列表经常被当成一张:ChatGPT 登录态 Codex 看到的,和 API key / QCode provider 看到的不是同一份。官方说明 /model 只显示你的账号和工作区可用的型号;截至 2026-11-10,官方 Codex 模型页的推荐列表是 gpt-6-astra、gpt-6.1-sol、gpt-6.1-terra 和 gpt-6-luna,其中没有 GPT-5.6。旧 CLI 没有内置三档时,/model 里也不会出现 gpt-5.6-*。先确认登录方式,再升级 CLI;列表里找不到时,直接用 -m gpt-5.6-sol 或 model = "gpt-5.6-sol" 指定,不要先当成「模型下架」。
开始前需要
- Node.js v22 LTS 或更高版本与 npm(npm 方式安装 / 升级 Codex CLI 用,QCode 文档的要求)
- QCode.cc API Key(注册后开通任一套餐即可获得,¥63/月起;Claude / GPT / 国产模型同 Key 通用)
- 约 5 分钟时间
第一步:升级 Codex CLI 到最新版
GPT-5.6 三档从 2026 年 7 月前后的版本起内置:官方更新日志里,Codex CLI 0.144.6(2026-07-18)写明「刷新了 GPT-5.6 Sol、Terra 和 Luna 的内置说明」。截至 2026-11-10 的当前稳定版是 0.167.0(2026-11-06)。全局升级一条命令完成:npm install -g @openai/codex@latest;升级后用 codex --version 确认版本号。
# update to the latest Codex CLI
npm install -g @openai/codex@latest
# confirm the version
codex --version
第二步:在 config.toml 把 provider 指向 QCode
在 ~/.codex/config.toml 里把 provider 指向 QCode:model_provider = "qcode",[model_providers.qcode] 下写 base_url = "https://api.qcode.cc/openai"、wire_api = "responses"、requires_openai_auth = true;API Key 写在 ~/.codex/auth.json 的 OPENAI_API_KEY 里(requires_openai_auth = true 时 Codex 从这里读取)。官方说明当前 Codex 版本不再支持 wire_api = "chat",自定义 provider 要用 Responses 接口。完整配置见 QCode 文档的 Codex 教程。
# ~/.codex/config.toml — point the provider at QCode
# full config reference:
# https://docs.qcode.cc/docs/getting-started/codex-quick-start
model = "gpt-5.6-terra" # default tier; sol also available
# ... keep your QCode provider / auth settings unchanged
第三步:用 /model 选择档位(或写进配置)
启动 codex 后输入 /model 选择型号,也可以直接写 /model gpt-5.6-sol(Codex CLI 0.164.0 起 /model 支持带参数);启动时用 codex -m gpt-5.6-sol 同样可以,想固定默认值就在 config.toml 写 model = "gpt-5.6-sol"。QCode 的在售型号以 /models 为准,其中有 gpt-5.6-sol、gpt-5.6-terra,以及 gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol、gpt-6-astra;轻量任务在 QCode 上用 gpt-5.6-terra(QCode 暂不提供 gpt-5.6-luna 与 gpt-6-luna)。选型建议:Terra 打底、难题升 Sol。
$ codex -m gpt-5.6-terra
> /model
gpt-5.6-sol
● gpt-5.6-terra ← selected
第四步:验证运行与计费
跑一个小任务确认响应正常,并在会话里运行 /status 确认当前型号;然后在 QCode 控制台查看用量记录,应能看到对应 gpt-5.6 档位的调用。三档与 QCode 上的其他模型共用同一份配额,无需单独购买。
$ codex "add a unit test for utils/retry.ts"
# response streams from gpt-5.6-terra
# then: qcode.cc dashboard → usage
# calls appear under the gpt-5.6 tier you selected
常见问题
无法升级 CLI(受版本锁定),还有办法用 GPT-5.6 吗?
可以。旧版本可用 model-catalog 机制手动注册模型:做法与我们此前的 model-catalog 启用教程完全相同,把 JSON 里的模型 id 换成 gpt-5.6-sol / terra 即可。但首选方案仍是升级 CLI —— 一条命令省去全部手动步骤。
三档该选哪一个?
日常开发选 Terra;跨仓库重构等硬任务升 Sol;补全、批量、CI 轻任务是 OpenAI 的 Luna 档,在 QCode 上可用 gpt-5.6-terra。如果可以换到 GPT-6 一代:官方更新日志(2026-09-22)称 GPT-6 Sol 与 GPT-6 Luna 的 token 价格低于它们的 GPT-5.6 前代;截至 2026-11-10,官方 Codex 模型页把 GPT-6.1 Sol 描述为「接近 Astra 的表现、成本低于 Astra」,QCode 上同样可选 gpt-6.1-sol 与 gpt-6-sol。详细对比见我们的 Sol vs Terra vs Luna 选型指南。 Sol vs Terra vs Luna →
计费和配额怎么算?
gpt-5.6-sol、gpt-5.6-terra 与 QCode 上的其他 GPT 型号、Claude、国产模型共用同一个 QCode 密钥和同一份配额,按 token 计费,各模型单价见 /models(截至 2026-11-10 在售的 GPT 型号有 gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol、gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra)。不想包月?按量包买一笔额度,7 天内用完为止,详见 /pay-as-you-go;已有个人套餐的用户额度不够时买加油包。
经 QCode 调用和直连 OpenAI 有区别吗?
接口是同一套标准接口:Codex 通过 OpenAI Responses 协议接入 QCode,base_url 指向 https://api.qcode.cc/openai,wire_api 写 "responses",Key 写进 ~/.codex/auth.json。区别在接入体验:QCode 让 Claude / GPT / 国产模型一个 Key 通用,同一把 Key 在 Claude Code 里也能用,切换型号不需要额外设置;按 token 计费,各模型单价见 /models。
现在就在 Codex 里试试 GPT-5.6
注册 QCode 并开通套餐(¥63/月起)拿到 API Key,五分钟内在 Codex CLI 里跑起 gpt-5.6-sol / gpt-5.6-terra。