在 Codex CLI 中用上 GPT-5.6
GPT-5.6 已于 2026 年 7 月 9 日全面开放，最新版 Codex CLI 已内置三档模型。这份教程带你四步完成：升级 CLI、接入 QCode、选择档位、验证运行。
为什么 /model 里看不到 gpt-5.6？
旧版本的 Codex CLI 模型列表里没有 GPT-5.6 —— 三档是随 2026 年 7 月前后的版本加入内置列表的。只要升级到最新版，gpt-5.6-sol / terra / luna 就会直接出现在 /model 里，无需再手动导入 model-catalog 文件。
开始前需要
- Node.js 18+ 与 npm（安装 / 升级 Codex CLI 用）
- QCode.cc API Key（注册即得，Claude / GPT / Gemini 同 Key 通用）
- 约 5 分钟时间
第一步：升级 Codex CLI 到最新版
GPT-5.6 三档从 2026 年 7 月前后的版本起内置。全局升级一条命令完成；升级后用 codex --version 确认版本号。
# update to the latest Codex CLI
npm install -g @openai/codex@latest
# confirm the version
codex --version第二步：在 config.toml 配置 QCode profile
在 ~/.codex/config.toml 中加入 QCode 的 provider 与 profile 配置，把请求指向 QCode 端点并使用你的 API Key。完整配置说明见 QCode 文档的 Codex 快速上手。
# ~/.codex/config.toml — add the QCode profile
# full config reference:
# https://docs.qcode.cc/docs/getting-started/codex-quick-start
model = "gpt-5.6-terra" # default tier; sol / luna also available
# ... keep your QCode provider / auth settings unchanged第三步：用 /model 选择档位（或写进配置）
启动 codex 后输入 /model，即可在 gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna 之间切换；也可以在 config.toml 里把 model 设为默认档。选型建议：Terra 打底、难题升 Sol、跑量用 Luna。
$ codex --profile qcode
> /model
gpt-5.6-sol
● gpt-5.6-terra ← selected
gpt-5.6-luna
gpt-5.5第四步：验证运行与计费
跑一个小任务确认响应正常；然后在 QCode 控制台查看用量记录，应能看到对应 gpt-5.6 档位的调用。三档与 GPT-5.5 共用同一份配额，无需单独购买。
$ 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 机制手动注册模型：做法与我们此前的 GPT-5.5 启用教程完全相同，把 JSON 里的模型 id 换成 gpt-5.6-sol / terra / luna 即可。但首选方案仍是升级 CLI —— 一条命令省去全部手动步骤。
三档该选哪一个？
日常开发选 Terra（质量超 GPT-5.5、价格约 Sol 一半）；跨仓库重构等硬任务升 Sol；补全、批量、CI 轻任务用 Luna。详细对比见我们的 Sol vs Terra vs Luna 选型指南。 Sol vs Terra vs Luna →
计费和配额怎么算？
GPT-5.6 三档与 GPT-5.5、Claude、Gemini 共用同一个 QCode 密钥和同一份配额，按量计费。实时费率见 /models 页 —— 与 OpenAI 官方价一致：Sol $5/$30、Terra $2.50/$15、Luna $1/$6（每百万 token）。
经 QCode 调用和直连 OpenAI 有区别吗？
模型与 API 行为一致，走的是标准接口。区别在接入体验：QCode 提供中国大陆优化的低延迟端点、人民币支付、以及 Claude / GPT / Gemini 一个 Key 通用 —— 无需自建代理或海外支付方式。
现在就在 Codex 里试试 GPT-5.6
注册 QCode 获取 API Key，五分钟内在 Codex CLI 里跑起 Sol / Terra / Luna。