CC Switch 下 Codex 看不到 GPT-6.1 Terra：回直连或升 0.165.0

用 CC Switch 管理 Codex，却在 /model 或桌面版的模型选择器里找不到 GPT-6.1 Terra，最常见的情况是 Codex 正走 CC Switch 的「路由」模式（GitHub 上常说的“接管”），当前供应商是 OpenAI Official。这时 Codex 向 CC Switch 在本机 15721 端口的地址要模型列表，CC Switch 不转发这个请求，只回一个空列表，Codex 只好改用自己的自带列表，而 Codex 0.164.0 及更早版本的自带列表里没有 gpt-6.1-terra。CC Switch 维护者 2026 年 10 月 28 日在 CC Switch 的 GitHub issue #8985 里确认，最新的 v4.0.21 仍有这个问题，不是你的配置写错了。

现在最快的修法是在 CC Switch 的 Codex 页面点「回到直连」，然后彻底重启 Codex：命令行要重启后台守护进程，macOS 桌面版要按 ⌘Q 退出，编辑器插件要重开窗口。直连时由 Codex 自己去拉官方列表，账号开通了 Terra 就会出现。想继续用路由，可以把 Codex 升级到 10 月 27 日发布的 0.165.0，它的自带列表已经带上 Terra；这条是根据各版本自带列表的实测推出来的，没有在 CC Switch 里实际跑过。

聚合模式和第三方供应商的原因不同。聚合模式下多半是 CC Switch 认为 Codex 的登录“超过 8 天没有刷新”而改用自带列表，在 Codex 里退出再登录就能解决；接第三方中转时，要在 CC Switch 里给这家供应商的模型列表加上 gpt-6.1-terra，而且供应商本身得提供它。如果回到直连还是没有 Terra，问题就不在 CC Switch，先查套餐和 Codex 版本。

先认出 CC Switch 处在哪种模式：四种情况四种修法

Codex 的模型列表有三个来源：OpenAI 官方服务按账号返回的列表、编译进 Codex 程序的自带列表，以及 CC Switch 生成的模型目录 ~/.codex/cc-switch-model-catalog.json。CC Switch 处在哪种模式，决定了 Codex 最后读哪一份，所以先对照下表找到自己那一行。最快的判断方法是打开 ~/.codex/config.toml：里面有 model_provider = "cc-switch-official"，就是路由模式下的 OpenAI Official。

最后一行要单独说清什么时候该停手。按 OpenAI 的 Codex 模型文档，GPT-6.1 Terra 从 2026 年 10 月 26 日起在 Plus、Pro、Business、Enterprise 和 Edu 套餐的 Work 与 Codex 里提供，ChatGPT 聊天里本来就没有，Free 和 Go 不在名单内；Enterprise 和 Edu 还要工作区管理员开启，并且 OpenAI 要求 Codex CLI 0.159.0 或更高版本。套餐不含 Terra、管理员没开，换什么模式都看不到它，这时可以按 GPT-6 Sol、Luna、Astra 与 Terra 怎么选？认清 6.1 Terra，再算成本 先选别的模型；Terra 和 Sol 的差别见 GPT-6.1 Terra 和 Sol 区别：Codex 实测用时减半，要高分时 Sol 更省，CLI 版本太旧就按 Codex CLI 安装与配置：Windows、macOS、Linux 一次跑通 升级。

“OpenAI base URL is overridden” 提示是原因吗：不是，它说明路由开着

模型选择器顶部那条英文警告，原文是 “Warning: OpenAI base URL is overridden to”，后面跟着 CC Switch 在本机 15721 端口的地址，再接 “Selecting models may not be supported or work properly.”。维护者在 issue #8985 里解释，这是 Codex 自己的提示：只要名为 OpenAI 的供应商地址不是官方默认地址就会显示，所以一开路由就会出现，它本身不会让模型消失。这条警告的用处是告诉你路由开着，照下一节处理即可；关掉警告不会让 Terra 回来。

路由模式 + OpenAI Official：回到直连，再彻底重启 Codex

路由模式下缺 Terra 的直接原因是 CC Switch 没把模型列表请求转发给官方。维护者给的办法是先回到直连，让 Codex 自己去拉官方列表，再彻底退出并重开 Codex，包括后台服务。按这个顺序做：

