Codex C接 配置教程：的 字段从迁移时必须写完整后缀，填旧值或省略 会静默回退默认模型

---

上周我把 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[日常使用]

先说结论

项目	gpt-5.5（旧）	gpt-5.6-sol（新）	注意
model 字段	gpt-5.5	gpt-5.6-sol	不能写 gpt-5.6，必须带后缀
baseURL（官方直连）	https://api.openai.com/v1	同左	需确认账户有 5.6 系列权限
baseURL（聚合网关）	同下	https://api.ofox.io/v1 等	改一行即可
temperature 推荐（代码补全）	0.2--0.4	0.1--0.2	sol 系列指令对齐更强，调高容易出噪音
同系列其他子模型	无	luna / terra	分别侧重创意写作 / 数据分析

关键变更就一处：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 不需要太高就能保持多样性。

推荐值：

场景	temperature	说明
代码补全 / 代码解释	0.1	稳定、确定性高
代码重构 / 方案生成	0.2	略微放开，允许一点变化
创意任务（取名、文案）	0.5--0.7	sol 不太适合，建议换 luna

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

不同场景怎么选

你的情况	推荐方案	原因
个人开发者，有 OpenAI 账号且已开通 5.6 权限	直连 api.openai.com	最简单，不用额外注册
个人开发者，没有 5.6 权限 / 不想等灰度	聚合网关（ofox.io / OpenRouter）	改一行 baseURL 就能用
团队 10+ 人共用	聚合网关 + 团队管理后台	需要按人头看调用量和费用，ofox.io 的管理后台支持按 User / API Key 维度查看每笔 Token 消耗
想同时用 sol + Claude + Gemini	聚合网关	一个 Key 切多个模型，不用管理多套凭证
只想本地跑，不想联网	ollama provider + 本地模型	和 gpt-5.6-sol 无关，但 Codex CLI 支持

踩坑记录：6 个常见报错

报错信息	原因	解法
Error: 404 The model 'gpt-5.6-sol' does not exist or you do not have access to it.	直连 OpenAI 官方但账户没 5.6 权限	换聚合网关，或等 OpenAI 开放权限
Error: OPENAI_API_KEY is not set	环境变量和 config.json 都没配 Key	export OPENAI_API_KEY=sk-xxxx 或写入 config.json
SyntaxError: Unexpected token in JSON at position 0	config.json 格式坏了（中文引号、多余逗号、BOM 头）	cat ~/.codex/config.json | python3 -m json.tool 检查
Error: connect ECONNREFUSED 127.0.0.1:11434	provider 设成了 ollama 但本地没启动 ollama 服务	改回 "provider": "openai" 或启动 ollama
补全正常返回但质量明显变差，没有报错	model 字段写了 gpt-5.6 没带 -sol，被路由到 luna	改成 gpt-5.6-sol，用 SDK 的 res.model 验证
Error: 401 Incorrect API key provided	Key 填错了，或者用了 OpenAI 的 Key 去请求聚合网关（Key 不通用）	确认 Key 和 baseURL 是配套的

第 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。

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