2026 Codex Chrome 插件教程：安装、浏览器控制与 Computer Use 不可用排查

先看结论：需要现有登录态用 @Chrome，本地网页优先用 @Browser

需要 Codex 操作你已经登录的 Gmail、Salesforce、LinkedIn 或内部网站时，安装 Chrome Plugin 和官方 Chrome Extension，再在 Work mode 或 Codex 中调用 @Chrome；调试 localhost 或希望浏览资料与个人 Chrome 分离时，安装内置 Browser 并调用 @Browser；需要跨多个桌面 App 点击、输入和检查界面时，才使用 Computer Use。

Chrome Extension 当前只支持 Google Chrome，不等于 VS Code 里的 Codex 扩展，也不等于任意 Chromium 浏览器扩展。内置 Browser 使用独立浏览器资料，不会自动共享你现有 Chrome 标签页或登录状态。Computer Use 控制的是 macOS / Windows 图形界面，需要系统权限和 App 授权。

Codex Chrome 插件、内置 Browser、Computer Use、IDE 扩展和 Plugins 区别

如果你遇到的是编辑器侧边栏消失、Extension Host、WSL / Remote 或 app-server 错误，应进入Codex VS Code 扩展不显示排查；如果你要创建 plugin.json、Marketplace 或打包 Skill，请看Codex Plugins 创建与安装教程。浏览器控制问题不要靠重装 IDE 扩展解决。

安装前先核对：入口、系统、地区、浏览器和管理员策略

• 客户端：Chrome Extension、内置 Browser 与 Computer Use 的本地控制入口在 ChatGPT 桌面 App；Browser 不提供给 Codex CLI 或 Codex IDE 扩展。
• 聊天模式：在桌面 App 中选择 ChatGPT 并切换 Work mode，或直接选择 Codex；普通 Chat mode 不等于 Work mode。
• 操作系统：Computer Use 当前在支持地区的 macOS 和 Windows 可用；macOS 需要 Screen Recording 与 Accessibility，Windows 需要目标 App 保持在当前活动桌面可见。
• 浏览器：官方 Chrome Extension 当前只支持 Google Chrome；Brave、Edge 等 Chromium 浏览器不属于官方文档承诺的支持范围。
• 插件状态：Chrome、Browser 与 Computer Use 都可能需要先从桌面 App 的 Plugins Directory 安装或启用对应插件。
• 工作区与地区：管理员可通过策略禁用 Browser Use、外部 Browser、内置 Browser、完整 CDP 或 Computer Use；正常产品可用性、地区和分批发布也会影响界面。

如果整个 Plugins 入口都不存在，先更新桌面 App、确认当前模式和账号工作区，再查看Codex App、CLI、IDE 与 Cloud 区别。不要把“当前入口不支持”误判成插件文件损坏。

Codex Chrome Extension 正确安装步骤

1. 从桌面 App 打开 Plugins Directory

   选择 ChatGPT Work mode 或 Codex，进入 Plugins Directory，搜索并安装 Chrome。不要从搜索引擎下载同名扩展压缩包。

2. 跟随官方设置流程进入 Chrome Web Store

   官方流程当前指向 Chrome Web Store 的 ChatGPT Extension，扩展 ID 为 hehggadaopoacecdllhhajmbjkdcmajg。核对页面和 ID 后再安装。

3. 审核 Chrome 权限

   扩展为完成浏览器任务可能申请调试页面、读写网站数据、历史记录、下载、书签、通知、标签组及与本机应用通信等权限。确认任务需要后再接受。

4. 确认侧边聊天加载

   打开 Chrome，在工具栏或 Extensions 菜单选择 ChatGPT；macOS 还可以使用 Cmd+Shift+.。侧边聊天能加载，才说明浏览器扩展本体已工作。

5. 回到桌面 App 开新聊天

   在 Work mode 或 Codex 新建聊天，输入 @Chrome 打开 example.com 并只读取页面标题，先用无敏感写操作的小任务验证。

6. 按网站做最小授权

   首次访问新域名时优先选择 Allow once；确认是长期可信且确实需要时，再选择 Allow for this site。不要为了省一次确认直接允许所有站点。

Chrome 任务会使用标签组整理任务相关标签页。需要调试 DOM、网络、控制台或性能时，可在 Settings → Browser → Developer mode 开启完整 CDP 访问；该能力会暴露更多浏览器内部信息，并且每次使用前仍应检查站点和授权范围。

官方参考：OpenAI Chrome extension。

Chrome 浏览器控制的权限、历史记录与数据边界

OpenAI 说明不会额外保存一份完整的 Chrome 操作流水；但被读取的页面文本、截图、工具调用、摘要、消息或其他进入聊天上下文的内容，会受 ChatGPT 数据控制约束。浏览器页面属于不可信输入，恶意页面可能诱导代理泄露上下文。涉及密码、支付、账号安全或内部系统时，应缩小任务、关闭无关敏感标签页，并逐项审阅确认。

