Appearance
Codex 历史对话怎么恢复(归档、会话丢失、resume)
Codex 的对话记录保存在你本地。看不到之前的对话,大多数情况下记录并没有丢,只是被归档了、需要用命令找回,或者因为配置变化暂时「看不见」。
以下内容依据 OpenAI 官方 Codex 文档(核对日期 2026-10-12),本地 Codex CLI 0.162.1 与之一致。
archive/unarchive需要 0.136.0 及以上(见官方 0.136.0 发布说明),旧版本可运行codex update检查并升级(见官方命令参考)。
先判断是哪种情况
| 你的情况 | 看这一节 |
|---|---|
| 在终端(CLI)里归档了对话,想找回来 | 取消归档:codex unarchive |
| 在 Codex App 里归档了对话 | Codex App:在设置里恢复已归档对话 |
| 想在终端里接着之前的对话继续聊 | 用 codex resume 恢复会话 |
| 切换 API 平台或官方账号后,历史对话全「不见了」 | 切换平台后历史记录消失 |
| 想知道记录到底存在电脑哪里 | 本地会话记录存在哪个目录 |
删除和归档不一样
codex delete <会话ID或会话名称> 是永久删除会话,删除后无法用本页方法恢复。加 --force 时不再提示确认,但这时参数必须是会话 ID(UUID),用会话名称时仍需交互确认。在 TUI 里输入 /delete 会永久删除当前会话并退出,同时删除它派生出的子会话。
归档只是整理会话列表,不会删除对话记录,可以随时取回。不确定时请用归档,不要用删除。(见官方命令参考、官方斜杠命令说明)
取消归档:codex unarchive
归档用来整理会话列表,不会删除对话记录。用 unarchive 就能取回:
bash
codex unarchive <会话ID或会话名称>对应的归档命令是:
bash
codex archive <会话ID或会话名称>- 参数可以是会话 ID,也可以是会话名称;两者都能匹配时,会话 ID 优先
- 会话名称可以在 TUI 里用
/rename给当前会话起,之后resume/archive/unarchive/delete都可以用这个名称 - 在 TUI 里输入
/archive会归档当前会话并退出;任务运行中不能使用 - 已归档的会话在取消归档之前不能
resume或fork,要先unarchive
来源:官方命令参考、官方斜杠命令说明、官方 0.136.0 发布说明
Codex App:在设置里恢复已归档对话
在 Codex App(桌面 App)里归档的对话,可以在设置里恢复:
- 打开 Settings > Archived chats(设置 > 已归档对话)
- 找到要恢复的对话,取消归档
- 取消归档后,对话会回到侧边栏原来的位置
侧边栏里找不到某个对话时,按这个顺序排查:
- 先点侧边栏 Chats(对话)旁边的筛选图标,切换到 Chronological(按时间排列),再找一遍
- 还是没有,再去 Settings > Archived chats 看看是不是被归档了
用 codex resume 恢复会话
codex resume 用来继续之前的交互式会话,常用几种写法:
bash
# 打开会话选择器,从列表里挑一个继续
codex resume
# 跳过选择器,直接继续当前工作目录下最近的一次会话
codex resume --last
# 把当前工作目录以外的会话也纳入
codex resume --all
# 把用 codex exec 跑的非交互会话也纳入选择器和 --last
codex resume --include-non-interactive
# 继续指定的会话
codex resume <会话ID或会话名称>几点说明:
- 换了目录找不到之前的对话时,加
--all - 已经在 Codex 里时,也可以输入
/resume,从会话列表里选择(见官方斜杠命令说明) - 不知道会话 ID?直接用
codex resume或/resume在选择器里挑;想以后好找,可以先用/rename给会话起个名字 - 如果当前目录和会话保存的目录不同,Codex 会询问用哪个目录。不想每次被问,可以把配置项
tui.resume_cwd设为"current"(用当前目录)或"session"(用会话保存的目录) - 想从旧会话分叉出一个新会话、同时保留原记录,可以用
codex fork:默认打开选择器,--last分叉最近一次,--all在选择器里显示当前目录以外的会话;指定会话时只能用会话 ID(UUID),不能用名称 - 已归档的会话要先取消归档才能 resume / fork
来源:官方命令参考
切换平台后历史记录消失
切换了 API 平台,或在平台账号和官方账号之间来回切换后,发现之前的聊天记录全「不见了」?
先别急,记录还在你本地,没有被删除。
为什么记录会「消失」?
官方文档没有专门说明这一点。根据官方仓库的问题报告(CLI 切换 provider 后 resume 看不到旧会话、App 切换自定义 provider 后本地历史被隐藏,后者目前仍未关闭),会话列表可能只显示当前 provider 下的会话。所以切换 provider 后,旧会话只是「看不见」,并没有被删除。
哪 2 处 ID 要对应?
打开 ~/.codex/config.toml,有 2 个地方用到 provider ID,要彼此对应:
toml
# ① 顶层:当前使用哪个 provider(填 provider ID)
model_provider = "codexzh"
# ② section 标题里的 provider ID
[model_providers.codexzh]
name = "codexzh" # 显示名称,可以和 ID 不同model_provider填的是model_providers里的 provider ID,默认是openai(见官方配置参考)name只是显示名称,官方示例写的是"OpenAI using LLM proxy"这样的描述,可以和 ID 不一样;自定义 provider 不能使用保留 IDopenai、ollama、lmstudio(见官方进阶配置)
怎么恢复?
第一步:打开 config.toml
bash
# macOS / Linux
open ~/.codex/config.toml
# 或用编辑器打开
code ~/.codex/config.toml第二步:把 provider ID 改回之前用的那个
toml
model_provider = "这里" # ①
[model_providers.这里] # ②把 ① 改回你之前使用的 provider ID,并确认 ② 的 section 标题用的是同一个 ID。比如之前用 CodexZH 时 ID 是 codexzh,现在 ① 变成了 openai,就把 ① 改回 codexzh。
示例:恢复使用 CodexZH 时的记录
toml
model_provider = "codexzh"
[model_providers.codexzh]
name = "codexzh" # 显示名称,可以不同于 ID
base_url = "https://api.codexzh.com/v1"
experimental_bearer_token = "sk-xxx"第三步:重启 Codex
保存文件后,重启终端里的 codex 命令(或重启 Codex App / IDE 插件),再看会话列表。
想恢复官方账号下的记录?
使用 OpenAI 官方账号时,model_provider 默认是 openai(见官方配置参考)。如果你之前用的是官方账号,想找回那时的记录,推荐使用官方账号 + 平台 API 并用的方式:
这种方式让你用自己的 ChatGPT 账号登录,同时请求走平台的 API 接口,好处是:
- 官方账号的历史记录完整保留
- 继续享有平台的功能和稳定性
- 不需要在「官方账号」和「平台 API」之间二选一
本地会话记录存在哪个目录
Codex 的状态都放在 CODEX_HOME 目录下,默认是 ~/.codex,包括配置、认证、日志、会话等,CLI、IDE 插件和 app-server 都会用到它。如果你自己设置了 CODEX_HOME,这个目录必须已经存在(见官方环境变量说明)。
会话记录的存放位置(见官方 App 故障排查):
| 内容 | 位置 |
|---|---|
| 会话记录 | $CODEX_HOME/sessions(默认 ~/.codex/sessions) |
| 已归档的会话 | $CODEX_HOME/archived_sessions(默认 ~/.codex/archived_sessions) |
建议
恢复对话请优先用上面的 codex unarchive、codex resume 或 App 设置,不建议手动移动或修改这些目录里的文件。