使用期 · 怎么切档、列表里找不到怎么办

在 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 型号。

#GPT-5.6 #gpt-5.6-sol #Codex CLI #QCode

为什么 /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 确认版本号。

终端 — 升级 Codex CLI
# 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 — QCode provider
# ~/.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 会话 — 切换模型
$ codex -m gpt-5.6-terra
> /model
    gpt-5.6-sol
  ● gpt-5.6-terra    ← selected

第四步:验证运行与计费

跑一个小任务确认响应正常,并在会话里运行 /status 确认当前型号;然后在 QCode 控制台查看用量记录,应能看到对应 gpt-5.6 档位的调用。三档与 QCode 上的其他模型共用同一份配额,无需单独购买。

Codex 会话 — 验证
$ 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。

创建 QCode 账号

一把 key 覆盖 Claude、GPT 与国产模型,按 token 计费,实时单价见 /models。

先体验,再决定

不确定选哪档?先买体验版(¥63/月),满意再升级,旧套餐剩余价值按比例退回余额。