使用 Codex Desktop 时，本地历史记录、项目会话和模型配置都保存在电脑的 .codex 目录中。codex恢复项目历史备份把检查、备份、同步和恢复整理到一个界面里，下载工具名为 codexbak，适合在同步前备份历史、恢复旧会话或找回某个项目下的 Codex 记录。

一、工具特点

• 支持 Windows 本地使用，下载后直接运行 CodexBak.exe。
• 自动检测 Codex 本地数据目录，一般是 C:\Users\你的用户名\.codex。
• 可以查看当前 provider、model、SQLite 数据库状态和可用备份。
• 同步前先显示需要处理的数据库、Rollout 和索引数量。
• 点击开始同步前，会自动创建完整备份。
• 恢复备份前，也会再次创建安全备份。
• 支持恢复完整备份，也支持只恢复选中的项目或会话。
• 可以查看备份里的会话数量、项目数量和恢复范围。
• 支持导出备份列表，方便后续核对。
  下载地址在文章末尾

这个工具主要解决的是 Codex 本地历史记录的备份与恢复问题，不是云同步工具，也不会上传本地会话内容。

二、开始前准备

下载发布包后，先解压：

普通用户不需要安装 Python。工具会自动读取本机 Codex 数据目录。

默认目录一般是：

C:\Users\你的用户名\.codex

如果自动检测不到，可以在软件里点击“选择目录”，手动选择 .codex 文件夹。

建议在同步或恢复前，先关闭 Codex Desktop。因为工具会处理本地数据库和会话文件，关闭后操作会更稳。

---

三、5 步完成 Codex 历史备份与恢复

第 1 步：打开工具并检查目录

运行 CodexBak.exe 后，先看界面里的 Codex 目录是否正确。

【图 1：codexbak 工具首页与状态检测】

点击 检查状态 或 重新检测 后，工具会读取：

• Codex 目录
• SQLite 数据库
• 备份目录
• 当前 provider
• 当前 model
• 当前可用备份数量

这一步只是检查，不会修改本地文件。

第 2 步：查看同步前概览

检测完成后，可以看右侧和底部的同步概览。

重点看这几项：

• 数据库需要同步多少条。
• Rollout 文件需要同步多少条。
• 索引记录是否完整。
• 当前是否已有可恢复备份。

工具下载地址：codex恢复工具点击下载