应先暂停并让codex归因报错原因,再通过handoff机制恢复未完成任务,或使用codex --replay-last等命令强制恢复上下文。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当Codex在执行任务过程中突然报错并中断,导致代码未写完、修改未保存、分析半途而废时,不能直接重发原指令或刷新页面——这会丢失已建立的上下文和阶段性判断。
先暂停,让Codex自己归因
在报错消息出现后,不要立刻输入“继续”或“再试一次”。直接发送一条新指令:“请分析当前报错原因,列出所有可能的触发点,并说明哪一项最可能导致本次中断。”
这一步必须做。Codex若跳过归因直接改代码,大概率重复踩坑。很多报错表面是语法错误,实际是权限缺失、路径不存在或上下文被截断。
确认是否需要重连或重启会话
方法一:检查左下角状态栏是否显示「Reconnecting」或「离线」。若显示绿色「已连接」但无响应,说明不是网络问题,而是任务卡死。
方法二:打开另一个终端,运行 ps aux | grep codex 查看是否有残留进程占着端口或锁着文件。存在时用 kill -9 [PID] 清理后再启动新会话。
【注意:如果之前没开启「自动重连」,断网或中断后刷新页面将永久丢失全部缓存】
用handoff机制恢复未完成任务
第一步:让Codex总结当前进度。发送:“请用handoff格式输出:已确认的问题、已排除的路径、已修改的文件、下一步该验证什么、哪些信息必须保留才能不重复劳动。”
第二步:复制这段handoff内容,新建一个对话窗口,把handoff全文粘贴进去,末尾加一句:“请从此处接手,不要重读项目结构,不要重跑已通过的测试,只执行handoff中明确指出的下一步。”
第三步:观察它是否跳过冗余动作。如果仍从头开始ls目录或cat所有配置文件,说明handoff未被有效识别,需手动删掉其中描述性语句,只留事实性条目(如“auth.py第42行空指针异常”“已确认JWT密钥未加载”)。
这一步决定恢复效率。没有handoff的重试,等于让新Agent重新拆一遍发动机罩。
遇到ECONNRESET类报错的强制恢复操作
方法1:在终端中按下 Ctrl + C 中止当前流式请求。
方法2:确认Codex CLI进程已退出后,执行 codex --replay-last(仅限v2.8.3+版本),该命令会自动载入上一次中断前的完整上下文快照。
方法3:若CLI不支持replay,进入项目根目录,找到 ./.codex/cache/last_session.json,用文本编辑器打开,提取其中的 "prompt" 和 "history" 字段,手动构造新会话。
【关键前提:.codex/cache目录必须存在且未被Git忽略】











