codex会话默认本地存储不自动同步,文件位于~/.codex/sessions/下,按uuid命名的json格式保存完整对话;切换model_provider后需运行sync.py push指定provider以恢复侧边栏显示;codexbar仅同步非敏感元数据,会话内容永不上传。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

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 缓存中。











