OpenAI Codex 中文文档(最近同步时间 2026.04.22)

内置浏览器

在 Codex App 线程中与 Codex 共享渲染后的网页视图。

内置浏览器让你和 Codex 可以在线程内看到同一个渲染后的网页。构建或调试 Web 应用时,如果你希望预览页面并附上可视化评论,可以使用它。

它适合本地开发服务器、基于文件的预览,以及不需要登录的公开页面。对于依赖登录态或浏览器扩展的内容,请使用你的常规浏览器。

你可以通过工具栏、点击 URL、在浏览器中手动导航,或按 Cmd+Shift+B(Windows 上为 Ctrl+Shift+B)打开内置浏览器。

请把页面内容视为不可信上下文。不要把密钥粘贴到浏览器流程中。

Codex App 在本地 Web 应用预览中显示浏览器评论

Codex App 在本地 Web 应用预览中显示浏览器评论

预览页面

  1. 集成终端中启动应用的开发服务器,或通过本地环境动作启动。
  2. 点击 URL 或在浏览器中手动导航,打开一个无需认证的本地路由、基于文件的页面或公开页面。
  3. 对照代码 diff 审查渲染后的状态。
  4. 在需要改动的元素或区域上留下浏览器评论。
  5. 要求 Codex 处理这些评论,并保持范围收敛。

示例反馈:

I left comments on the pricing page in the in-app browser. Address the mobile
layout issues and keep the card structure unchanged.

评论页面

当 bug 只在渲染页面中可见时,可以用浏览器评论把页面上的具体反馈交给 Codex。

  • 打开评论模式,选择一个元素或区域,然后提交评论。
  • 在评论模式下,按住 Shift 并点击可以选择一个区域。
  • 点击时按住 Cmd 可以立即发送评论。

留下评论后,请在线程中再发送一条消息,要求 Codex 处理这些评论。当 Codex 需要做精确的视觉改动时,评论最有用。

好的反馈应足够具体:

This button overflows on mobile. Keep the label on one line if it fits,
otherwise wrap it without changing the card height.
This tooltip covers the data point under the cursor. Reposition the tooltip so
it stays inside the chart bounds.

保持浏览器任务范围收敛

内置浏览器用于审查和迭代。每个浏览器任务都应小到可以一次审完。

  • 说明页面、路由或本地 URL。
  • 说明你关心的视觉状态,例如 loading、empty、error 或 success。
  • 在确切需要改动的元素或区域上留下评论。
  • Codex 修改代码后,再审查更新后的路由。
  • 在 Codex 使用浏览器之前,要求它启动或检查开发服务器。

对于仓库改动,请使用评审面板检查改动并留下评论。


来源:https://developers.openai.com/codex/app/browser