1. 打开 CC Switch 的 Codex 页面，点「回到直连」。只点页面顶部的「直连」标签只是切换查看的内容，不会改配置。
2. 打开 ~/.codex/config.toml，确认 model_provider = "cc-switch-official" 已经不在。
3. 按文末“彻底重启 Codex”一节，重启你正在用的 Codex 入口。
4. 打开 /model 或桌面版的模型选择器找 GPT-6.1 Terra。用命令行的话，也可以运行 codex debug models | grep -o gpt-6.1-terra，有输出说明新启动的 Codex 拿到了它。

不想离开路由（比如要用它的故障转移），另一条路是把所有 Codex 入口升到 0.165.0。路由模式下 Codex 读的是自带列表，而 0.165.0 是第一个把 gpt-6.1-terra 写进自带列表的正式版，所以升级后应该能看到 Terra。这是由维护者的说明和下一节的版本实测推出来的，没有在 CC Switch 里验证。升级后要确认真正在跑的是新版本：issue #8985 的报告者 PATH 上已经是 codex-cli 0.165.0，但截图里会话的实际版本没有确认，后台守护进程可能还是旧的，用 codex app-server daemon version 可以同时看到命令行和正在运行的守护进程版本。

至于在路由模式下直接运行 codex -m gpt-6.1-terra 能不能绕过列表，没有实际测试过，维护者也没有说明，可靠的做法仍是上面两条。CC Switch 这边的修复 PR #8922 10 月 26 日提交，内容是把官方供应商的模型列表请求转发出去，截至 2026 年 10 月 29 日还没有合并，也没有发布日期，进度可以跟 CC Switch 的 GitHub issue #7640。如果你的 CC Switch 还是 3.x 这样的旧版本，维护者建议顺便升级到最新版。

哪个 Codex 版本能看到 Terra：自带列表从 0.165.0 起才有

Codex 自己去拉官方列表时，0.160.0 就能拿到 Terra；只有在 Codex 退回自带列表的情况下（路由 + OpenAI Official，或聚合模式改用自带列表），版本号才决定你能不能看到它。第一个自带 Terra 的正式版是 0.165.0：npm 上的正式版在 0.164.0（10 月 23 日）之后直接是 0.165.0（10 月 27 日），中间没有补丁版。下表是 2026 年 10 月 29 日在一台 Apple Silicon 的 macOS 上，用 npm 版 Codex 跑出来的结果：

自带列表用 codex debug models --bundled 在空的配置目录里读出：实际导出的 0.160.0、0.163.0、0.164.0 三个版本都只有 gpt-6.1-sol、gpt-6-astra、gpt-6-sol、gpt-6-luna 和 GPT-5.6 系列等模型，0.165.0 多出了显示名为 GPT-6.1 Terra 的 gpt-6.1-terra，0.161 和 0.162 没有导出。官方列表那一列是在同一台 Mac 上，用一个已开通 Terra 的 ChatGPT 账号登录、不设 model_provider，分别以 0.160.0、0.163.0、0.164.0 运行 codex debug models 得到的，三个版本都拿到了 gpt-6.1-terra。另外用一个只返回 {"models":[]} 的本机服务充当供应商，0.164.0 显示的正好是不含 Terra 的 8 个模型，0.165.0 显示含 Terra 的 9 个，和各自的自带列表完全一致。同一天还查看了 Codex 0.165.0 的 --help，下文用到的 codex app-server daemon restart、codex app-server daemon version、--no-daemon 参数，以及 codex login、codex logout，都是在那里确认的。

这个空列表实验只验证“供应商什么都不给，Codex 就用自带列表”这个结果。最后一列由两部分合起来：路由模式下 CC Switch 回空列表，来自维护者在 issue #8985 的说明和 issue #7640 里多位报告者的请求复现；回了空列表之后显示什么，看的是各版本的自带列表。CC Switch 本身没有安装测试，因为它会改写正在使用的 ~/.codex/config.toml；聚合模式、桌面版模型选择器的界面、Windows 和 Linux 版本，以及路由下强行指定 -m gpt-6.1-terra，也都没有测试，相关内容来自 CC Switch 的文档和 GitHub 讨论。

聚合模式日志“登录超过 8 天没有刷新”：在 Codex 里重新登录

聚合模式下，官方模型列表不是 Codex 拉的，而是 CC Switch 用它在本机检测到的 Codex 版本，去 chatgpt.com/backend-api/codex/models 代拉。Terra 不见通常有两个原因。第一个是~/.codex/auth.json 里的 last_refresh 超过 8 天，CC Switch 就不去拉官方列表，直接用 Codex 的自带列表，日志 ~/.cc-switch/logs/cc-switch.log 里会出现这一行：

