换了电脑，Codex 项目为什么接不上？

电脑重装系统或换电脑后，即使重新登录同一个 Codex 账号，之前的项目也可能不会出现在本地列表里。本文不是商单，基于公开资料和日常使用观察整理。讨论范围限定在 Codex CLI 和 IDE 的本地保存会话，不涉及 Codex cloud chats。

Codex 项目依赖本地会话、项目文件和运行环境三个层面。换电脑时只同步文件，不等于项目能接着跑。

01 项目消失的三个层面

Codex 客户端会在 CODEX_HOME（默认 ~/.codex）下保存多类本地状态，包括配置、日志和缓存。history.jsonl 仅在启用历史持久化时存在。Codex cloud chats 是另一类独立对象，有不同入口。换电脑后，应实际观察 saved-session picker 或 codex resume --all 能否找到目标会话；找不到只能报告本轮未找到，不能反推内部机制或断言会话必然只在旧电脑。

项目文件是第二层。你写的代码、文档、素材，通常放在一个本地目录里。很多人把项目文件放到 OneDrive 或 iCloud 目录下，以为这样就算同步了。项目文件同步成功，只能证明文件可用。这不能证明目标 saved session 已在本轮会话列表中可见；需要分别检查文件和会话。

运行环境是第三层。依赖包、语言运行时版本、Shell 环境变量、API 密钥、Python 虚拟环境，这些绑定的基础设施，每台电脑需要独立配置。新电脑上没装对应的依赖，旧会话就算文件拷过来也跑不起来。

以上三层是作者用于排查的框架，不代表 Codex 的官方数据模型。项目文件同步完成后，还要分别检查目标会话在本轮是否可见，以及新电脑上的运行环境是否满足项目要求。

02 换电脑时该怎么做

换电脑时让 Codex 项目能接着用，需要主动做几件事，不能指望登录就自动完成。

打开新电脑上项目实际所在的目录，记录当前工作目录。先观察 codex resume 默认筛选结果，再用 codex resume --all 扩大范围。如果使用了自定义 sqlite_home，也需要在新电脑做对应设置。路径差异只作为待观察项，不是恢复 saved session 的官方必要条件。

重建运行环境。项目文件拷过来后，在新电脑上重新安装依赖。Python 虚拟环境需要重建，Node 版本需要确认兼容性。依赖清单来自项目的锁文件或文档，不要凭记忆手工凑。

记录版本信息。在旧电脑和新电脑上分别运行 codex --version，记录安装来源。版本差异可能影响命令语法和沙箱行为。仅在可重复对照显示版本差异相关时，再考虑临时对齐，保留升级恢复路径。

如果旧会话无法恢复，不要覆盖新电脑的 .codex，不要删除旧电脑上的任何状态。保留旧电脑为只读备份，先确认 CODEX_HOME 路径和自定义配置是否正确。

03 凭据安全：不要复制，重新登录

换到新电脑，优先走官方登录流程。运行 codex login status 检查账号和工作区是否与预期一致。

不要从旧电脑复制 auth.json。该文件可能包含访问令牌，应像密码一样保护。凭据也可能存储在系统 keychain 或 keyring 中，复制目录不一定继承登录状态。

不要把 .codex 上传网盘、提交 Git、发给他人或写入共享备份。环境变量、MCP token、自定义 provider 和 API 密钥也需要逐项重新配置，不得在文章、截图或仓库中泄露。

如果旧凭据曾被复制到不可信位置，执行 codex logout，并按登录方式撤销或轮换访问令牌和 API key。

04 迁移后怎么确认接上了

做完以上步骤，用可观察的指标逐项验证。

打开终端，尝试用 codex resume --all 或 saved-session picker 找到目标会话。确认当前工作目录和关键文件路径是否正确。运行 codex login status，确认账号和工作区与预期一致。选一个固定的只读任务，检查是否成功执行、约束满足、无路径或依赖报错。如果项目有确定性测试或构建流程，跑一遍确认通过。

模型输出不要求与旧电脑相同，只检查任务是否完成、约束是否满足、无路径或权限错误。

如果上述检查逐项通过，项目就算接上了。如果卡在某一步，回到对应层面排查，不要同时动多个变量。

05 把 Codex 项目当成多层结构来管

Codex 项目需要主动维护的不只是代码文件。本地会话、项目文件、运行环境和凭据配置，每一层都有自己的存放位置和迁移方式。换电脑是这个结构的压力测试，暴露的是平时没意识到的问题。

日常使用中，养成两个习惯：定期确认 codex login status 和项目路径；把项目依赖整理成清单。这样换电脑时，你知道该搬什么、该装什么、该检查什么，不会登录完账号以后对着空白的终端发愣。