Codex会话默认采用本地存储模式，不会自动同步到云端。相关文件保存在~/.codex/sessions/目录下，并以UUID命名的JSON格式保存完整对话内容。若切换了model_provider，需要运行sync.py push并指定对应的 Provider，才能恢复侧边栏中的会话显示。需要注意的是，CodexBar仅同步非敏感元数据，会话内容永不上传。

Codex 会话记录默认不会自动同步到云端，所有聊天历史和对话数据都会保存在本地磁盘的指定路径中，除非你主动启用特定的同步方式或手动执行同步操作。

本地会话存储位置与结构

Codex 会话文件以 JSON 格式存放在 【~/.codex/sessions/】 目录下，每个会话对应一个以唯一 UUID 命名的文件，文件中通常包含完整对话内容、时间戳、模型标识以及 Provider 元数据等信息。

该目录由 Codex 程序直接读写，不依赖任何远程服务或云端数据库。因此，无论是断网、重启设备还是日常离线使用，都不会影响本地会话文件的正常保存。

需要注意的是，如果你使用的是 Codex Desktop GUI 版本，其底层仍然调用相同的本地 session 存储路径，不会因为图形界面的不同而改变会话记录的保存逻辑。

手动触发 Provider 同步（恢复“消失”的会话）

切换 model_provider 后历史会话暂时不可见，主要原因是 Codex Desktop 的侧边栏只显示当前 Provider 关联的会话元数据，而不会自动扫描并展示全部 JSON 会话文件。

方法一：通过命令行手动强制同步元数据

第一步：确保 Codex 已关闭（否则 sync.py 运行时可能出现写入冲突）

第二步：执行 python ~/.codex/sync.py push Lobster AI

这一步会重新解析 【~/.codex/sessions/】 目录下的所有 JSON 文件，并将它们对应的 Provider 标签、会话标题、最后更新时间等元信息写入当前 Provider 的索引库中，从而让历史会话重新显示在侧边栏。

第三步：重启 Codex Desktop，刷新界面后即可看到已恢复的会话列表。

Cloud Sync（仅限 CodexBar）

CodexBar 是独立于 Codex 主程序的配套工具，支持跨设备同步部分使用统计信息和配置项，但不会同步原始会话内容。

它的同步范围严格限定为：API 调用次数、模型选择偏好、快捷键设置、窗口布局等非敏感元数据。

会话正文、代码片段、错误日志以及用户输入的任意文本内容，均【永不上传】，整个过程始终保留在本地 Keychain 或 SQLite 缓存中。