重构进行到一半,SSH 窗口突然消失。应该重新连接、恢复 Codex,还是从头开始?这是三种不同的操作。选错了,可能让两个代理同时修改同一分支,也可能重复已经完成的操作。
当进程已经退出、但保存的对话仍然可用时,我们使用 Codex resume 恢复会话。本文关注恢复时的任务身份与状态核对,而不是如何让进程持续运行。关于进程持久运行,请参阅后台任务指南。
Codex 恢复会话:重新连接不等于继续执行
官方非交互模式文档介绍了使用 codex exec resume <SESSION_ID> 继续已保存的任务。交互式 CLI 也支持 codex resume。制定恢复流程之前,请查看当前安装版本的 codex resume --help 和 codex exec resume --help。
| 情况 | 首先做什么 | 不要作出的假设 |
|---|---|---|
| SSH 断开,但 Codex 仍在 tmux 中运行 | 重新连接到已有的 tmux 会话 | 终端断开就说明代理已经停止 |
| Codex 进程退出,但服务器上仍有保存的会话 | 检查状态,再恢复选定的会话 | 对话能够恢复文件或外部操作的结果 |
| VPS 被替换,会话存储缺失 | 恢复仓库与任务说明,启动新任务 | Git 克隆中包含 Codex 对话历史 |
| 身份验证或套餐额度阻塞了任务 | 解决访问问题或等待额度恢复 | 恢复会话能够绕过认证或使用限制 |
恢复对话不是 VM 快照、文件系统回滚,也不是「恰好执行一次」的任务机制。文件、后台命令、Git 操作和远程服务都有各自的状态。我们会先检查这些状态,再让模型继续。
在需要恢复之前记录会话身份
在 VPS 上使用与原任务相同的 Unix 账号和 Codex 主目录。Codex 通常把本地状态保存在 ~/.codex 下;CODEX_HOME 可以更改位置。换账号或主目录,可能让已有会话看起来像是丢失了。使用 --ephemeral 启动的任务不会保留供以后恢复的会话历史文件。
交互式任务可以通过 codex resume 选择已保存的会话;已知身份时,使用 codex resume <SESSION_ID>。在自动化流程中,从 codex exec --json 发出的 thread.started 事件提取 thread_id,与主机、工作目录、分支和提交一起记录。结构化输出指南解释了为什么 JSONL 事件流与最终结果是两回事。
在共享执行服务器的恢复脚本中,避免使用 --last。最近的会话未必就是目标任务,尤其是多个代理使用同一账号时。明确的会话 ID 更适合作为恢复键,但它不是授权边界。
会话存储和事件日志应当保密。其中可能含有提示词、源码片段和命令输出。不要把整个 Codex 主目录复制到工单或产物归档中:它还可能包含认证材料。对仓库工作和任务记录进行访问受控的备份,并与凭据分开保存。
先检查工作副本,再继续一项任务
首先通过常用的 SSH 工作流重新连接主机。如果原任务使用了 tmux,先用 tmux ls 检查会话并连接到正确的会话,然后再考虑启动新任务。同时检查负责该任务的进程或服务。仅仅连接断开,并不能证明旧执行进程已经消失。
确认原执行进程停止后,我们再检查它的工作副本。以下示例只读取 Git 元数据和本地帮助;请把路径替换为原任务目录。
cd ~/work/product-api
pwd
git branch --show-current
git rev-parse HEAD
git status --short
git diff --stat
git diff --cached --stat
codex --version
codex exec resume --help将结果与任务记录对比。检查实际差异、未跟踪文件、测试产物,以及先前日志中的外部操作。工作树干净不代表什么都没发生:代理可能已经提交、推送,或者修改了远程系统。如果这些系统在任务范围内,请通过可信的只读接口核查。
如果仓库已经切换到其他分支或提交,先停止并理清差异,再恢复任务。不要用 git reset --hard 或删除未跟踪文件来走恢复捷径。保留未完成的修改;如果无法可靠地重建原环境,应根据审核过的交接说明新建会话。
检查之后,可以执行以下明确的非交互式续接。把 ID 替换为记录的值。它会发送一个新轮次,可能消耗 Codex 额度。重新确认当前版本实际生效的沙箱、审批策略与连接工具;下面的提示词只是指导,不是强制控制措施。
SESSION_ID='replace-with-recorded-session-id'
codex exec resume "$SESSION_ID" \
"First summarize prior progress and compare it with the current checkout. Do not edit files, run project commands, push, deploy, or repeat external operations. Report discrepancies and propose the next verification step."授权进一步修改前,先将回复与证据核对。代理的记忆是有用的背景,不是测试通过或远程操作完成的证明。不要把部署凭据放在执行服务器上,权限应独立实施;参阅沙箱与审批。
把恢复当成交接,而不是自动重试
我们在工作副本之外保留一份简短的恢复记录:任务 ID、主机、Unix 账号、Codex 主目录路径、会话 ID、工作目录、分支、起始提交、最后验证的阶段,以及尚未确认的外部影响。只保存主目录路径,不复制凭据内容。每完成一个审核过的阶段,就更新记录并保留相关测试输出。
这是由操作者维护的工作流,不代表 Office Claws 提供事务式会话恢复、自动会话迁移或幂等重试引擎。Office Claws 为你自己的 Contabo VPS 上的 Codex 代理提供 CLI 和桌面控制界面;本地会话保留、备份及恢复检查仍由你负责。
VPS 可以全天候可用,但这不保证某项任务永远运行。Office Claws 首个代理起价为 $4.99/月;VPS 单独付费,通过受支持的 ChatGPT 套餐使用 Codex 仍受使用额度限制。恢复会话不会重置限制,也不会让保留的上下文免费。各项成本的区别可见订阅与 API 费用对比。
我们的建议:在依赖夜间恢复前,先演练一次无害的任务中断。明确会话存在哪里,确认旧执行进程已经停止,对比工作副本与任务记录,然后通过明确的 ID 恢复。可靠的恢复始于证据,而不是又一轮重试循环。