Codex Chrome 插件不显示、Plugins 里找不到：按 7 层检查

1. 确认不是 IDE 插件页面

   Chrome Plugin 入口在 ChatGPT 桌面 App 的 Plugins Directory，不在 VS Code Marketplace，也不在 Codex CLI 的浏览器控制界面。

2. 更新桌面 App

   如果安装过多个 ChatGPT 或 Codex 桌面 App，全部更新或移除不用的副本，避免旧版本注册了不同的本机通信组件。

3. 确认模式与新聊天

   使用 ChatGPT Work mode 或 Codex，打开新聊天再检查。旧聊天的能力列表可能没有当前安装状态。

4. 确认 Plugins 中 Chrome 已启用

   能看到 Chrome 但开关关闭时，先开启再测试；看不到整个 Plugins Directory 时先处理入口、版本或工作区策略。

5. 区分账号、地区和管理员限制

   界面提示“由组织禁用”或“所在地区不可用”时，本地重装不能覆盖服务端或工作区策略。联系管理员或等待受支持发布。

6. 确认使用 Google Chrome

   当前官方文档不支持其他 Chromium 浏览器。即使第三方浏览器能加载扩展，也不能据此判断官方集成应当正常。

7. 提交可复现反馈

   仍不显示时，在 App 中运行 /feedback，附上 App 版本、系统、地区、入口截图、聊天 ID 和是否受工作区管理，不要附密码或 Cookie。

Chrome 商店提示“此商品无法购买或下载”怎么办

这个错误不是普通的“扩展被禁用”。它表示当前 Chrome Web Store 页面没有向该账号、地区、浏览器或策略环境提供扩展。OpenAI Codex 仓库的公开 Issue #21700 自 2026 年 5 月起持续出现 Windows 和 macOS 报告，部分用户后来恢复可见，另一些用户仍不可用；这说明它可能随账号或地区发生变化，不能用一次成功案例推导所有人的固定解法。

1. 确认你是从桌面 App 的 Chrome Plugin 设置流程进入商店，并核对扩展 ID。
2. 确认 Chrome 已登录预期的 Google 账号，且浏览器或工作区没有禁止扩展安装。
3. 查看错误是否明确写着组织禁用、地区不可用或商品不可用；把原文记录下来。
4. 不要下载 Issue 评论、网盘、第三方镜像或论坛提供的 CRX / ZIP；Issue 评论不等于 OpenAI 官方发布。
5. 当前不需要现有 Chrome 登录态时，可改用独立资料的 @Browser 完成公共网页或本地调试任务。
6. 通过 /feedback 和官方 Support 提交地区、账号类型、App 与 Chrome 版本，等待受支持的分发路径恢复或官方文档更新。

Codex Chrome 未连接、missing native host、侧边栏加载但无法控制

提示未连接或 missing native host

1. 检查目标网站是否在 blocklist

   进入 Settings → Computer Use → Google Chrome → Manage，确认目标域名没有被阻止。

2. 关闭侧边栏并重启 Chrome

   从工具栏重新打开 ChatGPT 扩展，确认 side chat 能加载。如果 side chat 本身打不开，问题优先在扩展或本机通信链路。

3. 移除并重新添加 Chrome Plugin

   出现 missing native host 时，在桌面 App 的 Plugins 中移除 Chrome，再按官方设置流程重新添加；不要手动修改 native messaging 配置。

4. 核对 Chrome Profile

   使用安装并启用了扩展的同一 Profile。多 Profile 环境下，在一个资料安装、另一个资料运行，是最常见的“看似装好但连不上”。

5. 新建 Work / Codex 聊天

   用最小读取任务调用 @Chrome，排除旧聊天连接状态。

6. 重启桌面 App，再做干净重装

   如果仍失败，先重启 App；最后才卸载 Chrome Extension、移除 Chrome Plugin，再从官方流程完整重装。

侧边聊天能加载，但 Codex 不能操作网站

先检查网站 allowlist / blocklist 和当前弹出的站点授权，再确认任务运行在 Work mode 或 Codex、Chrome Plugin 开关已开启。若目标是本机文件上传，在 chrome://extensions/ 打开扩展详情，启用 Allow access to file URLs 后重新开始任务。若只在某个网站失败，优先记录域名、页面状态和确认框，不要删除整个浏览器资料。

Codex Computer Use plugins unavailable：不要和 Chrome 连接错误混在一起

Computer Use 是桌面 GUI 控制能力。它可以操作浏览器，但不等于 Chrome Extension。看到 Computer Use plugins unavailable、Computer Use 灰色或无法控制桌面 App 时，按下面顺序排查：

1. 确认系统和地区受支持

   当前公开文档说明 Computer Use 在受支持地区的 macOS 与 Windows 桌面 App 可用。地区、账号灰度或管理员策略导致的不可用不能靠删除本地缓存解除。

