1. Codex 里选不到 gpt-5.6-sol，先别急着重装
你在 Codex 里敲 /model，菜单里躺着 gpt-5.6-terra、gpt-5.6-luna，唯独没有 gpt-5.6-sol；或者你手动把 model 写成 gpt-5.6-sol，回车就甩给你一句 The 'gpt-5.6-sol' model is not supported when using Codex with a ChatGPT account.。这个报错信息其实已经把答案写脸上了——它说的不是"模型不存在"，而是"在你当前这个 ChatGPT 账号登录态下，Codex 不支持这个模型"。
我先把结论摆前面：Codex 看不到 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna，绝大多数情况不是你的账号坏了，也不是装错了，而是四个层次被搅成了一锅粥——CLI 版本、客户端菜单、provider 模型映射、ChatGPT 账号权限。Terra 能用而 Sol 报错，恰恰说明前两层大概率没问题，卡点在第四层（账号权限/灰度）或者你根本没走对入口。
这篇按排障视角来写，适合三类人：一是 CLI 里完全没有 5.6 系列、怀疑自己版本太旧的人；二是 CLI 有、桌面端或 VS Code 插件没有、反复卸载重装的人；三是 Terra 能跑、Sol 一选就报错、想搞清楚到底是服务商映射问题还是账号权限问题的人。核心动作只有一个：不要继续用 ChatGPT account 登录态硬选 Sol，改走 API Key + provider 配置来验证。下面每一步都能直接复制执行。
2. 用 TaoToken 的 Key 和 Base URL 做一次干净验证
在动手改配置之前，得先想清楚一件事：你要验证的到底是"Codex 客户端菜单有没有这个模型"，还是"这个模型名在某个服务商那里能不能真的跑通"。这两件事完全不是一回事。菜单是客户端本地维护的列表，模型映射是服务商上游的事，两者更新节奏经常差好几周。
TaoToken 在这里的角色很单纯：它提供 API Key 和一个兼容的 Base URL，让你能用同一套凭证去请求 gpt-5.6-sol 这类模型名，从而把"客户端菜单滞后"和"服务商模型映射/上游权限问题"这两件事分开。它不负责绕过账号权限，也不会帮你改 Codex 的菜单——菜单里没有就是没有，这点必须先接受。
所以正确的用法是：拿 TaoToken 的 Key 配通 Codex CLI 的 provider 请求，用最小请求测 gpt-5.6-sol。如果同一套 Base URL、同一个 Key、同一个模型名，最小请求都失败，那就不是菜单问题，而是服务商映射或上游权限问题；如果最小请求成功、只是菜单里不显示，那纯粹是客户端列表没刷新，等更新就行。
注册和创建 Key 的入口在这里：打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 完成注册，进控制台创建 API Key。Base URL 记死这一个：https://taotoken.net/api，不要带 /v1，也不要加任何 UTM 参数。这一点很多人栽跟头，后面排障章节会专门讲。
3. 可复制的 Codex provider 配置
3.1 先确认 CLI 版本，别跳过这步
打开终端，第一件事看版本：
codex --version
如果版本偏旧，先更新。npm 安装的用户：
npm install -g @openai/codex@latest
Homebrew 安装的用户：
brew upgrade codex
更新完关掉终端重开，再进 codex，敲 /model 看菜单里有没有 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna。社区反馈里 0.144.0 左右是不少人第一次看到 5.6 的分界点，但别死记版本号，更新到当前最新版才是正解。这一步只解决"CLI 里完全没有 5.6"的情况，解决不了 Sol 的账号权限报错。
3.2 写 config.toml，把 provider 指向 TaoToken
Codex 的配置文件一般在 ~/.codex/config.toml（Windows 在用户目录下的 .codex 文件夹里）。用编辑器打开，加入或修改 provider 段。下面是一份可以直接对照的配置：
model = "gpt-5.6-sol"
model_provider = "taotoken"
[model_providers.taotoken]
name = "TaoToken"
base_url = "https://taotoken.net/api"
env_key = "TAOTOKEN_API_KEY"
wire_api = "chat"
几个参数逐个说清楚，别填错：
| 参数 | 填什么 | 说明 |
|---|---|---|
model | gpt-5.6-sol | 想测哪个就写哪个，Terra/Luna 同理 |
model_provider | taotoken | 要和下面 provider 段的键名一致 |
base_url | https://taotoken.net/api | 不带 /v1，不带 UTM |
env_key | TAOTOKEN_API_KEY | 环境变量名，Key 本身不写进文件 |
wire_api | chat | 走 chat 兼容协议 |
注意：
base_url后面千万别手贱加/v1。Codex 会自己在路径上拼接口，你多写一层/v1，请求就会打到不存在的路径上，报的错还特别像"模型不支持"，很容易带偏排查方向。
3.3 把 Key 放进环境变量
不要把 Key 明文写进 config.toml，用环境变量。macOS / Linux 在 ~/.zshrc 或 ~/.bashrc 里加：
export TAOTOKEN_API_KEY="sk-你的Key"
Windows PowerShell 临时设置（当前会话有效）：
$env:TAOTOKEN_API_KEY="sk-你的Key"
想永久生效就写进系统环境变量。设置完重开终端，用 echo $TAOTOKEN_API_KEY（Windows 用 echo $env:TAOTOKEN_API_KEY）确认能打印出来。
4. 发一条最小请求，看结果说话
配置写完，别急着在交互界面里点来点去，先用最小请求验证。最直接的方式是进 Codex 后发一句极短的提示：
codex
进去之后输入：
只回复两个字：收到
如果模型正常返回，说明 gpt-5.6-sol 这套 Base URL + Key + 模型名的组合是通的。这时候你再回头看菜单——菜单里没有它，但请求能通，那就百分百是客户端模型列表滞后，不是模型不能用。
想更干净地验证，也可以直接用 curl 打一次接口，排除 Codex 客户端本身的干扰：
curl https://taotoken.net/api/chat/completions \
-H "Authorization: Bearer $TAOTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "只回复两个字：收到"}]
}'
返回里能看到正常的 choices 结构，就说明服务商侧这个模型名是认的。接下来把 model 换成 gpt-5.6-terra、gpt-5.6-luna 各测一遍，你就能得到一张清晰的对照表：哪些模型名在服务商侧通、哪些不通。这张表比任何猜测都值钱。
实测下来，Terra 和 Luna 通常先通，Sol 如果报 not supported when using Codex with a ChatGPT account，而你走的是 API Key 配置却依然报这句，那就要怀疑是不是配置没生效、Codex 还在用旧的 ChatGPT 登录态。检查 config.toml 里 model_provider 有没有写对，以及环境变量有没有被正确读取。
5. 本篇常见报错排查
5.1 报 The 'gpt-5.6-sol' model is not supported when using Codex with a ChatGPT account
这句是账号登录态报的，不是模型不存在。含义是你当前用 ChatGPT 账号登录，而这个账号/入口不支持 Sol。三个处理方向：先用 Terra 或 Luna 顶着；等账号、工作区或客户端入口继续灰度；如果你本来就走 API 或中转，就彻底改用 API Key + provider 配置，别再用 ChatGPT account 登录态去硬选 Sol。改完配置后重开 Codex，确认它读的是 provider 而不是登录态。
5.2 配置改了但没生效
最常见的原因是 model_provider 的名字和 [model_providers.xxx] 的键名对不上。上面配置里键名是 taotoken，model_provider 也必须写 taotoken，大小写敏感。另一个原因是环境变量没被读到——Codex 是从启动它的那个 shell 继承环境变量的，你在 A 终端设的变量，B 终端里跑 Codex 是读不到的。重开终端再试。
5.3 Base URL 带了 /v1 或 UTM
https://taotoken.net/api/v1 是错的，https://taotoken.net/api?utm_source=... 也是错的。正确写法就是干干净净的 https://taotoken.net/api。带了多余路径或参数，请求会打到错误地址，返回的报错往往伪装成模型问题，浪费你半天时间。
5.4 CLI 有、桌面端/插件没有
Codex CLI、ChatGPT 桌面端、VS Code 插件、CodexX、CC Switch 不是同一个菜单，更新节奏各走各的。常见情况是 Windows 已显示、macOS 还没显示，或者 CLI 已显示、插件还没同步。这种时候别反复卸载重装，先用 CLI 跑通，等插件更新。你要确认的是当前入口有没有读到最新模型列表，而不是账号是不是坏了。
5.5 同一套配置 Terra 通、Sol 不通
如果 curl 最小请求里 Terra 返回正常、Sol 返回权限或映射错误，那基本可以定性：不是你的配置问题，是服务商侧对 Sol 的模型映射或上游权限还没放开。这时候换模型名、换 Key 都没用，只能等服务商侧更新，或者先用 Terra/Luna 干活。
6. 拿到 Key 之后怎么继续
把上面这套跑通，你手里就有了一把尺子：同一套 Base URL 和 Key，分别测 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna，谁通谁不通一目了然。回到最初那个问题——Codex 看不到 5.6 系列怎么办——答案就分层了：CLI 没有就更新 CLI；CLI 有、插件没有就等插件；菜单没有但最小请求能通就是列表滞后；Terra 通、Sol 报账号不支持就按权限或灰度处理，或者干脆改走 API Key/provider 配置。
需要创建 Key、查接入文档的，走这两个入口：API Keys 在 https://taotoken.net/console/api-keys ，接入文档在 https://taotoken.net/doc 。想先在网页里直接对话验证模型通不通，用模型对话页 https://taotoken.net/model-chat 更快。如果你是长期拿 Codex 做编码、跑 Agent 任务，建议直接上 Coding Plan https://taotoken.net/coding-plan ，省得每次单独配 Key。
最后留一句实在话：真正拖慢排查的从来不是技术难点，而是把客户端版本、模型菜单、provider 映射、ChatGPT 账号权限混成一锅。先拆开，一层一层验，问题会清楚很多。
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
