上周我把 Codex CLI 从 gpt-5.5 升到 gpt-5.6-sol，折腾了不少时间。原因很直接——gpt-5.6-sol 属于 5.6 系列的子模型（sol/luna/terra 三选一），model 字段必须写完整的gpt-5.6-sol而不是gpt-5.6，否则请求会被路由层静默回退到默认模型，不会收到报错，只是补全质量明显变差。这篇把从拿 Key 到跑通第一条补全的全流程写清楚，包括三条接入路径、gpt-5.5 → gpt-5.6-sol 的配置 diff，以及踩过的 6 个报错。

这篇适合谁

• 已经在用 Codex CLI + gpt-5.5，想升级到 gpt-5.6-sol 但不确定配置怎么改
• 第一次接 Codex CLI，想直接用 sol 系列跑代码补全
• 用 Cline / Claude Code 等工具，想顺便了解 gpt-5.6-sol 的接入方式（底层都是 OpenAI 兼容协议，配置逻辑相通）
• 团队里多人共用 API Key，需要统一管理调用量和费用

整体流程

1. 确认你的 API 端点支持 gpt-5.6-sol（直连 OpenAI 官方 or 聚合网关）
2. 安装 / 更新 Codex CLI 到最新版
3. 修改~/.codex/config.json，写对 model 和 baseURL
4. 跑一条测试补全，确认模型命中
5. 调 temperature 参数，适配代码补全场景

graph LR A[拿到 API Key] --> B[确认端点支持 gpt-5.6-sol] B --> C[改 config.json] C --> D[命令行测试] D --> E[调 temperature] E --> F[日常使用]

先说结论

关键变更就一处：model 字段从gpt-5.5改成gpt-5.6-sol。如果只写gpt-5.6，不会报错——请求会被路由到 5.6 系列的默认子模型（目前是 luna），补全风格明显不一样，排查时容易误判成"模型变笨了"。

第一步：确认端点支持 gpt-5.6-sol

你有两种方式拿到可用端点：

方式 A：OpenAI 官方直连

直接用https://api.openai.com/v1，前提是你的 OpenAI 账户已开通 gpt-5.6 系列权限。验证方法：

curl https://api.openai.com/v1/models \ -H "Authorization: Bearer sk-xxxx" \ | grep "gpt-5.6-sol"

如果返回为空，说明你的账户还没权限，要么等 OpenAI 灰度放量，要么走方式 B。注意：此接口需要有效 Key 才会返回 200，401 表示 Key 无效。

方式 B：通过聚合网关接入

聚合 API 可以选 OpenRouter、Together AI、ofox.io 这类。OpenRouter 收一定手续费，ofox 声称 0% 加价对齐官方价格（具体费率以各平台实时公示为准）。改个 baseURL 就能切，不用等 OpenAI 开权限。

curl https://api.ofox.io/v1/models \ -H "Authorization: Bearer your-key" \ | grep "gpt-5.6-sol"

看到gpt-5.6-sol在返回列表里就行。注意：此接口同样需要有效 Key，401 表示 Key 无效而非模型不存在。

第二步：安装 / 更新 Codex CLI

npm install -g @openai/codex@latest

@openai/codex为 OpenAI 官方发布的 npm 包，安装前可在 npmjs.com 核实包名及发布者。

装完验证一下版本：

codex --version

如果之前装过旧版，建议先卸再装，避免缓存问题：

npm uninstall -g @openai/codex npm install -g @openai/codex@latest

第三步：修改 config.json

配置文件路径是~/.codex/config.json，没有的话第一次运行codex会自动创建。

注意：config.json支持的字段随 CLI 版本变化。以下示例基于写作时的版本，建议对照你实际安装版本的官方文档（codex --version查版本号，然后查对应 release notes）确认字段有效性。

gpt-5.5 → gpt-5.6-sol 迁移 diff

旧配置（gpt-5.5）：

{ "model": "gpt-5.5", "provider": "openai", "apiKey": "sk-xxxx" }

新配置（gpt-5.6-sol，官方直连）：

{ "model": "gpt-5.6-sol", "provider": "openai", "apiKey": "sk-xxxx" }

新配置（gpt-5.6-sol，走聚合网关）：

{ "model": "gpt-5.6-sol", "provider": "openai", "apiKey": "your-ofox-key", "baseURL": "https://api.ofox.io/v1" }

diff 只有两处变化：
1."model"从"gpt-5.5"→"gpt-5.6-sol"（必须带-sol后缀）
2. 如果走聚合网关，加一行"baseURL"

其他字段不用动。provider还是"openai"，因为聚合网关本身兼容 OpenAI 协议。provider字段的合法值及行为随 CLI 版本变化，如遇问题请查阅对应版本的官方文档。

环境变量方式（不想改文件的话）

export OPENAI_API_KEY=your-key export OPENAI_BASE_URL=https://api.ofox.io/v1