没用上 Codex 官方模型列表（登录超过 8 天没有刷新），改用自带列表

这是 CC Switch 自己的判断规则，不代表登录已经失效。CC Switch 的 GitHub issue #8728 里，一位 Windows 用户 10 月 27 日的报告显示旧凭据请求官方列表仍然成功，列表里也有 Terra。截至 10 月 29 日这个 issue 还开着，报告者用下面的顺序恢复了，另一位 macOS 用户重新登录后，也在 CC Switch 生成的目录里看到了 gpt-6.1-terra：

1. 在 Codex 里退出登录，再用 ChatGPT 重新登录；命令行是先 codex logout，再 codex login。
2. 保持 CC Switch 运行、聚合模式开着，等它的后台检查重新拉官方列表。可以在 ~/.codex/cc-switch-model-catalog.json 里搜 gpt-6.1-terra，搜得到就说明已经写进目录。
3. 按文末一节彻底重启 Codex，再打开模型选择器。

第二个原因是 CC Switch 检测到的 Codex 版本偏旧，官方按旧版本返回旧列表。维护者 10 月 22 日在同一个 issue 里举过例子：GPT-6.1 Sol 要 0.160 起才会返回。它检测的是 PATH 上的 codex 和 Codex 最近会话记录里最新的版本，所以先把命令行版升到最新，在 CC Switch 里重新切换一次聚合的默认供应商，再彻底重启。

日志里的 error decoding response body：偶发一次可以不管

另一条常被一起贴出的日志是 刷新 Codex 官方模型列表失败: 读取响应失败: error decoding response body。维护者在 CC Switch 的 GitHub issue #8966 里解释，这是下载响应途中超时、代理或网络断开时的笼统报错，和新模型的字段格式无关。一次失败不影响使用，CC Switch 会保留原来的列表，每 15 分钟再检查一次；那位报告者之后也在目录里看到了 Terra。只有它反复出现时，才需要查代理或 VPN。

第三方中转供应商：在 CC Switch 模型列表里加上 gpt-6.1-terra

用第三方中转时，Codex 的模型菜单来自你在 CC Switch 里为这家供应商填的模型列表，CC Switch 据此生成 ~/.codex/cc-switch-model-catalog.json。按 CC Switch v4.0.21 的发布说明，列表的顺序就是 Codex /model 菜单的顺序，第一行是默认模型。所以 Terra 要出现，得同时满足两个条件：这家供应商的模型列表里有 gpt-6.1-terra，而且供应商自己真的提供这个模型。填好后同样要彻底重启 Codex。DeepSeek 等自定义模型在 Codex 里不显示，也是同一个机制，按同样的方法加进列表。

是否提供 gpt-6.1-terra 要去中转商那里核实，比如截至 2026 年 10 月 29 日，laozhang.ai 的 /v1/models 列出了 gpt-6.1-terra。通过中转用 Codex 走的是 API Key 计费，和 ChatGPT 套餐额度是两回事。config.toml 里 model_providers、base_url 和认证怎么写，见 Codex 自定义 API 配置：Key、Base URL 与 Provider 怎么选。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

怎么彻底重启 Codex：命令行、桌面版和编辑器插件各不相同

Codex 只在启动时读取模型列表，所以前面每一种修法最后都要彻底重启，否则看到的还是旧列表。CC Switch 从 v4.0.7 起会在直连、路由、聚合三种模式下检查 Codex 是否还在用旧目录，发现了就在 Codex 页面顶部提示，但它没法让正在运行的 Codex 自己重新读取。各入口的做法如下，来自 CC Switch 中文 README 的常见问题：

2026 年 10 月 29 日查看 Codex 0.165.0 的 --help，codex app-server daemon 下有 restart 和 version 两个子命令，后者会同时列出命令行和正在运行的守护进程版本，交互式会话的 --no-daemon 参数也在其中；更早的版本没有逐个查看。Windows 上，CC Switch 的提示依据守护进程的 daemon.pid 判断，看不到桌面版和编辑器插件，这两个入口要自己重启。只想让手动打开的命令行会话马上读到新配置，CC Switch 的 GitHub issue #7885 里有用户实测过 codex --no-daemon 的效果：它不经过共享守护进程，但只对交互式会话有效，codex exec 没有这个参数。命令行和守护进程版本对不上还会引出别的报错，见 Codex account/read failed during TUI bootstrap：修法看后半句。