Codex 提示浏览器不可用时，先保留第一条原始错误，再确认失败的是哪个浏览器入口。工具缺失、域名被拒和浏览器到不了网页，各要查不同的东西。先用准确 URL 做只读测试。
记录错误和运行环境
保存完整报错、时间、应用版本与构建号、操作系统、Codex 入口和浏览器工具。记录浏览器是否打开、地址是否改变、同一入口能否打开简单公开页。分享前隐藏账号、内部 URL 和凭据。导航前已经失败时，优先查工具是否可用、会话绑定和策略。
| 先验证 | 选哪个入口 |
|---|---|
| 缺少工具 | @Browser / Computer Use |
| URL 或标题不符 | URL / localhost |
| 出现登录页 | 核对配置与会话 |
检查工具与实际生效的权限
桌面内置浏览器先确认当前会话能用 @Browser，并核对本地浏览器开关。官方扩展查 Settings > Computer Use 和当前浏览器配置。即使本地开关显示开启，工作区规则也可能禁用功能或拦截站点来源。受管理时请管理员确认实际策略，本地文件无法覆盖组织拒绝。
区分浏览器连接与网页可达性
工具启动后，核对它实际访问的 URL。连接被拒通常表示目标没有监听，或连接在本地被拒。先查地址、实际端口、进程和网络路径，再决定是否重启 Agent。云端 localhost 指云运行环境。看到登录页说明浏览器已到达页面，但可能用了不同配置或尚未登录。
复现一次真实报错并确认恢复
同一个桌面 Codex 任务通过外部 Tabbit CLI 访问模拟 HTTP 页。先请求无监听的回环端口 60206，浏览器返回 net::ERR_CONNECTION_REFUSED。只把目标换成实际监听的 60205，同一浏览器任务和标签页返回 HTTP 200、标题 Browser Connection Restored 和标记 B03-RECOVERED。桌面安装包版本 26.1029.61003，构建 24614。这次验证的是传输层恢复，未测试原生 Browser Use 权限或云端线路。
GET http://127.0.0.1:60206/ → net::ERR_CONNECTION_REFUSED
GET http://127.0.0.1:60205/ → HTTP 200 → B03-RECOVERED| 环境 | 先验证 |
|---|---|
| 60206 | ERR_CONNECTION_REFUSED |
| 60205 | HTTP 200 · B03-RECOVERED |
仍失败时按同一条件复查
对于受支持的扩展，OpenAI 文档建议检查站点是否被屏蔽、更新应用、确认扩展装在当前配置、开启新会话再试，必要时重启应用。每次只改一个条件，用相同入口和目标重复只读检查，并保存两次工具结果。如果仍看不到预期标记，按官方渠道提交原始错误。
真实反馈可以提供哪些线索
一位 r/codex 用户说桌面可用，但另一个 CLI 或编辑器会话失败。另一位说浏览器标签可见，访问时却报已保存权限无法验证。可据此分别查入口和权限。个案不能证明故障同源，论坛里改文件的方式也不能当作通用修复。
r/codex · Browser access r/codex · Saved permissions
重启 Codex 就能恢复浏览器访问吗？
重启可能清除旧会话状态。站点被拒、工具缺失、端口错误或云端网络问题，需要各自排查。
常见问题
重启 Codex 就能恢复浏览器访问吗？
重启可能清除旧会话状态。站点被拒、工具缺失、端口错误或云端网络问题，需要各自排查。
云端 Codex 能直接访问笔记本的 localhost 吗？
工具启动后，核对它实际访问的 URL。连接被拒通常表示目标没有监听，或连接在本地被拒。先查地址、实际端口、进程和网络路径，再决定是否重启 Agent。云端 localhost 指云运行环境。看到登录页说明浏览器已到达页面，但可能用了不同配置或尚未登录。
找不到 @Browser 时查什么？
桌面内置浏览器先确认当前会话能用 @Browser，并核对本地浏览器开关。官方扩展查 Settings > Computer Use 和当前浏览器配置。即使本地开关显示开启，工作区规则也可能禁用功能或拦截站点来源。受管理时请管理员确认实际策略，本地文件无法覆盖组织拒绝。
怎样确认修复生效？
对于受支持的扩展，OpenAI 文档建议检查站点是否被屏蔽、更新应用、确认扩展装在当前配置、开启新会话再试，必要时重启应用。每次只改一个条件，用相同入口和目标重复只读检查，并保存两次工具结果。如果仍看不到预期标记，按官方渠道提交原始错误。
浏览器失败时应记录什么？
保存完整报错、时间、应用版本与构建号、操作系统、Codex 入口和浏览器工具。记录浏览器是否打开、地址是否改变、同一入口能否打开简单公开页。分享前隐藏账号、内部 URL 和凭据。导航前已经失败时，优先查工具是否可用、会话绑定和策略。