Codex 会话跨设备迁移需同步元数据而非文件：用 codex-provider-sync 修复 Provider 切换导致的历史丢失；用 Codex Migrate 处理路径断裂；通过实时 Handoff 将运行任务迁至远程主机。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想把 Codex 里正在调试的项目上下文、未完成的代码生成任务、甚至带状态的自动化脚本，原样搬到另一台电脑上继续执行，而不是重新描述需求、重传文件、手动恢复变量——这需要同步的不是单个文件，而是会话元数据、线程索引和当前工作目录绑定关系。
用 codex-provider-sync 修复 Provider 切换导致的列表丢失
切换 model_provider 后历史会话“消失”，本质是 SQLite 索引与 rollout 文件中的 provider 字段不匹配。该工具只修正元数据，不碰聊天内容。
第一步：确认本地会话文件真实存在 → 打开终端，运行 ls ~/.codex/sessions/，能看到按日期组织的 rollout-*.jsonl 文件，说明数据完好。
第二步：安装并运行同步工具 → 执行 npm install -g codex-provider-sync && codex-provider-sync，工具自动扫描 ~/.codex 目录，比对 session_meta 中的 provider 与当前 config.toml 设置，批量更新 SQLite 和 session_index.jsonl。
第三步：重启 Codex Desktop → 不要跳过这步，旧进程缓存未刷新会导致界面仍为空白。
跨平台迁移会话：用 Codex Migrate 处理路径断裂
直接复制 .codex 文件夹在 macOS → Windows 或 WSL → Win native 场景下必然失败，因为 rollout 文件里硬编码了原始 cwd 路径，Codex 无法解析 /Users/alex/Projects/my-app 这类路径。
方法一：GUI 模式一键映射
下载 Codex Migrate 最新版（v0.8.3+），启动后选择「Import from macOS」→ 工具自动解析所有 rollout JSONL 中的 cwd → 弹出路径映射窗口，填入新设备上的对应根目录，例如：【/Users/alex/Projects → D:\Projects】 → 点击「Apply & Migrate」，会话按相对路径重建目录结构并写入新 SQLite。
方法二：CLI 批量处理
若已知全部项目都迁移到 D:\codex-projects，则运行：codex-migrate migrate --source ~/.codex --target D:\codex-projects --platform win --map "/Users/alex/Projects=D:\codex-projects"。注意 【--platform win 参数不可省略，否则生成的 SQLite 仍含 POSIX 路径】。
实时 Handoff：让任务在远程主机持续运行
适合正在跑长时间任务（如模型微调、CI 测试）时突然要合盖走人，要求上下文、变量、进程状态全量迁移。
在当前 Codex 聊天窗口输入：我要离开了，把正在跑的任务迁到 remote-server.example.com，让它在那边继续 → Codex 自动校验目标主机 SSH 可达性、Python 环境、磁盘空间 → 将 rollout 元数据 + 当前内存快照 + 未提交的 Git diff 打包加密 → 通过安全通道推送到 remote-server 的 ~/.codex/handoff/ 目录 → 在目标机执行 codex handoff resume 即可接续。
这一步必须确保 remote-server 已预装 Codex CLI 且版本 ≥26.527，否则 handshake 会失败。