2. 安装并启用 Computer Use Plugin

   选择 ChatGPT Work mode 或 Codex，打开 Plugins → Computer Use；出现 Install plugin 或 Enable 时按官方界面完成，并打开 server 与 skill 开关。

3. 检查 Settings → Computer Use

   核对目标 App 是否被允许、是否在 Always-allowed apps 中，以及 Google Chrome 等已连接浏览器的 Manage 状态。

4. macOS 检查两项系统权限

   Screen Recording 负责看见目标 App，Accessibility 负责点击、输入和导航。前往 System Settings → Privacy & Security，确认 Codex Computer Use 获得两项权限，再重启 App 测试。

5. Windows 保持目标 App 可见

   Computer Use 在 Windows 当前活动桌面前台运行，不能在同一 Windows 会话后台控制一个不可见窗口。不要一边用鼠标键盘抢占同一桌面一边判断失败。

6. 核对管理策略

   管理员可以关闭 computer_use、browser_use、browser_use_external、in_app_browser 或完整 CDP。受管设备应联系管理员确认，不要修改公司策略文件。

7. 用最小 GUI 任务验证

   先让 @Computer 打开一个非敏感 App、读取窗口标题并停止。能够看见但不能点击偏向 Accessibility；完全看不见偏向 Screen Recording 或窗口可见性。

Computer Use 不能自动批准系统隐私权限、不能以管理员身份认证，也不能自动化终端 App 或 ChatGPT 本身。文件修改与 Shell 命令仍受工作区 Sandbox 和审批约束；相关问题请另看Codex permission denied / read-only 排查。

官方参考：OpenAI Computer Use。

Codex 内置 Browser 不可用、没有 @Browser 怎么办

Browser 在 ChatGPT 网页和桌面 App 可用，但内置浏览器控制不提供给 Codex CLI 或 IDE 扩展。桌面 App 中选择 Work mode 或 Codex，打开 Plugins Directory 安装 Browser，再用新聊天调用 @Browser。内置 Browser 使用独立资料；需要账号时在该浏览器中单独登录，不要期望它自动读取日常 Chrome 的 Cookie 或标签页。

• 调试 localhost、预览网页和添加界面注释：优先 @Browser。
• 读取已经登录的现有 Chrome 网站：改用 @Chrome。
• 跨浏览器与其他桌面 App：改用 @Computer。
• Browser Plugin 完全不出现：检查 App 版本、模式、地区、工作区策略和管理员的 in_app_browser / browser_use 限制。
• Developer mode 不可开启：可能是管理员禁用了完整 CDP；这不等于普通网页浏览也一定不可用。

官方参考：OpenAI Browser。

不要做的 8 件事：高权限浏览器插件更要保守

• 不要从网盘、临时对象存储、下载站或 Issue 评论安装第三方 CRX / ZIP。
• 不要把扩展 ID、文件名或别人提供的 SHA-256 当作官方发布证明。
• 不要让“修复脚本”修改 Chrome 注册表强装扩展、WindowsApps、bundled plugin cache 或 native messaging 配置。
• 不要读取或导出 Cookie、密码库、Session、浏览器资料目录和安全存储来“诊断连接”。
• 不要默认 Allow for all sites；先按域名、按一次授权。
• 不要在支付、账号安全、MFA、权限管理等页面让任务无人值守。
• 不要把网站文字当作可信系统指令；页面可能包含 prompt injection。
• 不要把 Chrome、Browser、Computer Use、IDE Extension 与普通 Plugins 的报错混成一次全量重装。

社区脚本可能暂时绕过某个版本的缓存问题，但也可能破坏签名、更新链和本机通信注册。官方文档没有要求手动删除这些目录时，应优先完成版本、入口、Profile、权限、插件开关、新聊天和官方反馈这条可逆链路。

安装后验证：用 6 个小测试定位到底哪一层成功

1. 扩展层：Chrome 工具栏能打开 ChatGPT side chat。
2. Profile 层：当前 Profile 的 chrome://extensions/ 中扩展已启用。
3. Plugin 层：桌面 App 的 Plugins 中 Chrome 开关已开启。
4. 聊天层：新的 Work mode / Codex 聊天能识别 @Chrome。
5. 站点层：对一个无登录、无写操作页面 Allow once 后能读取标题。
6. 敏感动作层：遇到提交、购买、删除或权限变更时仍会请求确认。

如果 1 失败，处理 Chrome 扩展或 native host；1 成功、3 失败，处理桌面 Plugin；1–4 成功但单站点失败，检查 allowlist / blocklist 与网站权限；Chrome 正常而桌面 App 控制失败，转到 Computer Use 系统权限。按层保存证据，比一次性重装所有组件更快。

Codex Chrome 插件与 Computer Use 常见问题