跳到主要内容

本文为非官方中文翻译,内容以 OpenAI 官方英文文档为准。
官方来源:https://developers.openai.com/codex/app/chrome-extension

Codex Chrome 扩展程序

在管理浏览器权限、网站批准和浏览数据的同时,使用 Chrome 配合 Codex

Codex Chrome 扩展程序让 Codex 能够使用 Chrome 执行需要你已登录浏览器状态的浏览器任务。当 Codex 需要读取或操作 LinkedIn、Salesforce、Gmail 或内部工具等网站时,请使用它。

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

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

从 Plugins 设置 Chrome

从 Codex 设置该扩展程序:

  1. 打开 Codex 并前往 Plugins
  2. 添加 Chrome 插件。
  3. 按照设置流程操作。它会引导你安装 Codex Chrome 扩展程序,并批准 Chrome 的权限提示。
  4. 打开 Chrome,并确认 Codex 扩展程序显示为 Connected

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

@Chrome 打开 Salesforce,并根据这些通话记录更新账户。

如果 Chrome 尚未打开,Codex 可以将其打开。Chrome 浏览器任务会在 Chrome 标签组中运行,因此同一线程的工作会保持分组在一起。

控制网站访问

默认情况下,Codex 会在与每个新网站交互前先征求你的同意。Codex 会根据网站主机名生成提示,例如 example.com

当 Codex 请求使用某个网站时,你可以选择与任务需求和你的风险承受能力相匹配的选项:

  • 允许该网站用于当前聊天。
  • 始终允许该主机,这样 Codex 以后再次使用该网站时无需询问。
  • 拒绝该网站。

管理允许列表和阻止列表

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

从允许列表中移除某个域名意味着 Codex 在使用它之前会再次询问。从阻止列表中移除某个域名意味着 Codex 可以再次发起询问,而不是将该域名视为被阻止。

始终允许浏览器内容

如果你启用始终允许浏览器内容,Codex 在使用网站之前将不再请求确认。

浏览器历史记录

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

当 Codex 想要使用浏览器历史记录时,它会发起询问。Codex 会将历史记录访问范围限定在该请求内,且历史记录没有“始终允许”选项。

数据与安全

Chrome 扩展程序权限

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

  • 访问页面调试器
  • 读取并更改你在所有网站上的所有数据
  • 读取并更改你所有已登录设备上的浏览历史记录
  • 显示通知
  • 读取并更改你的书签
  • 管理你的下载内容
  • 与协作的本机应用程序通信
  • 查看和管理你的标签组

这些 Chrome 权限使扩展程序能够执行浏览器工作流。不过,在任务期间使用网站或浏览器历史记录之前,Codex 仍会使用它自己的确认、设置、允许列表和阻止列表。

Memories

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

OpenAI 会存储哪些浏览数据

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

你的 ChatGPT 和 Codex 数据控制适用于在上下文中处理的内容。除非确有必要且你在场逐一检查每个提示,否则请避免通过浏览器任务发送机密或高度敏感的数据。

故障排除

如果 Codex 无法连接到 Chrome,请先确认 Codex 尝试访问的网站不在 Settings 中的阻止列表里。如果该网站未被阻止,请按以下检查步骤进行排查:

  1. 从 Chrome 工具栏或 Chrome 的扩展程序菜单中打开 Codex 扩展程序。确保其显示为 Connected。如果显示已断开连接,或提到缺少本机宿主,请从 Codex 的 Plugins 中移除并重新添加 Chrome 插件,然后再次按照设置流程操作。
  2. 在 Codex 中,打开 Plugins 并确认 Chrome 插件已开启。如果插件已关闭,请将其打开并再次尝试该任务。
  3. 确保你使用的是安装了 Codex 扩展程序的同一个 Chrome 配置文件。如果你使用多个 Chrome 配置文件,请在当前活动配置文件中安装并启用该扩展程序。
  4. 启动一个新的 Codex 线程,然后再次尝试 Chrome 任务。这可以清除特定于线程的连接状态。
  5. 重启 Chrome 和 Codex,然后重试。如果扩展程序仍无法连接,请卸载 Codex Chrome 扩展程序,从 Plugins 中移除并重新添加 Chrome 插件,然后再次按照设置流程操作。
  6. 如果扩展程序显示为 Connected,但 Codex 仍然无法使用 Chrome,请在 Codex 应用中运行 /feedback,并在联系支持时附上线程 ID。

Codex Chrome 扩展程序显示已连接状态

上传文件

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

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

更改该设置后,再次启动 Chrome 任务。

显示已为 Codex 启用 Allow access to file URLs 的 Chrome 扩展程序设置