codex中断后应先判别类型再行动:光标闪烁为暂挂,等待10秒可续;退回$或econnreset需手动干预。立即保存含具体进度、卡点原因及下一步验证项的handoff.md,并确保agents.md声明其为上下文文件;推荐改用http协议替代websocket,并通过缩短任务粒度、设置git commit验收点来保障断点续传。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex执行中突然卡住、提示“Reconnecting”或直接中断,任务进度丢失,你得立刻恢复上下文继续推进,而不是重新解释项目结构或重复已做的排查。
先确认中断类型再决定动作
不是所有中断都需要重头来过。打开终端,观察当前线程状态:如果光标还在闪烁、命令未返回退出码,说明只是流式响应暂停,别急着关掉;如果终端已退回$提示符、或显示Error: read ECONNRESET,才是真中断。
前者等10秒,大概率自动续上;后者必须手动干预,否则下一条指令会从零开始重建上下文。
中断后立刻保存handoff记录
任务断在“正在检查auth模块的JWT验证逻辑”这一步,就写:【当前已确认login.py第42行调用verify_token(),但未进入其内部;下一步应查看token_utils.py中decode函数是否捕获了ExpiredSignatureError】。
不要写“还没查完”,要写“查到哪、为什么停、接下来验什么、预期结果是什么”。
把这段文字存为handoff.md,放在项目根目录。Codex下次加载项目时会自动读取它——前提是AGENTS.md里已声明handoff.md为上下文文件。
用HTTP协议替代WebSocket重连
方法一:临时绕过配置文件启动
在终端执行:HTTPS_PROXY=http://127.0.0.1:7890 codex --model-provider openai_http。
方法二:永久修改config.toml
打开~/.codex/config.toml,在文件最顶部顶格写入model_provider = "openai_http";再在任意空白处添加完整段落:[model_providers.openai_http]→name = "OpenAI HTTP only"→supports_websockets = false。
注意:model_provider必须顶格写,缩进会导致整个配置不生效。
缩短单次任务粒度并设置验收点
第一步:运行git status,确认当前工作区干净;
第二步:只让Codex检查auth/login.py中与密码校验相关的三处逻辑;
第三步:要求输出必须包含每处代码的行号、当前行为、预期行为、修改建议;
第四步:收到结果后,立即执行git add auth/login.py && git commit -m "review: login password check logic"。
每次commit就是一次可验证的验收点。下次中断,从这个commit哈希开始继续,不用再问“之前看到哪了”。











