# Codex Computer Use 不可用，从这几步开始

Codex 明明已经安装，设置里却显示 Computer Use unavailable；或者浏览器能读网页，却不能点击、输入。遇到这些情况，可以根据完整报错选择对应的处理步骤。插件未加载、系统授权不完整、浏览器控制通道没有初始化，处理方式各不相同。
![codex computer use.png](https://developer.qcloudimg.com/http-save/yehe-12868122/52789e9d35d43ccbd1442c7883e7fae7.png)

## 检查 Computer Use功能开关与连接方式

打开客户端的“设置 → Computer use”。如果“Control → Any App”显示 Install，按当前界面完成安装；如果开关关闭，将其启用。旧版可能显示 Computer Use 插件页，应按该版本的设置入口操作。受管理的工作区还要确认管理员是否允许使用该功能；地区和账号可用性以当前官方说明及客户端实际显示为准。

排查时需要区分三种情况：操作普通桌面应用，检查原生 Computer Use；通过 Chrome 扩展读写网页，检查扩展及控制连接；报错明确提到 iab，检查内置浏览器。Chrome 扩展连接成功，不等于所有桌面应用都已可控。

## 1. 让 Codex 检查并修复异常

如果还不清楚问题出在哪里，可以把下面这段话发给 Codex：

> 请排查 Codex Desktop 的 Computer Use 不可用问题。读取当前报错、应用版本和相关日志，判断故障发生在插件加载、系统权限、运行时还是浏览器连接层。检查内置插件是否完整、Chrome 控制通道是否初始化，以及自定义配置是否限制了必需环境。只修复已经确认的异常，修改前备份，保留其他配置和登录数据；不要关闭安全校验，也不要删除整个 .codex 目录。读取当前可用的官方 Computer Use／浏览器技能说明，按本版本的入口验证：除了列出应用或标签页，还要读取目标界面，并在空白测试页或未保存的测试窗口尝试一次简单点击或输入；不要在业务页面直接测试提交、付款或删除。告诉我还需要手动完成哪些授权、退出或重启步骤。

如果它只回答“无法使用”，继续要求它提供检查结果：哪个组件缺失、哪条配置异常、日志中出现了什么错误。让它根据诊断结果处理，而不是直接反复重装。


## 2. 更新后插件消失：退出应用，重建插件缓存

如果更新后出现以下情况，可以重点检查内置插件缓存：

- 设置显示 `Computer Use plugins unavailable`。
- Browser、Chrome 或 Computer Use 插件突然消失。
- 报错提到 `marketplace.json` 不存在、`EBUSY` 或文件被占用。

### 第一步：完全退出 Codex

保存正在进行的工作后，完全退出 Codex。只关闭窗口可能仍有后台进程运行。Windows 可以在任务管理器检查相关 Codex、extension-host 进程是否已经退出。

如果使用 Chrome 扩展，在浏览器扩展管理页暂停 Codex 相关扩展，避免插件文件继续被占用。

### 第二步：备份配置和缓存

按 `Win + E` 打开文件资源管理器，在地址栏输入 `%USERPROFILE%`，再打开其中的 `.codex` 文件夹。下面是默认位置；如果曾自定义 `CODEX_HOME`，需要确认桌面客户端实际使用的目录，不要改错另一套配置。

复制备份其中的 `config.toml`，并找到以下目录，将它们重命名为带日期的备份名称。这会重建该目录下整套内置插件缓存，其他内置插件也可能需要重新加载：

```text
%USERPROFILE%/.codex/.tmp/bundled-marketplaces/openai-bundled
%USERPROFILE%/.codex/plugins/cache/openai-bundled
```

例如，把目录名改成 `openai-bundled.backup-日期时间`，使用实际日期时间，避免与已有备份重名。如果目录不存在，跳过这一项，不需要手动创建空目录。不要删除整个 `.codex`，其中还可能保存登录信息、配置和历史数据。

### 第三步：重新启动并验证

正常启动 Codex，等待内置插件重新生成，检查插件是否出现并启用，再恢复 Chrome 扩展连接。随后让 Codex 列出可用应用或浏览器标签页，再读取界面并测试一次简单操作。仅列出列表成功，还不能确认控制功能已经恢复。

如果目录被占用，可以重启 Windows，并在重新打开 Codex 前重试重命名，不要强行解除占用。如果目录没有重新生成，或插件仍然不可用，保留备份并继续检查加载日志。缓存重建主要处理插件文件或加载状态异常；问题持续或再次出现时，应继续定位加载失败的原因，避免反复清理。

## 3. Mac 一直等待授权：检查是不是授权给了错误的应用

出现 `permissions are still pending`、`permissions are not granted`，或者反复要求录屏权限时，检查授权列表中的对象。

打开：

```text
系统设置 → 隐私与安全性
```

分别检查“屏幕录制／屏幕与系统音频录制”和“辅助功能”中的 **Codex Computer Use**。只给 Codex 或 ChatGPT 主应用授权，不一定意味着 Computer Use 的辅助程序已经获得权限。

如果录屏列表没有该辅助程序，可以在列表中点击“+”，按 `Command + Shift + G`，查看：

```text
~/.codex/computer-use/
```

找到实际安装的 `Codex Computer Use.app` 后添加并启用，再完全退出、重新启动客户端。不同版本的辅助程序位置可能不同，如果这个目录不存在，让 Codex 帮你定位当前安装路径。

同时检查应用设置中的 Computer Use 是否启用；若界面提供 `Control → Any App`，按界面完成设置和需要的应用批准。系统权限与应用内批准需要分别检查。

## 4. Chrome 能读不能点：重新初始化浏览器控制

如果 Codex 能复述当前网页，却不能点击、输入或跳转，并提示：

```text
Chrome control is unavailable
Codex Chrome native host is out of date
```

新建一个对话，并发送：

> 请初始化本次对话的 Chrome 浏览器控制能力，列出可用浏览器，确认已经接入可点击、可输入的控制通道，不要只读取标签页文本。连接成功后再执行我的网页操作；若失败，请返回原始错误。

重新初始化适用于控制通道未正确加载的情况；如果实际缺少组件或注册路径失效，需要继续修复对应组件。

如果仍然报错，检查 Codex 客户端与 Chrome 扩展是否已更新，并按客户端当前提供的连接流程重新设置。若日志明确指出 native-host 清单或目标程序不存在，让 Codex 检查注册路径是否仍指向旧版本，不要随意修改注册表。

## 5. 改过 config.toml：检查环境变量限制和旧路径

打开：

```text
~/.codex/config.toml
```

如果曾经添加过环境变量白名单，搜索 `include_only`。例如：

```toml
include_only = ["OPENAI_API_KEY", "PATH"]
```

这种过窄的自定义限制可能过滤运行时需要的环境。这里展示的是需要查找的配置行，不是让你新增这条配置；也不能仅凭文件中存在它就认定根因。

备份文件后，让 Codex 检查这条配置的所属区段，以及它是否影响当前版本的运行时。确认有关后，针对性调整限制并重启验证。不要为了修复而直接放开全部环境变量，也不要删除与问题无关的配置。

如果精确报错是 `failed admin policy verification`，还可以检查是否设置了 `CODEX_CLI_PATH`，且该变量仍覆盖为错误或失效的旧路径。只在确认是失效的自定义覆盖时移除它，再重启客户端；企业管理策略造成的拒绝应联系管理员，不能靠移除变量绕过。

## 6. 提示缺少 browser-service.mjs：检查 Browser 依赖

如果错误包含：

```text
Cannot find module ... browser-service.mjs
```

即使 Chrome 插件已经安装，也要检查它依赖的 Browser 运行时是否存在。

查看当前插件列表，确认 `browser@openai-bundled` 是否已安装并启用。以下命令适用于支持对应 plugin 子命令的版本，例如 26.818.41509 插件环境。运行 `codex --help` 检查可用命令；如果包含 plugin 子命令，查看 `codex plugin --help`，并确认 CLI 与桌面端使用同一配置目录。当前版本明确支持时，执行：

```bash
codex plugin list --available --json
```

只有确认官方内置 Browser 插件可用但未安装时，再按当前版本支持的方式补装。相关版本中使用的命令是：

```bash
codex plugin add browser@openai-bundled --json
```

如果当前版本没有该命令，使用客户端实际提供的插件管理入口，不要寻找来源不明的同名安装包。如果插件已经安装但文件仍缺失，应排查安装完整性和加载日志，不能只重复执行添加命令。完成后重开 Codex、新建任务，再分别测试标签页列表、页面读取和简单控制。

## 7. 旧任务突然失效：在桌面端新建本地任务

如果旧任务反复提示工具不可用、缺少控制工具，或出现 `Computer Use approval denied via MCP elicitation`，可以换一个新建的本地任务验证。

1. 打开 Codex 桌面端，直接新建任务；界面提供运行位置时选择 Local／本地。
2. 明确要求使用 Computer Use 操作目标应用；支持提及时，选择实际显示的 Chrome 或 Computer 入口。
3. 让它读取目标应用界面或列出浏览器标签页，并验证一次简单操作；确认可用后，把原任务的必要上下文复制过去。
4. 按新任务实际出现的提示完成授权，保留旧任务，不必删除历史记录。

如果从 Dot 或其他入口发起的任务缺少控制工具，但桌面端直接创建的本地任务能够操作，可以在这个本地任务继续工作。这是临时恢复工作的方法，不代表原入口的工具加载问题已经修好。新任务也失败时，继续检查插件、权限和运行时。

## 8. 安装在其他盘：尝试移回 Windows 系统盘

如果 Windows 客户端装在 D、E 等非系统盘，且插件或浏览器控制持续不可用，可以尝试通过系统提供的移动功能，把客户端移回系统盘。

1. 保存工作并退出客户端。
2. 打开“设置 → 应用 → 已安装的应用”，搜索实际安装的客户端名称，例如 Codex 或 ChatGPT，以本机显示为准。
3. 如果应用菜单提供“移动”，选择 Windows 所在的系统盘，等待系统完成迁移。
4. 重新启动客户端，新建本地任务，验证标签页读取、页面点击和输入。

这项操作用于排查非系统盘安装相关的路径问题，不表示所有非系统盘安装都会出错。没有“移动”按钮时，不要手工搬动 WindowsApps 文件夹；确需重新安装，应保留数据，并通过官方安装方式选择位置。

## 9. 更新后提示 native pipe 启动失败：换掉残留的旧进程

如果 Mac 更新后出现 `Sky Computer Use native pipe startup failed`，日志同时包含 `Sender process is not authenticated`，可以检查是否仍在使用更新前启动的运行进程。

1. 保存任务，完全退出 Codex，再重新打开。只重置 JavaScript 环境，可能仍会复用旧的宿主进程。
2. 如果通过 CLI 会话调用桌面控制能力，退出并重新启动发生故障的那一个 CLI 会话，再恢复任务。无需一口气关闭其他正常运行的会话。
3. 重新读取目标应用界面，然后尝试一次简单导航或点击，确认实际控制恢复。

也可以让 Codex 进行只读检查：当前控制宿主是否仍引用已被更新器替换或删除的旧文件。确认是旧进程残留后再重启对应会话；不需要重置所有系统权限，也不要批量结束不相关进程。

## 10. 内置浏览器报 Browser is not available: iab

如果明确报的是 `Browser is not available: iab`，可以在 Codex 桌面应用中打开并显示报错的同一个任务，然后重新初始化内置浏览器并访问目标网页。

这项操作针对内置浏览器不可用的情况，macOS 26.930.51102 等环境可以将其作为排查路径尝试。Windows 或其他版本是否适用，需要按实际结果判断；Chrome 扩展连接和原生桌面权限仍需分别检查。

## 11. Windows 报 0x80070003：检查启动环境，进阶处理

如果 Windows 本地新任务可以控制电脑，而 Dot 发起的任务报 `MXC`、`0x80070003`、trusted Node 启动失败，或随后出现 `EPERM: operation not permitted, chdir`，还可以检查控制运行时的启动环境。

建议使用已更新的官方客户端，并尝试第 7 节的本地任务路径。下面属于特定版本的非官方进阶处理，仅在运行时启动环境异常时考虑。针对 26.1007.21434、26.1007.71326 等相关环境，检查三个处理点：补齐进程缺失的 `SYSTEMDRIVE`、补齐 `LOCALAPPDATA`，以及避免以插件缓存目录作为工作目录。它属于特定版本的临时修复，不适合不看日志就直接套用。

可以把下面的诊断要求发给 Codex：

> 请只读检查这次 Computer Use 启动失败。记录 Windows、Codex Desktop 和控制运行时版本，定位当前实际加载的 cua-repl.mjs 启动文件。检查启动进程中的 SYSTEMDRIVE、LOCALAPPDATA 是否缺失或为空，以及工作目录是否位于当前 CODEX_HOME 的 plugins/cache 下。不要输出密钥和无关环境变量。只有日志与这些问题一致时，才给出最小补丁和原文件备份、还原步骤；不要关闭 MXC、沙箱或身份校验，也不要修改系统全局环境、注册表和目录权限。核对当前启动文件内容，确认新版是否已经包含相应处理；不要覆盖新版实现。

确认命中后，临时修复应限制在当前运行时启动脚本内：仅补缺失的进程级变量；仅当工作目录位于该插件缓存路径下时，切换到系统临时目录。修改前备份原文件，修改后检查 JavaScript 语法，再完全退出并重新打开实际执行任务的客户端。仅做一次 JavaScript 重置，不一定会重新加载启动脚本。

验证时除了列出应用或标签页，还应打开一个公开网页，尝试一次无副作用的点击。仍失败就还原备份；客户端更新可能覆盖补丁，更新后应重新诊断，不要自动把旧补丁覆盖到新版本。

## 反复重装仍无效？这些报错需要进一步定位

如果提示无法可靠确认当前浏览器 URL，并包含 `enforce policy`，说明控制流程因 URL 校验停止。网页能打开、网络连通，并不代表这个校验已经通过。不要通过关闭安全检查来处理，应记录完整报错、系统版本与客户端版本，通过客户端提交故障报告。

如果报错是 `missing field sandboxPolicy`，而且连最小的运行时测试都无法执行，可以更新官方客户端后复测。这类错误涉及运行时元数据，不能直接归因于浏览器缓存；如果更新后仍然存在，应记录版本和完整报错继续定位。

Windows 还要确认目标应用位于当前活动桌面、设备保持解锁。按照当前功能限制，不要一边在同一会话手动操作电脑，一边要求它在后台控制桌面。

## 总结

Codex Computer Use 不可用，可能涉及插件加载、系统权限、浏览器连接或运行时配置。插件消失可尝试重建缓存，Mac 已授权仍报错要核对辅助程序权限，Chrome 能读不能点则检查控制通道；旧对话失效，也可以通过新建本地任务尝试恢复。

每完成一项调整，都要验证界面读取、点击和输入是否正常。特定版本的临时修复应与实际报错匹配；问题持续时，保留完整错误和版本信息，避免反复重装或盲目修改配置。

Codex 明明已经安装，设置里却显示 Computer Use unavailable；或者浏览器能读网页，却不能点击、输入。遇到这些情况，可以根据完整报错选择对应的处理步骤。插件未加载、系统授权不完整、浏览器控制通道没有初始化，处理方式各不相同。

Codex Computer Use 一直 unavailable？最全11 个排查方向，告别反复重装！

Codex Computer Use 提示 unavailable、插件消失，或浏览器能读不能点怎么办？本文梳理 11 个排查方向，涵盖插件缓存、Mac 权限、Chrome 控制连接、运行依赖与 Windows 启动报错，并提供操作步骤和自查提示词，帮助定位故障，减少盲目重装。

人工智能

Codex Computer Use不可用？按此排查：先检查设置开关与插件，区分原生桌面、Chrome扩展或内置浏览器场景；报错插件消失则退出应用重建缓存，Mac权限问题核对辅助程序授权，Chrome能读不能点需初始化控制通道。旧任务失效可新建本地任务，最后结合版本与完整报错定位运行时配置。

代码解释

JavaScript

ChatGPT

Windows

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Codex Computer Use 一直 unavailable？最全11 个排查方向，告别反复重装！-腾讯云开发者社区-腾讯云

Codex Computer Use 一直 unavailable？最全11 个排查方向，告别反复重装！

Codex Computer Use 一直 unavailable？最全11 个排查方向，告别反复重装！

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