Codex 内置浏览器
Codex 桌面应用里有一个内置浏览器,可以预览你的网站或应用、直接在页面上留下视觉反馈,还能让 Codex 自己点一遍来测试改动。下面讲怎么打开、标注怎么用、哪些设置要注意,以及浏览器不见了或 Codex 用不了它时该查什么。
更新于 2026年11月8日 · 阅读约 6 分钟
先说结论
- 在哪里: 在 Codex 桌面应用里(ChatGPT 桌面应用的一部分),随应用一起安装。Codex CLI 和 IDE 插件里没有。
- 能打开什么: 本地应用,比如
http://localhost:3000;本地文件页面;以及线上网站。 - 怎么打开: 点 New tab 输入网址,或者点聊天里的链接,或者按 Cmd+T(Windows 和 Linux 上是 Ctrl+T)。
- 怎么让 Codex 用它: 在消息里提到
@Browser,Codex 就会打开页面、点一遍、检查结果。 - 怎么提反馈: 点 Annotate,点选一个元素或拖选一块区域,写下评论,然后让 Codex 处理这些评论。
本文依据 OpenAI 的 Browser 文档,截至 2026 年 11 月 8 日。
打开页面
- 新标签页: 点 New tab,输入网址。在地址栏输入时会匹配你的历史记录,其他内容会用 Google 搜索。
- 从聊天打开: 点 Codex 给你的网址,比如它刚启动的开发服务器地址。
- 快捷键: Mac 上 Cmd+T,Windows 和 Linux 上 Ctrl+T。
- 布局: 选 Enter full view 或 Enter split view。Cmd+Shift+B(Ctrl+Shift+B)可以从全屏切回分屏,或者切换聊天旁边的标签页。
本地应用的话,先让 Codex 启动开发服务器并告诉你地址,再打开。Codex 改完之后,先重新看一遍页面再继续。
让 Codex 自己用浏览器
想让 Codex 自己在页面里操作,比如打开页面、走一遍流程、复现 bug、确认修复是否生效,就在消息里提到 @Browser。
@Browser 打开 http://localhost:3000/settings,修改表单里的邮箱地址,保存,确认出现成功提示。然后在 390px 宽度下检查同一个页面,告诉我哪里出了问题。
@Chrome 不一样:它通过 OpenAI 的扩展控制你自己的 Chrome,需要另外配置。内置浏览器有自己独立的资料,不和你平时用的浏览器共享标签页或登录状态。任务需要账号时,可以直接在里面登录。
用标注提反馈
标注是告诉 Codex 页面上具体要改哪里最快的方法。
- 在浏览器工具栏点 Annotate,进入 Annotation mode。
- 点选一个元素,或者拖选一块区域。
- 写下评论并保存,需要几条就加几条。
- 发一条消息,让 Codex 处理这些评论。
样式上的修改用 Adjust,它在评论输入框旁边,可以调字体、文字、间距和颜色。发送前能先看到预览,比用文字描述「标题上面再多留一点空」快得多。
处理我在这个页面上的所有评论。没有评论的地方保持原样,样式修改用我们现有的间距和颜色 token。
需要注意的设置
- Settings > Browser > Agent permissions: 设置浏览、下载和上传的默认权限,也能给特定网站设例外。删除某个网站的自定义权限就会恢复默认。组织可以限制这些设置。
- 敏感操作: Codex 在提交信息或购买前会先请你确认。
- 下载: 默认存到「下载」文件夹,也可以换位置,或者打开 Ask where to save downloads。
- 清除浏览数据: 在 Settings > Browser 里选择时间范围和要删除的数据类型。
- 开发者模式: 打开 Enable full CDP access 后,Codex 可以有控制地使用 Chrome DevTools Protocol,做更深入的调试。在某个网站上使用前会先问你,管理员也可以关闭它。
内置浏览器里,Codex 不能自动上传文件。流程里需要上传时,请自己操作。
内置浏览器不能用?
CLI 和 IDE 插件里没有。 内置浏览器在那里不可用。在终端或编辑器里,可以让 Codex 改用 Playwright 这类工具,或者到桌面应用里打开页面。
页面打不开。 本地应用请确认开发服务器在运行,网址里的端口就是它输出的那个。可以让 Codex 启动或重启它。
Codex 在页面里点不了、输入不了。 确认你提到了 @Browser,并且 Agent permissions 允许访问这个网站,然后新开一个对话再试。
浏览器显示不可用,Windows 上尤其常见。 在 openai/codex 的 GitHub 上,Windows 用户报告过几种情况:设置里 Browser 插件显示不可用、出现「Browser is not available: iab」错误、浏览器能打开但 Codex 操作不了。那里报告的办法是:从 Microsoft Store 更新或重装应用,然后用 Windows 对这个应用执行 修复(Repair) 或 重置(Reset),再重启。效果因人而异,可以到 GitHub issues 查你所用版本的情况。
标注没反应。 确认每条评论都保存了,然后发了一条消息让 Codex 处理。不发消息,评论不会送出去。
组织禁用了某些功能。 管理员可以限制浏览器权限和完整 CDP 访问。如果某个设置是灰色的,请联系工作区管理员。
Codex Design 适合放在哪里
内置浏览器一次显示一个页面,很适合检查和修正正在做的界面。如果你想在决定之前,把一个界面的几个方向并排比较,Codex Design 会在 Codex 里加一块画布,每个方向都是一个可以选中、编辑的实时 HTML 页面。两者怎么配合,见 Codex 画布。
常见问题
Codex 内置浏览器在 Windows 上能用吗?
浏览器是桌面应用的一部分,桌面应用支持 Mac、Windows 和 Linux。有些 Windows 用户报告它显示不可用,上面的办法对其中一部分人有效。
内置浏览器能用我 Chrome 里的登录吗?
不能。它有独立的资料,不和你平时用的浏览器共享登录。可以在里面直接登录,或者用 @Chrome 配合 OpenAI 的 Chrome 扩展,在你自己的 Chrome 里操作。
Annotate 和 Adjust 有什么区别?
Annotate 是给元素或区域加评论。Adjust 是直接改元素的字体、文字、间距或颜色,并实时预览,这样 Codex 拿到的是你想要的确切数值。