2026-09-18 更新
补丁已更新到 v0.3.0 双击修复版。下载工具 ZIP，完整解压后双击
Start-Repair.cmd，首次核对本机 HTTP／混合代理地址，再点击“检查并修复”。仍需 Windows 和 PowerShell 7。9 月 18 日再次更新 Codex 后，我实测双击工具仍可使用。这是我这台电脑上的反馈，不保证所有后续版本都能用。下面保留首版排查经过，使用方式与下载入口已同步更新。
最近用 Codex，我碰到一个反复出现的问题。对话还能继续，一到操作浏览器，就容易报错或超时。
我把排查线索交给它，让它直接动手修。中间经历了几次复测，有一次已经把配置写好了，重启后却又失效。最后，Chrome 和 Codex 内置浏览器都通过了实际操作测试，我又让它把这套修正整理成了一个开源小工具。
项目叫 Codex Browser Proxy Fix，目前已更新到 v0.3.0，中文和英文教程都有。
先交代适用范围。它针对的是 Windows 上浏览器控制进程没有收到所需本机代理配置的情况。新版会自动查找变化的插件版本与运行时目录，但启动器文件仍必须通过校验。遇到相似报错，可以参考这次排查，但别直接认定自己也是同一个原因。
最开始，有一条线索很像答案。
电脑里能看到几个不同的版本号，一份记录还指向了已经不存在的旧运行时。看到这些，很容易怀疑更新出了问题，新旧文件混在了一起。
继续查下去才发现，那份记录包含历史条目，当前使用的运行时文件还在。应用包和插件的版本号，也不能直接拿来判断是否冲突。
这一条没有成为修复依据。
后面查到了更具体的差异。我这次的网络环境需要本机代理，但浏览器控制工具启动后，没有收到相应的代理环境变量。
这里有个容易忽略的地方。Codex 的桌面界面和它启动的浏览器工具进程，并不一定拿到相同的网络配置。桌面应用还能工作，不能据此认定负责浏览器操作的那个进程也能正常访问所需服务。
于是，第一版修正给浏览器工具补上了代理配置。
单独启动新进程做检查，代理变量确实传进去了，工具也能正常启动、退出。但我重启 Codex 后再让它复测，还是失败。
配置被应用清掉了。
这次检查发现，当时使用的 Codex 版本会在启动时重新生成这部分设置，并删除同名的用户配置覆盖项。第一版方案虽然通过了单独的启动检查，却没有跨过应用重启这一关。
后来的修正改到了实际启动器上，先备份，再让它启动浏览器工具时补上代理默认值。已有的代理值优先保留。
又一次重启后，补丁还在，新启动的浏览器工具进程也收到了代理配置。
接下来没有停在“配置正确”这一步。我们分别测试了 Chrome 和内置浏览器，打开 example.com，读取标题和正文，点击 Learn more 进入 IANA 的说明页面，再返回上一页。
两种浏览器都完成了这些操作，最后关闭了测试标签页。此前的超时在这一轮没有重现。
到这里，才有了把这次修正分享出来的基础。
不过，自己电脑上能用的几行改动，直接发给别人照抄，还缺不少东西。别人可能用着不同版本，代理端口也未必一样，文件还可能已经被修改过。
所以开源时，我们把它做成了一个有明确限制的小工具。
命令行提供 Check、Apply、Restore 三个操作，分别用于检查、应用补丁和恢复原文件。v0.3.0 增加了修复窗口，可以直接点击“检查并修复”“恢复原文件”和“查看结果”。
Check 只读文件。它会核对启动器是否符合已验证的指纹。看到 Compatible，表示文件兼容，不代表已经查明你的故障原因。
Apply 要求用户明确填写自己的本机代理地址。文件不匹配就停止，通过检查才会备份和修改。用同一个地址重复执行，也不会重复插入补丁。
Restore 会检查备份和当前文件。备份损坏了，或者启动器后来又被改过，它会拒绝直接覆盖。
截至 v0.3.0，适用条件如下。
- Windows，使用 PowerShell 7 或以上版本。
- 保留旧版 26.903.71938 支持；新版可自动定位变化的插件版本与运行时目录，但只接受已识别的启动器文件内容。出现多个候选安装时，需要选择实际使用的版本，工具不会猜测最新版本。
- 使用本机、不带账号密码的 HTTP 代理，并且知道它实际监听的端口。
教程中的 7890 只是示例。如果你的代理端口不同，需要填写自己的端口。SOCKS 专用端口也不能直接当作 HTTP 代理端口使用。
首版工具有 14 项自动化测试，已经在本机和 GitHub 的 Windows 测试环境中通过。另一次针对原始启动器临时副本的检查，验证了工具启动、子进程收到代理，以及恢复后文件与原始内容逐字节一致。
v0.2.0 的发布说明记录了 16 项 Windows 回归测试，以及在本机完成的新版真实启动器副本修补、恢复和工具子进程代理传递验证。前面提到的 Chrome 与内置浏览器网页操作实测，属于首版排查记录。
v0.3.0 的本地测试和 GitHub Windows 自动测试也已通过，覆盖修补、恢复、设置保存、失败回退、启动超时清理及窗口构建和后台任务。这些自动测试不等于实际点击窗口验收，工具启动检查也不能代替真实网页操作。
这些检查能说明哪些操作已经验证过。更长时间的稳定性、其他应用版本和其他故障原因，还需要新的使用反馈。
如果你也遇到了类似问题，可以先看中文教程，判断是否符合这个场景。现在使用双击版，可以按下面几步操作。
- 下载文末的 v0.3.0 工具 ZIP，完整解压，不要在压缩包里直接运行。先打开自己的代理软件。
- 双击
Start-Repair.cmd，首次核对本机 HTTP／混合代理地址，点击“检查并修复”。窗口建议的地址也需要自己确认。 - 成功后，代理地址只保存在本机。下次双击，若只有一个候选插件，工具会自动检查修复；出现多个候选时先选择实际使用的版本。
- 显示“补丁已存在”时无需重复修改。需要撤销时，可点击“恢复原文件”。已经正常工作的手工修正也不必重新应用。
工具不会关闭 Codex 或 Chrome，不修改系统代理，也不上传个人设置或日志。
应用补丁后，记得等当前任务结束，完全退出并重新打开 Codex。需要测试 Chrome 时，也把 Chrome 打开。然后让 Codex 实际完成打开网页、读取、点击和返回，分别报告两个浏览器的结果。
应用升级、重装或强制刷新插件，可能覆盖这个临时补丁。更新后如果显示 Unsupported，就先停下，不要为了让检查通过而改掉校验值。
项目采用 MIT 许可证，只发布原创脚本、模拟测试和文档，没有包含个人配置、登录凭据、完整日志或官方程序文件。它是非官方工具，与 OpenAI 没有隶属或背书关系。
如果使用后仍然失败，反馈系统和插件版本、哪种浏览器失败，以及脱敏后的报错就够了。不要把账号信息、配置文件或完整日志贴到公开评论和 GitHub Issue 里。
感谢阅读，我们下一篇见。