Skip to main content

Codex 切换 Provider 保留历史记录全方案（2026.06）

数据来源：LINUX DO 社区 20+ 帖子逐楼阅读，2026-06-08 整理。覆盖 Codex App/CLI 切换 Provider 后历史会话丢失的所有解决方案。

一、问题本质

Codex 按 model_provider 维度隔离会话。切换 Provider 后，历史会话并没有消失，只是在当前 Provider 空间里看不到索引/元数据了。

涉及的本地文件：

  • ~/.codex/config.toml — Provider 配置
  • ~/.codex/state_5.sqlite — 线程的 Provider 信息
  • ~/.codex/sessions/**/rollout-*.jsonl — 会话内容（首行有 Provider 元数据）
  • ~/.codex/session_index.jsonl — 会话索引

来源：2139733「Codex + CC Switch 切换供应商后codex会话消失/401 的完整修法」

二、解决方案总览

方案 名称 难度 耗时 适用场景
方案1 统一 Provider 名称 ⭐ 10秒 预防为主，配置时统一命名
方案2 修改 SQLite 数据库 ⭐⭐ 1分钟 已切换，需要恢复历史
方案3 codex-provider-sync 工具 ⭐ 30秒 一键恢复，推荐新手
方案4 Codex-Threadripper 工具 ⭐⭐ 持续运行 经常切换 Provider 的用户
方案5 CLI 直接 resume ⭐ 即时 只恢复单个会话

三、方案详解

方案1：统一 Provider 名称（最简单）

核心思路：让所有中转站使用同一个 Provider 名称，这样 Codex 就不会隔离会话。

操作步骤：

  1. 打开 CC Switch 或中转站配置
  2. 把 Provider 名称改成和之前一样（比如都叫 custom）
  3. 重启 Codex App

config.toml 示例：

model_provider = "custom"
[model_providers.custom]
name = "custom"
base_url = "http://your-proxy/v1"

⚠️ 注意：不能用 openai（小写）作为 Provider 名称，这是官方保留字，会报错。

来源：2098635#1 @hwj1「分享一个10秒钟解决ccswitch切换中转站导致codex历史会话消失的问题」

方案2：修改 SQLite 数据库

操作步骤：

  1. 关闭 Codex App
  2. 用数据库工具打开 ~/.codex/state_5.sqlite
  3. 修改 threads 表的 model_provider 字段，改成你当前的 Provider 名称
  4. 重启 Codex App

SQL 命令：

UPDATE threads SET model_provider = 'custom';

💡 提示：如果想享受远程压缩功能，可以把所有会话的 Provider 都改成 OpenAI（大写）。但注意 openai（小写）是官方保留字，不能用于自定义 Provider。

来源：1962900#1 @yongye「Codex App 切到 API Provider 后历史会话消失解决办法」

方案3：codex-provider-sync 工具

功能：一键同步 rollout 元数据和 SQLite 里的 provider，让 CLI / App 都能看到同一批历史会话。

安装 & 使用：

# 安装
npm install -g github:Dailin521/codex-provider-sync

# 查看当前状态
codex-provider status

# 同步 Provider
codex-provider sync

# 重启 Codex App

支持：Windows / macOS / Linux

来源：2293227#1 @wanghengtong「Codex APP切换Provider后，历史对话全没了，恢复办法」

GitHub：https://github.com/Dailin521/codex-provider-sync

方案4：Codex-Threadripper 工具

功能：自动撕裂线程之间的隔阂，让所有 Provider 下的会话都能看到。支持后台服务持续运行。

安装 & 使用：

# 安装 (macOS/Linux)
brew tap wangnov/tap
brew install codex-threadripper

# 查看状态
codex-threadripper status

# 启动后台服务（自动同步）
codex-threadripper start

⚠️ 注意：Codex 128 版本引入了新行为：恢复会话时自动切换到上一个会话使用的 Provider。工具可能需要更新以适配。

来源：2120343#1 @wangnov「【开源】切 provider 避免丢会话：Codex-Threadripper」

GitHub：https://github.com/Wangnov/codex-threadripper

方案5：CLI 直接 resume 会话

适用场景：如果只是临时需要访问某个历史会话，可以直接用 CLI 的 resume 命令。

操作步骤：

  1. 在 CC Switch 的会话管理中找到目标会话的 ID
  2. 直接运行命令
codex resume 019de7eb-623c-7d12-938b-c34026f8d6fd

来源：2098635#1 @hwj1

四、最佳实践（预防措施）

1. 统一 Provider 名称

在配置所有中转站时，统一使用同一个 Provider 名称（如 custom），这样切换时不会丢失会话。

2. 使用 "OpenAI"（大写）作为 Provider 名称

model_provider = "OpenAI"
[model_providers.OpenAI]
name = "openai"
base_url = "http://127.0.0.1:8137/v1"

注意：这个方法对公益站有效，但官方账号登录后不会显示第三方会话。且 openai（小写）是保留字，不能用。

来源：2120343#17 @Lu_Hang

3. 定期备份

切换 Provider 前，备份 ~/.codex/ 目录，尤其是 state_5.sqlite 和 sessions/ 文件夹。

五、相关工具汇总

工具名称 功能 GitHub 来源
codex-provider-sync 同步 rollout 元数据和 SQLite provider GitHub 2293227
Codex-Threadripper 自动撕裂线程隔阂，支持后台服务 GitHub 2120343
CodexPlusPlus Codex App 增强工具，含迁移功能 GitHub 2293227
CC Switch 跨平台桌面 All-in-One 助手 GitHub 2098635

六、关键帖子索引

帖子 标题 日期 方案类型
2293227 Codex APP切换Provider后，历史对话全没了，恢复办法 2026-06-02 codex-provider-sync
2139733 Codex + CC Switch 切换供应商后codex会话消失/401 的完整修法 2026-05-09 完整修法
2120343 【开源】切 provider 避免丢会话：Codex-Threadripper 2026-05-06 Threadripper 工具
2098635 分享一个10秒钟解决ccswitch切换中转站导致codex历史会话消失的问题 2026-05-02 统一 Provider 名称
1962900 Codex App 切到 API Provider 后历史会话消失解决办法 2026-04-14 修改 SQLite
1926891 Codex从中转切换到官方如何恢复session 2026-04-08 恢复方法
2265792 codex 远程压缩 对话历史切供应商消失如何解决 2026-06-01 完全解惑
2234221 Codex app 官方/第三方 provider 切换指南 2026-05-24 切换指南
1717518 使用codex迁移自定义provider会话至openai team账号的提示词 2026-03-10 迁移提示词
Back to top