Handoff 可迁移 Codex 中正在运行的任务快照，含未提交代码、AI 推理链、变量值和终端输出；需指令含“正在跑”，且目标设备登录同一账号并满足环境校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想把 Codex 里已经跑过的任务、调试过程、变量状态完整迁到另一台电脑上，而不是重新描述上下文或手动复制代码片段——这需要同步的不是文件，而是会话的“活态记忆”。
用 Handoff 实现无缝迁移
Handoff 是 Codex 原生支持的跨设备接力机制，它打包的是正在运行的任务快照，包括未提交的代码变更、AI 的推理链（reasoning）、本地变量值和终端输出流。
第一步：在当前设备上确保任务处于可暂停状态。Codex 会自动识别正在执行的长期任务（如构建、测试、数据清洗），但若任务已结束，Handoff 将只同步最终结果，不包含中间调试过程。
第二步：在聊天框中输入明确指令：【我要离开了，把正在跑的任务迁到远程主机上，让它在那边继续】。注意必须包含“正在跑”这个关键词，否则 Codex 默认只同步历史记录而非运行态。
第三步：确认目标主机已登录同一 Codex 账号，且网络可达。Codex 会自动校验远程环境是否安装了相同版本的 CLI、Python 解释器和项目依赖。校验失败时，迁移中断，不会覆盖远程已有状态。
用 CC Switch 切换 Provider 后恢复历史
当你在两台设备上分别使用 OpenAI Official 和第三方 API（如 Lobster AI）时，历史记录看似消失，其实是 reasoning ID 格式冲突导致的加载失败。
通过 codex-reset-radar.pages.dev 监控 Codex 使用重置窗口。轮询 current.json，检测窗口开启/关闭、预测等级变化以及概率跳变。
方法一：强制统一 provider ID（推荐长期使用）
将两台设备的 CC Switch profile 都配置为使用内置 openai ID，仅通过修改 openai_base_url 指向不同后端。这样 reasoning 对象的 ID 始终以 rs_ 开头，Codex 可无损加载。
方法二：按需同步本地历史到真实 provider（通用稳妥）
先执行 cc-switch --dry-run sync，确认警告数为 0；再运行 cc-switch sync。这一步会把当前设备的 JSONL 历史重写进目标 provider 对应的数据库表中，【不可逆，原 provider 历史将被覆盖】。
用 Codex CLI 手动 push 历史
适用于离线环境或自建 API 中转场景，跳过 UI 层直接操作本地存储。
关闭 Codex 桌面应用，避免数据库锁冲突。
执行命令：python ~/.codex/sync.py push Lobster AI。该脚本会读取本地 ~/.codex/history/ 下的 SQLite 文件，提取 task_id、timestamp、user_message、assistant_response 四个字段，按目标 provider 的 schema 重组后上传。
注意：此命令不传输 reasoning 内容，仅同步对话文本与时间戳。如需完整推理链，请改用 Handoff 或 CC Switch 方案。