然后命令行直接指定模型：

codex --model gpt-5.6-sol "解释这段代码"

优先级：--model参数 > config.json 的 model 字段 > 默认值。此优先级逻辑在当前常见版本中成立，但具体版本行为请以官方文档为准。如果你在 config.json 里写了 gpt-5.5，但命令行加了--model gpt-5.6-sol，实际用的是 sol。反过来也一样——改了配置文件但命令行还带着旧的--model gpt-5.5，那配置文件不会生效。

第四步：跑测试，确认模型命中

codex --model gpt-5.6-sol "用 Python 写一个快排"

正常返回代码就说明接通了。但怎么确认真的是 sol 在响应，而不是被静默回退了？

Codex CLI 本身不会在输出里显示实际使用的模型名。可以用裸 SDK 先验证一遍：

import OpenAI from 'openai'; const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY, baseURL: process.env.OPENAI_BASE_URL });

const res = await client.chat.completions.create({ model: 'gpt-5.6-sol', messages: [{ role: 'user', content: 'hello' }] }); console.log(res.model); // 看这里

res.model返回的应该是gpt-5.6-sol。如果返回的是别的（比如gpt-5.6-luna），说明 model 字段写错了或者端点做了路由重定向。

第五步：调 temperature——sol 系列代码补全的推荐值

gpt-5.5 用 temperature 0.3 做代码补全效果不错。升到 gpt-5.6-sol 之后同样 0.3，生成的代码偶尔会出现一些额外发挥——比如给函数加了未要求的装饰器，或者变量命名风格突然变了。

把 temperature 降到 0.1 之后，补全质量稳定多了。sol 系列在训练时做了更强的指令对齐，temperature 不需要太高就能保持多样性。

推荐值：

关于在 config.json 中设置 temperature：当前版本的 Codex CLI config.json 是否支持temperature字段，请以你实际安装版本的官方文档为准（codex --version查版本后查对应 release notes）。如果当前版本不支持，可以在 prompt 里加一句 "strictly follow my instructions, no extra decorations" 作为替代。用 SDK 直接调用的话，temperature 参数正常传就行。

不同场景怎么选

踩坑记录：6 个常见报错

第 5 个最隐蔽。写了gpt-5.6，CLI 不报错照常跑，但实际调的是 luna。用 SDK 查res.model才能发现。遇到补全质量下降但没有报错的情况，优先用这个方法排查。

常见问题 FAQ

Q: gpt-5.6-sol 和 gpt-5.6-luna、gpt-5.6-terra 有什么区别？

三个是 5.6 系列的子模型。sol 侧重代码和逻辑推理，luna 侧重创意和长文本，terra 侧重数据分析和结构化输出。做代码补全选 sol。具体 benchmark 数据官方未公布完整对比，这里不列数字。

Q: 我在 config.json 里改了 model 但没生效？

检查三件事：① 命令行有没有带--model参数（它优先级最高，会覆盖配置文件）② config.json 的 JSON 格式有没有问题（多余逗号是重灾区）③ 你改的是不是正确的文件路径~/.codex/config.json。

Q: Codex CLI 支持 Anthropic 的 Claude 吗？

截至本文写作时所用版本，Codex CLI 原生 provider 列表包含 openai / azure / gemini / ollama，不含 Anthropic。此情况随版本变化，请以你实际安装版本的官方文档为准。想用 Claude 做代码补全，可以用 Claude Code 或者 Cline。如果你的聚合网关同时提供 Claude 的 OpenAI 兼容端点，理论上也能通过改 baseURL + model 字段来调，但这不是官方支持的用法，稳定性无法保证。

Q: gpt-5.6-sol 的定价是多少？

具体费率以各平台实时公示为准，建议直接登录 OpenAI 官方定价页或所用聚合网关后台查看。这里不列具体数字，避免信息过时误导。

Q: 从 gpt-5.5 迁移到 gpt-5.6-sol，prompt 要改吗？

大部分不用。但如果你之前的 prompt 里有硬编码模型名的写法，记得改掉。sol 对指令的遵循度比 5.5 更强，一些之前需要反复强调的约束（比如"不要添加额外代码"），现在通常一次就能生效，temperature 0.1 下基本不会跑偏。

Q: Cline / Cherry Studio 也能接 gpt-5.6-sol 吗？

能。底层都是 OpenAI 兼容协议，改 base_url 和 model 字段就行。Cline 在 settings 里改，Cherry Studio 在模型配置页改。逻辑和 Codex CLI 一样。

小结

整个迁移就改一行 model 字段的事，但"填gpt-5.6不带-sol后缀会静默回退"这个坑确实容易浪费时间。

sol 系列在代码补全场景下体感比 gpt-5.5 好一截，尤其是对上下文的理解。temperature 记得降到 0.1，别沿用 gpt-5.5 时代的 0.3。

有问题评论区聊，我看到会回。