1. Codex 换 Provider 后历史对话消失先别急着重装Codex 切换 Provider 后历史对话丢失是很多用auth.json管理凭据的开发者都会撞上的一次“假性丢数据”。它的典型表现是你在 IDE 里把 Provider 从旧的换成新的重启 Codex 插件左侧会话列表突然空了之前几十轮调试记录全都不见。第一反应往往是“数据被删了”但绝大多数情况下~/.codex/sessions目录里的会话文件还在只是 Codex 按新的 Provider 标识去读了一个空目录。要理解这件事得先知道 Codex 的本地会话是怎么组织的。Codex 会把每个 Provider 的会话索引和状态分开存放核心目录是~/.codex/sessions和~/.codex/archived_sessionsUI 侧的会话列表则依赖state_5.sqlite这个 SQLite 状态库。当你换 ProviderCodex 认为“当前活跃 Provider 变了”于是去读新 Provider 对应的会话路径旧路径下的数据自然读不出来。这不是数据损坏而是路径映射没对齐。这篇内容面向的是已经在用auth.json管凭据、并且遇到“换 Provider 后历史对话读不出来”的开发者。我会给出auth.json与 Base URL 的可复制配置片段讲清楚切换 Provider 前后的备份与回滚步骤最后用一次最小对话请求验证历史会话能不能正常加载。适合谁本地.codex目录完整、只是 Provider ID 变更导致读取失效的人不适合谁.codex目录被清空或磁盘损坏的情况那种得先做数据恢复。核心检索词先摆出来Codex 切换 Provider 后恢复历史对话本质是让新 Provider 的会话路径重新指向旧数据而不是重新生成对话。下面按“先备份、再配置、后验证”的顺序走每一步都能直接复制执行。2. 用 TaoToken 统一 Base URL先把 auth.json 备份好在动手改任何配置之前先把~/.codex整个目录备份一份。这一步不是可选项因为后面会碰到 SQLite 文件写冲突一旦发生回滚全靠这份备份。cp -r ~/.codex ~/.codex_bak_$(date %Y%m%d_%H%M%S)备份完确认一下当前 Provider 状态和本地 Session 路径心里有数再改ls -la ~/.codex/ ls -la ~/.codex/sessions/你会看到sessions、archived_sessions、state_5.sqlite这些关键项。如果sessions里还有旧的会话文件说明数据没丢只是没被当前 Provider 读到。接下来是凭据层。Codex 用auth.json管理 Provider 凭据路径通常在~/.codex/auth.json。如果你打算把 Provider 统一到 TaoTokenBase URL 用https://taotoken.net/apiKey 从控制台生成。这里给一份可复制的auth.json结构字段名以你本地 Codex 版本为准核心是base_url和api_key两项{ provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5 }注意base_url结尾不要多加/v1之类的后缀Codex 会自己拼接路径多写反而容易 404。Key 的生成入口在控制台的 API Keys 页面模型 ID 要和你在 Codex 里选的保持一致否则会出现“请求发出去了但模型对不上”的情况。如果你用的是 Claude Code 那套配置思路一样Base URL、Key、Model ID 三件套必须齐全缺一个都会在启动时报错。TaoToken 的接入文档里有各客户端的字段对照改之前扫一眼能省不少来回。改完auth.json先别急着开 IDE。Codex 插件在启动时会缓存 Provider 状态带着旧缓存启动新配置可能不生效。正确顺序是关掉 IDE 进程 → 改auth.json→ 再启动。这一步顺序错了后面验证会一直失败很容易误判成配置写错。3. 可复制配置auth.json 与 Base URL 对齐会话路径配置层的关键是让auth.json里的 Provider 标识和会话目录的映射对上。Codex 读会话时会拿当前 Provider 的 ID 去拼路径所以你要保证新 Provider 能指向旧数据所在的目录。先看一份完整的auth.json示例把 Provider 段和模型段都写全{ provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-5, session_dir: ~/.codex/sessions }session_dir这一项在不同 Codex 版本里名字可能不同有的叫sessions_path有的干脆不暴露、走默认。如果你的版本不认这个字段就跳过它改用下面的目录对齐方式。目录对齐的核心动作是把旧 Provider 的会话数据同步到当前活跃 Provider 的目录下。假设旧目录是~/.codex/sessions/old-provider新目录是~/.codex/sessions/taotoken可以这样处理# 先确认两个目录都存在 ls ~/.codex/sessions/ # 把旧会话复制到新 Provider 目录复制而非移动保留回滚余地 cp -r ~/.codex/sessions/old-provider/. ~/.codex/sessions/taotoken/复制而不是移动是为了万一新目录结构不对旧数据还在原地。SQLite 状态库state_5.sqlite也要留意它存的是会话索引如果索引和实际文件对不上列表照样是空的。稳妥做法是复制完会话文件后让 Codex 重建一次索引而不是手动去改 SQLite。如果你更倾向用工具做映射社区里有codex-provider-sync这类脚本思路也是把~/.codex/下的持久化文件做映射处理。但工具只是省事原理还是上面这套路径对齐。用工具前同样先备份因为 SQLite 在同步过程中写冲突的概率不低。配置改完检查一遍三件套是否齐全Base URL 是https://taotoken.net/apiKey 是控制台生成的Model ID 和 Codex 里选的一致。这三项任何一项缺失都会在下一步验证时暴露成报错。4. 最小对话请求验证历史会话能否加载配置改完别直接开一个大项目去试。先用一次最小对话请求确认两件事新 Provider 能正常出结果历史会话列表能读出来。第一步命令行层面验证 Provider 通不通。用 curl 打一次最小请求curl https://taotoken.net/api/v1/messages \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, max_tokens: 64, messages: [{role: user, content: 回复 ok 两个字母即可}] }返回里能看到正常的content字段说明 Base URL 和 Key 没问题。如果这里就报 401先别往下走回到auth.json检查 Key 有没有多余空格、有没有把控制台的 Key 和别的服务搞混。第二步启动 Codex打开会话列表看旧对话是否出现。如果列表还是空的检查~/.codex/sessions/taotoken/下有没有文件ls -la ~/.codex/sessions/taotoken/有文件但列表不显示多半是state_5.sqlite索引没更新。这时候关掉 Codex把状态库备份后删掉让 Codex 重新生成cp ~/.codex/state_5.sqlite ~/.codex/state_5.sqlite.bak rm ~/.codex/state_5.sqlite重启 Codex它会扫描sessions目录重建索引旧对话通常就回来了。这一步之所以有效是因为会话文件本身没丢丢的只是“目录索引”。第三步做一次带上下文的对话确认历史能真正被加载进上下文而不只是列表里显示。打开一个旧会话追问一句“我们刚才聊到哪了”如果模型能接上之前的内容说明会话数据被正确读取。如果模型答非所问说明只恢复了列表、没恢复上下文那要回头检查会话文件是否完整复制。验证通过后把这次可用的auth.json和目录结构记下来下次再换 Provider 直接照做不用重新排查。5. 常见报错排查401、local proxy failed 与 reading choices换 Provider 后恢复历史对话报错基本集中在几个固定位置。下面按真实报错对照排查每条都给检查动作。401 Unauthorized最常见出现在 curl 验证或 Codex 启动时。原因通常是 Key 无效、Key 带了多余字符、或者auth.json里base_url写错导致请求打到了别的地址。检查动作把 Key 单独拿出来 curl 一次确认https://taotoken.net/api能通再检查auth.json里有没有把 Key 写成占位符没替换。local proxy failed / connection refusedCodex 启动时报本地代理失败。这通常是 IDE 或系统里残留了旧的代理配置指向了一个已经关掉的本地端口。检查动作看 Codex 设置里有没有proxy字段有就清掉确认没有把 Base URL 误写成localhost开头的地址。TaoToken 的 Base URL 是https://taotoken.net/api不需要本地代理。reading choices / choices 字段读取失败这类报错说明请求发出去了但返回结构不是 Codex 预期的格式。常见原因是 Base URL 多写了/v1或少了路径段导致返回的是错误页而不是模型响应。检查动作确认base_url就是https://taotoken.net/api不要自己拼/v1/messages到配置里路径交给 Codex 拼。OAuth 相关报错如果你之前用的是 OAuth 登录的 Provider切到 Key 认证后旧的 OAuth token 可能还在缓存里导致认证方式冲突。检查动作清掉~/.codex下的 OAuth 缓存文件通常是auth.json之外的 token 文件只保留 Key 认证。会话列表空但文件在不是报错但最容易被当成故障。检查动作确认sessions目录下当前 Provider 子目录有文件确认state_5.sqlite索引是否过期必要时备份后删除让它重建。排查顺序建议从外到内先 curl 验证 Base URL 和 Key再启动 Codex 看列表最后做带上下文的对话。哪一层失败就停在哪一层查不要跳步否则容易把配置问题和索引问题混在一起。6. 把 Provider 切换做成可回滚的固定流程把上面几步串起来其实就形成了一套可回滚的固定流程备份~/.codex→ 改auth.json三件套 → 对齐会话目录 → 删索引重建 → 最小请求验证。每次换 Provider 都按这个顺序走历史对话基本不会再“消失”。几个实测下来比较省事的点备份用带时间戳的目录名回滚时直接cp -r回去会话文件用复制不用移动保留旧目录state_5.sqlite出问题优先删了重建而不是手动改表。长期在多个 Provider 之间切换、或者跑 Agent 类长任务的可以考虑把配置固定到 TaoToken 的 Coding Plan减少反复改auth.json的次数。需要生成 Key 或对照各客户端字段的去控制台的 API Keys 页面和接入文档想先验证模型响应格式的用模型对话页面打一次最小请求最直观。配置改完记得先 curl 再开 IDE这个顺序能帮你把大部分问题挡在启动之前。