Codex历史任务加载失败是因本地索引与Provider元数据未对齐或缓存损坏所致，可通过codex-provider-sync工具修复、重载VS Code扩展宿主或清空缓存并重建索引解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex历史任务加载不出来，表现为打开客户端后会话列表空白、点击“历史”无响应、或仅显示加载动画持续数秒以上不结束，此时不是数据丢失，而是本地索引与Provider元数据未对齐或缓存损坏导致界面无法挂载任务列表。
检查并修复Provider元数据同步
切换过model_provider（如从OpenAI切到Claude或自建Ollama）后，Codex Desktop会因SQLite数据库中provider字段不一致而拒绝加载对应会话，但原始.json文件仍完整保留在磁盘上。
方法一：使用codex-provider-sync工具一键修复
1. 打开终端，执行：npm install -g codex-provider-sync
2. 安装完成后运行：codex-provider-sync --fix
该命令会扫描~/.codex/storage/chats/下的所有会话文件，比对并统一写入当前激活的provider标识，【必须确保Codex已完全退出，否则文件被占用将跳过修复】。
3. 重启Codex Desktop，历史任务应立即可见。
强制重载VS Code中的Codex面板
如果你是在VS Code内使用Codex插件（如Codex Skill Host），面板空白或卡在标志页，说明扩展宿主未完成初始化，而非会话数据问题。
按 Ctrl + Shift + P（Windows/Linux）或 Cmd + Shift + P（Mac）打开命令面板→输入 Developer: Reload Window → 回车。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
若仍为空白，再执行 Developer: Restart Extension Host。这会终止并重建所有扩展运行时环境，Codex面板通常在2秒内完成渲染。
清空本地缓存并重建索引
缓存目录残留旧版索引文件会导致Codex启动时反复尝试解析失败的结构，跳过历史加载直接进入空状态。
第一步：关闭Codex所有进程（包括后台的codex、node、powershell等）
第二步：删除缓存目录
Windows用户执行：rd /s /q "%USERPROFILE%\.codex\cache"
macOS用户执行：rm -rf ~/.codex/cache
第三步：删除索引文件（关键步骤）
执行：rm -f ~/.codex/index.json → Codex下次启动将强制重建完整会话索引，耗时约3–8秒，期间勿操作任何命令面板。
