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

> CC Switch 路由模式下，OpenAI Official 给 Codex 的是空列表，Codex 退回自带列表，0.165.0 前没有 Terra；回直连并彻底重启即可。

- URL: https://blog.laozhang.ai/zh/posts/cc-switch-codex-model-not-showing
- Published: 2026-10-29
- Updated: 2026-10-29
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: 开发工具与智能体
- Tags: CC Switch, Codex, GPT-6.1 Terra, gpt-6.1-terra, Codex 模型列表, Codex CLI, 路由模式, 聚合模式

---
用 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](https://github.com/farion1231/cc-switch/issues/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。

![直连、路由、聚合和第三方中转四种情况下，Codex 最后读到的分别是官方列表、自带列表还是 CC Switch 生成的目录，以及能否看到 GPT-6.1 Terra](https://blog.laozhang.ai/posts/zh/cc-switch-codex-model-not-showing/img/list-source-by-mode.webp)

| 你的情况 | 怎么认出来 | Terra 为什么不见了 | 修法 |
| --- | --- | --- | --- |
| 路由模式 + OpenAI Official | `config.toml` 里有 `model_provider = "cc-switch-official"`；模型选择器顶部有 base URL 被覆盖的警告 | CC Switch 回给 Codex 空列表，Codex 改用自带列表，0.164.0 及更早没有 Terra | 点「回到直连」并彻底重启 Codex；或把 Codex 升到 0.165.0 |
| 聚合模式 | Codex 页面处在「聚合」；日志里有“登录超过 8 天没有刷新，改用自带列表” | 官方列表由 CC Switch 代拉，登录太久没刷新或检测到的 Codex 版本偏旧，就拿不到新模型 | 在 Codex 里重新登录，等 CC Switch 后台刷新，再彻底重启 |
| 第三方中转供应商 | 当前卡片不是 OpenAI Official | 列表来自你在 CC Switch 里为这家供应商填的模型列表 | 加上 `gpt-6.1-terra`，并确认供应商真的提供 |
| 直连 + OpenAI Official 也没有 | `config.toml` 里没有 `model_provider` | 和 CC Switch 无关：套餐、Codex 版本或守护进程没重启 | 查套餐，把 CLI 升到 0.159.0 以上，彻底重启 |

最后一行要单独说清什么时候该停手。按 [OpenAI 的 Codex 模型文档](https://learn.chatgpt.com/docs/models)，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，再算成本](https://blog.laozhang.ai/zh/posts/gpt-6-sol-vs-terra-vs-luna-vs-astra) 先选别的模型；Terra 和 Sol 的差别见 [GPT-6.1 Terra 和 Sol 区别：Codex 实测用时减半，要高分时 Sol 更省](https://blog.laozhang.ai/zh/posts/gpt-6-1-terra-vs-gpt-6-1-sol)，CLI 版本太旧就按 [Codex CLI 安装与配置：Windows、macOS、Linux 一次跑通](https://blog.laozhang.ai/zh/posts/codex-cli-install) 升级。

## “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](https://github.com/farion1231/cc-switch/pull/8922) 10 月 26 日提交，内容是把官方供应商的模型列表请求转发出去，截至 2026 年 10 月 29 日还没有合并，也没有发布日期，进度可以跟 [CC Switch 的 GitHub issue #7640](https://github.com/farion1231/cc-switch/issues/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 版本 | 自带列表里有 `gpt-6.1-terra` | 直连、ChatGPT 登录时官方列表里有 | 路由 + OpenAI Official 时能看到 |
| --- | --- | --- | --- |
| 0.160.0 | 没有 | 有 | 看不到 |
| 0.163.0 | 没有 | 有 | 看不到 |
| 0.164.0 | 没有 | 有 | 看不到 |
| 0.165.0 | 有 | 有 | 应能看到（推断） |
| 0.165.0-alpha.1.2（ChatGPT 桌面应用自带） | 有 | 未单独测 | 应能看到（推断） |

自带列表用 `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 0.160.0、0.163.0、0.164.0 的自带列表没有 GPT-6.1 Terra，0.165.0 起才有；直连时这几个版本都能从官方列表拿到 Terra](https://blog.laozhang.ai/posts/zh/cc-switch-codex-model-not-showing/img/terra-version-matrix.webp)

这个空列表实验只验证“供应商什么都不给，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` 里会出现这一行：

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

这是 CC Switch 自己的判断规则，不代表登录已经失效。[CC Switch 的 GitHub issue #8728](https://github.com/farion1231/cc-switch/issues/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](https://github.com/farion1231/cc-switch/issues/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 的发布说明](https://github.com/farion1231/cc-switch/releases/tag/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 怎么选](https://blog.laozhang.ai/zh/posts/codex-config-toml)。

*说明：[laozhang.ai 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。*

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

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

| Codex 入口 | 彻底重启的做法 | 要注意的 |
| --- | --- | --- |
| Codex 命令行 | 点 CC Switch 提示里的「重启 Codex 守护进程」，或运行 `codex app-server daemon restart` | 关掉终端再运行 `codex` 不够，所有终端里的 `codex` 共用一个后台守护进程；重启会中断其中正在跑的任务 |
| Codex 桌面版 | 彻底退出后重开，macOS 上按 ⌘Q | 只关窗口不行 |
| 编辑器插件 | 重开编辑器窗口 | 插件有自己的后台服务，不受命令行守护进程重启影响 |

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](https://github.com/farion1231/cc-switch/issues/7885) 里有用户实测过 `codex --no-daemon` 的效果：它不经过共享守护进程，但只对交互式会话有效，`codex exec` 没有这个参数。命令行和守护进程版本对不上还会引出别的报错，见 [Codex account/read failed during TUI bootstrap：修法看后半句](https://blog.laozhang.ai/zh/posts/codex-account-read-failed-tui-bootstrap)。

## 参考来源

本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-10-29。

- [CC Switch 的 GitHub issue #8985](https://github.com/farion1231/cc-switch/issues/8985) (github.com)
- [OpenAI 的 Codex 模型文档](https://learn.chatgpt.com/docs/models) (learn.chatgpt.com)
- [PR #8922](https://github.com/farion1231/cc-switch/pull/8922) (github.com)
- [CC Switch 的 GitHub issue #7640](https://github.com/farion1231/cc-switch/issues/7640) (github.com)
- [CC Switch 的 GitHub issue #8728](https://github.com/farion1231/cc-switch/issues/8728) (github.com)
- [CC Switch 的 GitHub issue #8966](https://github.com/farion1231/cc-switch/issues/8966) (github.com)
- [CC Switch v4.0.21 的发布说明](https://github.com/farion1231/cc-switch/releases/tag/v4.0.21) (github.com)
- [CC Switch 中文 README 的常见问题](https://github.com/farion1231/cc-switch/blob/main/README_ZH.md) (github.com)
- [CC Switch 的 GitHub issue #7885](https://github.com/farion1231/cc-switch/issues/7885) (github.com)