跳到正文
Codex DesignBETA

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 页面上具体要改哪里最快的方法。

  1. 在浏览器工具栏点 Annotate,进入 Annotation mode。
  2. 点选一个元素,或者拖选一块区域。
  3. 写下评论并保存,需要几条就加几条。
  4. 发一条消息,让 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 拿到的是你想要的确切数值。

继续阅读

Codex Design 是独立开发的 Codex 插件,与 OpenAI 无关联,也未获 OpenAI 认可。