Codex
别让 Codex 碰浏览器:三次被卡住后,我把任务卡拆成了两半
作者在视频制作流水线里让 Codex 执行含浏览器操作的任务卡,结果连续多轮被登录、付费弹窗、权限检查卡住,甚至三次撞上同一个无法解决的浏览器凭证问题。复盘后他定下一条规则:浏览器步骤一律不派给 Codex,改由 Claude Code 或人工前置完成,拆分后的本地任务卡一轮通过。
今天就能做
- 检查你的任务卡模板,加上「人工前置条件」小节,把登录、付费弹窗、录屏权限、下载目录这些只有人能处理的事项在派发前清掉
- 给派发流程设一个硬性轮次上限(比如三轮),触发后强制拆卡或升级给人,避免 agent 反复撞同一堵墙
- 用「卡住了重试能不能解决」这个测试,把需要浏览器的步骤从 Codex 的卡上挪到 Claude Code 的验收步骤或人工前置里
第一集:六轮里五轮都停在浏览器
- 任务卡要求在在线设计工具里生成素材并录屏,Stage A 交给 Codex 跑了六轮
- 前五轮分别被卡在:未登录、出现 30 天试用弹窗、账号页服务器错误、录屏需要浏览器调试协议但权限未批准、下载文件落到了默认 Downloads 目录违反了目录边界
- 每一轮停下都是正确行为——Codex 没有乱猜、没有绕过检查、没有替用户点试用
- 真正的问题是任务卡:把五项只有人能解决的前置条件埋进了执行任务里,每项都浪费一整轮才发现
第二集:同一个错误连撞三次
- 转写测试需要访问网页并截图,三轮回执全是同一个报错:浏览器访问主机不可用
- 第 1 轮在 preflight 就失败;第 2 轮做完了所有本地工作(音频准备、一次转写测试、评分脚本,+166 行代码)后重试浏览器仍失败;第 3 轮只做了一次浏览器检查,失败即停
- 10 月 31 日找到根因:由派发脚本启动的 Codex 线程拿不到桌面版签发的浏览器插件凭证,和网络开关无关——第 1 轮开着网络照样失败
- 这张卡在 Codex 侧永远不可能成功,第 4 轮也会是同样结局
拆分之后:一轮通过
- 浏览器工作(打开页面、截图、上传)交给有浏览器扩展的 Claude Code,人只需连接一次扩展
- 本地生产(配音、字幕、合成、QA)成为新的 Codex 任务卡,授权段关闭网络和 MCP,验收清单写明禁止浏览器访问
- 拆出的本地卡一轮完成:229.5 秒视频、+447 行代码(预算 700 行)、25 项自检通过、human_action: none
- 之后两集共 9 份回执,3 份被卡,原因分别是引用不匹配、读写范围冲突、语音行截断——没有一个是浏览器问题
规则怎么落地:一条文字加三个脚本
- 派发 skill 的 pre-dispatch 清单里写一行:不派发浏览器步骤,开页面、截图、上传、登录操作改为验收步骤或人工前置
- check_card.py 拒绝任何缺少「## 人工前置条件」小节的任务卡,该小节必须列出登录、浏览器/录屏权限、付费档位、下载目录及是否已处理
- 同一个检查器拒绝第三轮:任务卡记录到第三轮就报错,要求拆卡或把证据交给人——按此规则第二集根本到不了第三轮
- codex_thread.py 默认禁用插件、应用和 MCP,开启需要显式参数,且即便开启浏览器凭证也不存在,堵死「不如开个插件试试」的弯路
可以直接抄走的做法
- 在任务卡模板里加「## Human prerequisites」小节(登录、浏览器/录屏权限、付费档位及试用弹窗处理方式、下载目录),前置检查发现缺失即失败
- 把工作分三类:只有人能做的(登录、2FA、付款确认)放进前置条件并在派发前完成;需要浏览器但不需要人的,交给真正有浏览器的那个 agent 做验收;其余本地工作关掉网络和插件再派发
- 一个判断标准:这一步卡住后,重试能解决,还是只有我能解决?如果只有你能,它就不该出现在执行者的卡上
- 作者也承认局限:脚本无法判断卡里是否含浏览器步骤,这个判断仍靠人;脚本能保证的是问题一定会被问到,且答错的代价最多两轮
原文:Keep browser steps away from your coding agent: three blocked rounds, then one clean pass
来源:DEV Community · 2026-11-17
查看原文本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。
登录后可以点赞、查看和发表评论