OpenAI Codex 中文教程

Codex Chrome 扩展

让 Codex 在需要登录态的浏览器任务中使用 Chrome。

Codex Chrome 扩展让 Codex 可以在需要你已登录浏览器状态的任务中使用 Chrome。当 Codex 需要读取或操作 LinkedIn、Salesforce、Gmail 或内部工具这类站点时,可以使用它。

对于本地开发服务器、基于文件的预览,以及不需要登录的公开页面,请优先使用内置浏览器。内置浏览器会把预览和验证工作留在 Codex 内部,不会使用你的 Chrome profile。

Codex 也可以根据任务需要在不同工具之间切换:有专用集成时使用插件,需要已登录浏览器上下文时使用 Chrome,处理 localhost 时使用内置浏览器。

从 Plugins 设置 Chrome

在 Codex 中设置扩展:

  1. 打开 Codex,进入 Plugins
  2. 添加 Chrome 插件。
  3. 按设置流程操作。该流程会引导你安装 Codex Chrome extension,并批准 Chrome 权限提示。
  4. 打开 Chrome,确认 Codex 扩展显示 Connected

插件设置完成后,启动一个新的 Codex 线程。当某个任务需要已登录网站时,Codex 可以建议使用 Chrome。你也可以在提示词中直接调用它:

@Chrome open Salesforce and update the account from these call notes.

如果 Chrome 尚未打开,Codex 可以打开它。Chrome 浏览器任务会在 Chrome tab groups 中运行,让同一线程的工作保持分组。

控制网站访问

默认情况下,Codex 在与每个新网站交互前都会询问。Codex 会根据网站 host 生成提示,例如 example.com

当 Codex 请求使用某个网站时,你可以根据任务和风险承受范围选择:

  • 仅允许当前聊天使用该网站。
  • 始终允许该 host,让 Codex 以后无需询问即可再次使用该网站。
  • 拒绝该网站。

管理允许列表和阻止列表

在计算机操作设置中,你可以管理域名的允许列表和阻止列表。允许列表包含 Codex 可以无需再次询问即可使用的域名;阻止列表包含 Codex 不应使用的域名。

从允许列表移除某个域名后,Codex 下次使用它前会重新询问。从阻止列表移除某个域名后,Codex 会恢复为可以再次询问,而不是继续视为已阻止。

始终允许浏览器内容(高风险)

如果开启 always allow browser content,Codex 在使用网站前就不会再请求确认。

浏览历史(高风险)

浏览历史可能包含敏感遥测、内部 URL、搜索词,以及你在已登录设备上的 Chrome 会话活动。如果你允许 Codex 访问浏览历史,相关历史记录可能会成为 Codex 用于完成任务的上下文。恶意或误导性的页面内容会增加 Codex 把这些数据复制到非预期位置的风险。

Codex 想使用浏览历史时会先询问。Codex 会把历史访问范围限制在本次请求内,并且浏览历史没有 always-allow 选项。

数据与安全

Chrome 扩展权限

安装扩展时,Chrome 会要求你接受扩展权限。权限提示可能包括:

  • 访问页面 debugger
  • 读取和更改你在所有网站上的全部数据
  • 读取和更改你在所有已登录设备上的浏览历史
  • 显示通知
  • 读取和更改书签
  • 管理下载
  • 与协作的原生应用通信
  • 查看并管理 tab groups

这些 Chrome 权限让扩展具备执行浏览器工作流的能力。Codex 在任务中使用网站或浏览历史前,仍会遵守自己的确认、设置、允许列表和阻止列表。

记忆

浏览器使用会遵循你的 Codex Memories(记忆)设置。如果 Memories 开启,Codex 在 Chrome 中工作时可以使用相关已保存记忆。如果 Memories 关闭,浏览器使用不会使用记忆。

OpenAI 会存储哪些浏览内容

OpenAI 不会从扩展中单独存储一份完整的 Chrome 操作记录。只有当浏览器活动成为 Codex 上下文的一部分时,OpenAI 才会存储它,例如 Codex 从页面读取的文本、截图、工具调用、摘要、消息,或线程中包含的其它内容。

你的 ChatGPT 和 Codex 数据控制会适用于上下文中处理的内容。除非任务确实需要并且你在场逐步审查每个提示,否则不要通过浏览器任务发送密钥或高度敏感的数据。

故障排查

如果 Codex 无法连接 Chrome,请先确认 Codex 要访问的网站没有被加入设置中的阻止列表。若网站未被阻止,请按下面步骤检查:

  1. 从 Chrome 工具栏或 Chrome 扩展菜单打开 Codex 扩展。确认它显示 Connected。如果显示 disconnected,或提到缺少 native host,请从 Plugins 中移除并重新添加 Chrome 插件,然后重新走一遍设置流程。
  2. 在 Codex 中打开 Plugins,确认 Chrome 插件已开启。如果插件处于关闭状态,请开启后重试任务。
  3. 确认你正在使用安装了 Codex 扩展的同一个 Chrome profile。如果你使用多个 Chrome profile,请在当前活跃 profile 中安装并启用扩展。
  4. 启动新的 Codex 线程,然后重新尝试 Chrome 任务。这可以清理线程级连接状态。
  5. 重启 Chrome 和 Codex,然后重试。如果扩展仍无法连接,请卸载 Codex Chrome 扩展,从 Plugins 中移除并重新添加 Chrome 插件,然后重新完成设置流程。
  6. 如果扩展显示 Connected,但 Codex 仍无法使用 Chrome,请在 Codex App 中运行 /feedback,并在联系支持时附上 thread ID。
Codex Chrome 扩展显示 connected 状态

上传文件

如果某个 Chrome 任务需要从你的电脑上传文件,请允许 Codex 扩展在 Chrome 中访问 file URLs:

  1. 在 Chrome 中打开工具栏里的扩展图标,然后点击 Manage Extensions
  2. 在 Codex 扩展卡片上点击 Details
  3. 开启 Allow access to file URLs

更改设置后,重新启动 Chrome 任务。

Chrome 扩展设置中为 Codex 启用 Allow access to file URLs