Codex 恢复会话:在 VPS 上安全继续任务

Codex 恢复会话:在 VPS 上安全继续任务 — 使用 Codex resume 在 VPS 上恢复已保存的会话,区分重新连接与继续执行,并检查工作区,避免在错误的代码副本中重复操作。
2026年11月18日2 分钟阅读
Share with

重构进行到一半,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 操作和远程服务都有各自的状态。我们会先检查这些状态,再让模型继续。

重新连接运行中的进程、恢复保存的上下文,或重建缺失的状态

大约 3 分钟运行你的第一个智能体

安装 Office Claws CLI,连接你的 Contabo 账户和 Codex 订阅,你的智能体就会拥有自己的 VPS 和办公室里的一张桌子。

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/月 + 你自己的 Contabo VPS · 密钥保存在你的钥匙串中

在需要恢复之前记录会话身份

在 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 恢复。可靠的恢复始于证据,而不是又一轮重试循环。

作者

Office Claws Team

在 Office Claws 构建 AI 智能体管理的未来。分享关于基础设施、安全和开发者体验的见解。

大约 3 分钟运行你的第一个智能体

安装 Office Claws CLI,连接你的 Contabo 账户和 Codex 订阅,你的智能体就会拥有自己的 VPS 和办公室里的一张桌子。

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/月 + 你自己的 Contabo VPS · 密钥保存在你的钥匙串中