Codex 切换中转站后历史记录消失：用 codex-threadripper 同步回来

type

Post

status

Published

date

May 15, 2026

slug

codex-threadripper-provider-sync

summary

记录使用 ccswitch 切换 Codex 中转站或 model_provider 后，历史会话看不到的原因，以及如何用 codex-threadripper 将旧线程同步到当前 provider 可见桶。

问题现象

我在 Codex 里切换不同的中转站或模型提供方后，发现之前的对话记录不见了。不是 .codex 目录里的历史真的被删了，而是 Codex 当前读取历史记录时，会按配置里的 model_provider 等信息去区分不同来源。

换句话说：历史还在本机，只是当前 provider 看不到旧 provider 下的 thread。

为什么切换 provider 后历史会消失

Codex 的本地目录通常在：

里面会存配置、会话、索引、日志等数据。

当你用 ccswitch 切换中转站时，常见变化不是只换一个 API 地址，而是会一起影响这些信息：

model_provider：当前使用的模型提供方名称，例如官方 OpenAI、第三方中转站、自定义 provider。

base_url：请求发往哪个 API 网关或中转站。

model：当前默认模型。

认证信息：不同 provider 可能使用不同 token 或登录态。

Codex 为了避免不同账号、不同 provider 的历史混在一起，会把历史线程按 provider / 账号 / 配置上下文做隔离。这样做的好处是安全和清晰，坏处是你切换 provider 后，旧 provider 下的历史记录不会自然出现在新 provider 的列表里。

所以看到“历史没了”时，真实情况通常是：

原始会话文件还在 .codex 目录里。

当前 provider 的历史索引里没有这些旧 thread。

需要把旧 thread 同步到当前 provider 可见的索引中。

解决工具：codex-threadripper

codex-threadripper 是一个用于处理 Codex 本地历史线程的命令行工具。它可以扫描 Codex home 目录，把历史 thread 同步到当前环境可查询、可显示的位置。

这里的重点不是恢复删除文件，而是让当前 provider 能重新看见之前的会话记录。

最重要的命令

在 Windows 上，我当前使用的是：

执行后，它会读取指定的 Codex home，并同步历史线程。

参数解释：

codex-threadripper：工具命令名。

--codex-home "C:\Users\雷云\.codex"：指定 Codex 的本地数据目录。

sync：执行同步，把历史 thread 更新到当前可用索引。

如果你的 Windows 用户名或路径不同，把 C:\Users\雷云\.codex 换成自己的路径。

什么时候需要执行 sync

切换了 Codex 中转站后，旧会话看不到。

修改了 model_provider 后，历史列表变空。

换过 Codex 配置目录，想重新索引旧线程。

重装或升级 Codex 后，历史记录还在本机但界面里不显示。

常见问题

执行后还是看不到历史怎么办

先检查 --codex-home 是否指向真正的 Codex 数据目录。Windows 默认一般是：

如果你有多个 Codex 环境，可能历史不在当前目录。

路径里有中文会不会有问题

一般可以正常使用，但路径必须加英文双引号：

这个命令会不会删除历史

sync 的目标是同步索引，不是删除历史。为了稳妥，重要历史可以先备份整个 .codex 目录。

切换 provider 是什么概念

可以把 provider 理解成“Codex 当前连接的模型服务来源”。官方 OpenAI、第三方中转站、自建网关，都可以是不同 provider。不同 provider 的配置、认证和历史上下文可能被 Codex 分开管理。

我的结论

如果你用 ccswitch 切换中转站后发现 Codex 历史记录消失，第一反应不要慌，先不要删配置，也不要重装。

先执行：

很多情况下，历史只是没有同步到当前 provider，而不是彻底丢了。