Codex 桌面端侧边栏聊天记录消失：原因与修复方法 2026年7月25日

以下是用codex修复后给出的分析

问题表现

Codex Desktop 更新后，侧边栏中的“项目”和“最近”突然变成空白，但通过搜索仍然可以找到并打开以前的聊天记录。

问题主要出在新版侧边栏的显示模式和过滤条件。

原因分析

本次实际排查发现，新版会根据首次引导中保存的职业标签自动判断工作模式。例如职业标签为 legal（法律）时，客户端可能自动进入工作模式。

在部分自定义 API 登录环境中，该模式与本地会话侧边栏不兼容，前端状态会变成：

• 
  

  sidebarMode = "chatgpt"（使用 ChatGPT 侧边栏模式）

  
  


• 
  

  localConversationsAllowed = false（不允许显示本地会话）

  
  

因此，聊天记录本身还在，搜索也仍然有效，但“项目”和“最近”会被侧边栏过滤掉。

这是一次更新后的状态迁移或兼容性问题：旧版保存的职业标签被新版重新解释，并据此切换了侧边栏模式。只修改 workMode（工作模式）通常无效，因为客户端启动后还会根据 roles（职业标签）重新计算。

适用范围

以下特征同时出现时，可以优先按本文处理：

1. 
   

   更新 Codex Desktop 后才出现问题。

   
   


2. 
   

   “项目”和“最近”均为空。

   
   


3. 
   

   搜索仍能找到并打开以前的聊天记录。

   
   

如果搜索也找不到记录，可能是数据库、账号或数据目录问题，不一定属于本文所述故障。

通用修复方法

1. 完全退出 Codex Desktop

先关闭窗口，再确认系统托盘和任务管理器中没有残留的 Codex 进程。应用仍在后台运行时修改配置，退出时可能会把旧状态重新写回。

2. 备份配置

配置目录的一般位置为：

C:\Users\*\.codex\

需要修改的文件为：

C:\Users\*\.codex\.codex-global-state.json

在命令或脚本中，建议使用下面的写法，它会自动指向当前 Windows 用户：

%USERPROFILE%\.codex\.codex-global-state.json

修改前至少备份该文件；更稳妥的做法是备份整个 .codex 目录。

3. 清除职业标签和工作模式

打开 .codex-global-state.json，找到以下对象：

electron-persisted-atom-state

└─ electron:onboarding-welcome-v2-role-state

把其中两个字段修改为：

{

  "roles": [],

  "workMode": null

}

只修改这两个字段，不要删除聊天、项目、插件、MCP、授权或其他配置。

4. 重新启动并验证

正常启动 Codex Desktop。修复成功后，“项目”和“最近”应恢复显示，本地侧边栏状态应回到：

• 
  

  sidebarMode = "codex"（使用 Codex 本地侧边栏）

  
  


• 
  

  localConversationsAllowed = true（允许显示本地会话）

  
  

让 Codex 命令行自动修复的提示词

先完全退出 Codex Desktop，再在 Codex CLI 中发送下面这段提示词：

请修复当前 Windows 用户的 Codex Desktop 侧边栏聊天记录不显示问题。

​

已知现象：侧边栏的“项目”和“最近”都是空的，但搜索可以找到并打开旧聊天，说明聊天数据仍然存在。

​

请按以下要求处理：

1. 检查 %USERPROFILE%\.codex\.codex-global-state.json。

2. 不要读取、输出、复制或修改任何 API Key、令牌、密码及其他敏感信息。

3. 修改前把原文件备份到 %USERPROFILE%\.codex\ 下带日期时间的备份目录。

4. 在 electron-persisted-atom-state 中找到 electron:onboarding-welcome-v2-role-state。

5. 仅将 roles 设置为空数组 []，将 workMode 设置为 null；不要修改聊天、项目、插件、MCP、授权和其他配置。

6. 修改后重新读取相关字段，确认 JSON 有效，并告诉我备份位置和验证结果。

7. 如果字段结构与上述描述不一致，先停止修改，只报告实际结构和建议，不要猜测写入。