报错定位:先判断提示出现在哪一层
无论是「Computer Use plugin unavailable」、复数形态「computer use plugins unavailable」,还是「Computer Use plugin is unavailable」,含义都一致:当前桌面端没有提供可用的电脑控制能力。该提示本身并不直接指明原因,可能涉及设置未完成、更新后插件加载异常、残留宿主进程、会话状态或WSL执行环境阻断,少数情况下还会多类原因叠加。
建议根据实际表现选择对应分支处理,不要反复重装,也不要直接更换代理。
- 设置页持续显示unavailable:指向未安装、未开启或未授权,走官方设置流程。
- 更新后出现且日志含EBUSY:指向残留进程持锁或缓存异常,走Windows相关分支。
- 仅当前聊天调用失败:指向会话未获得工具,走会话与环境分支。
- 以上均排除仍失败:按材料清单提交反馈。
需要明确:能聊天、能运行CLI、装过Chrome扩展,都不代表桌面应用控制已完成设置;聊天、命令行与应用控制三层彼此独立,互不充分。
设置与授权:功能未安装、未开启或系统权限缺失
Computer Use拥有独立设置入口和系统级授权,缺少任何一层都会显示unavailable。应按官方Computer Use文档逐项完成(此为官方设置指导,并非针对所有精确报错的官方修复):
- 在桌面客户端打开 Settings > Computer use,于Control下检查Any App;显示Install则跟随安装提示,已安装但处于关闭状态则开启。
- Mac用户需在系统隐私与安全性中,为Computer Use辅助应用完成屏幕录制与辅助功能授权;系统权限与应用批准是两层,均须完成。
- Windows用户应把要控制的目标应用保留在活动桌面可见。
- 团队工作区需确认管理员已允许;没有安装入口时,不要假设升级套餐即可解锁。
- 新建聊天后要求读取已打开的计算器窗口,以真实发现并读取目标为准,不以开关亮起为准。
边界提示:IDE扩展不支持plugins(见官方插件文档),不要把CLI或IDE插件支持等同于桌面控制能力。若本地分支均已排除,仍需对照网络出口差异,可参考 https://www.ipxss.com/ 了解海外AI网络方案。
进程持锁与插件缓存未重建
原因A:残留进程持锁
残留的extension-host.exe进程可能持有临时插件目录,导致启动时无法清理重建marketplace,助手路径解析失败。典型线索是EBUSY,路径落在临时marketplace的extension-host子目录,例如:EBUSY: resource busy or locked …\.tmp\bundled-marketplaces\openai-bundled\chrome\extension-host…
处理时按顺序操作:
- 完全退出客户端,在任务管理器按进程归属确认残留extension-host.exe后再结束;不要仅凭名称批量结束同名进程。
- 不确定归属时使用开始菜单的「重新启动」,休眠或合盖不算。
- 新建聊天读取记事本验证;有用户结束相关进程并完整重启后恢复,属单人组合操作,无法确定哪个动作单独起效。
原因B:更新后插件市场或缓存未正确重建
- 检查更新并完成要求的重启;设置中重新出现Install时按界面安装。
- 有用户更新后初装失败、重启再装成功,但没有确切修复版号。
- copyfile UNKNOWN不等于网络下载失败。
仅当日志明确指向缓存目录时才做高级处理:退出并释放持锁进程;核对CODEX_HOME真实位置,备份config.toml与相关目录;只把日志所指的过时子目录改名保留——.tmp/bundled-marketplaces与plugins/cache下的openai-bundled是两处,不能混删;启动后观察插件状态能否重建,不承诺重新下载或必定成功;失败则恢复目录并带新错误反馈。
红线:.codex可能含配置、认证与会话,不要整目录删除;不要用codex plugin marketplace add强行安装,openai-bundled被标记为reserved,该语法未经官方文档验证。设置、缓存、会话均排除后仍要对照出口,可参考 https://www.ipxss.com/ 的固定出口方案作为对照变量。
会话状态与执行环境差异
插件文件存在、开关已开启,并不代表当前聊天已获得工具。会话与环境分支需分列处理:
- 保留旧聊天,新建聊天并重选官方入口做最小操作;仅新聊天成功则暂在新聊天继续,旧会话另行反馈。
- 都失败时不要无限重开:有用户完整退出并开新线程仍失败。
- Any App开启但报告apps:[],这是运行时应用枚举为空,不是配置值问题。
- Mac:完成官方安装与权限后,旧版本有多人反馈从安装包取出Computer Use.app至Applications并启动后恢复。
- WSL:日志出现reason=wsl-disabled时确认Agent真正运行位置,用Windows原生本地任务对照,可用则暂在那里做;这是临时入口,不建议改应用副本或放开沙箱。
- 安装位置:有用户改装到C盘后恢复,但缺控制变量,不默认要求重装到C盘。
仍未恢复:反馈材料与网络说明
整理反馈材料时逐项备齐:
- About页版本、系统及架构、安装渠道。
- Agent执行位置、报错时间、完整提示。
- 相关脱敏日志、新旧聊天对照结果。
通过应用内反馈渠道提交,不带令牌、Cookie、私人会话或敏感路径。材料越完整,官方复现越快。Windows设置的Repair可尝试,但与重装一样不是已证实的通用修复,有用户重装、Repair、更新均未恢复。
网络需单独说明:保留已正常使用的合法连接条件,有明确网络错误再按该错误排查。有用户改代理后看到功能出现,仅为单人历史多变量反馈,不能称激活普遍需要代理;可用性受支持地区、工作区与产品状态影响,不能从本地设置均无效推出地区被限制,也不要通过换出口绕过功能限制。
常见问题 FAQ
结束进程或重启能解决问题吗?
有单人组合操作后恢复,不能确定哪个动作起效;完整重启不是休眠或合盖。
能删掉.codex目录重来吗?
不能。该目录可能含配置、认证、会话,不能称纯缓存;只把日志所指子目录改名。
新聊天成功说明什么问题?
说明插件与后端在、旧会话异常。暂在新聊天继续,旧会话另行反馈。
重装到C盘有用吗?
有用户恢复但缺控制变量,不默认要求;重装也非通用修复。
总结
Codex Computer Use plugin unavailable应按表现分流:设置页常显走官方设置流程,更新后查进程持锁与缓存重建,仅当前聊天失败换新聊天对照,Mac与WSL各有边界。社区办法都有反例,验收以真实控制目标应用为准。仍失败则按材料清单整理脱敏信息提交官方反馈;本地分支全部排除后仍要对照出口差异,再评估 https://www.ipxss.com/ 这类固定出口方案作为对照变量。