OpenAI Codex 中文文档(最近同步时间 2026.04.22)

计算机操作

让 Codex 在 macOS 上查看并操作图形用户界面。

在 Codex App 中,计算机操作目前可在 macOS 上使用;发布初期不在欧洲经济区、英国和瑞士提供。请先安装计算机操作(Computer Use)插件,然后在 macOS 提示时授予 Screen Recording(屏幕录制)和 Accessibility(辅助功能)权限。

借助计算机操作,Codex 可以查看并操作 macOS 上的图形用户界面。当命令行工具或结构化集成不足以完成任务时,可以使用它,例如检查桌面应用、使用浏览器、修改应用设置、处理尚未通过插件暴露的数据源,或复现只出现在图形界面中的 bug。

由于计算机操作可能影响项目工作区之外的应用和系统状态,请只把它用于范围明确的任务,并在继续前审查权限提示。

设置计算机操作

在 Codex 设置中打开 计算机操作(Computer Use),并点击 Install(安装) 安装计算机操作插件,然后再要求 Codex 操作桌面应用。当 macOS 请求访问权限时,如果你希望 Codex 查看目标应用并与之交互,请授予 Screen Recording 和 Accessibility 权限。

要使用计算机操作,请授予:

  • Screen Recording 权限,让 Codex 可以看到目标应用。
  • Accessibility 权限,让 Codex 可以点击、输入和导航。

什么时候使用计算机操作

当任务依赖图形用户界面,并且很难仅通过文件或命令输出来验证时,选择计算机操作。

适合的场景包括:

  • 测试 Codex 正在构建的 macOS 应用、iOS 模拟器流程或其它桌面应用。
  • 执行需要使用你的 Web 浏览器的任务。
  • 复现只出现在图形界面中的 bug。
  • 修改需要点击 UI 才能完成的应用设置。
  • 检查某个应用或数据源中的信息,而这些信息没有通过插件提供。
  • 让范围明确的任务在后台运行,同时你继续处理其它工作。
  • 执行横跨多个应用的工作流。

对于你正在本地构建的 Web 应用,请优先使用内置浏览器

启动计算机操作任务

在提示词中提到 @Computer Use@AppName,或者直接要求 Codex 使用计算机操作。请明确说明 Codex 应操作的应用、窗口或流程。

Open the app with computer use, reproduce the onboarding bug, and fix the
smallest code path that causes it. After each change, run the same UI flow
again.
Open @Chrome and verify the checkout page still works after the latest changes.

如果目标应用提供专用插件或 MCP 服务端,请优先使用这种结构化集成来访问数据并执行可重复操作。只有在 Codex 需要以视觉方式检查或操作应用时,才选择计算机操作。

权限与审批

计算机操作的 macOS 系统权限独立于 Codex 中的应用审批。macOS 权限决定 Codex 是否能查看和操作应用;应用审批决定你允许 Codex 使用哪些应用。文件读取、文件编辑和 shell 命令仍然遵循该线程的沙箱与审批设置。

使用计算机操作时,Codex 只能查看并操作你允许的应用。任务进行期间,Codex 会在使用你电脑上的某个应用前请求许可。你可以选择 Always allow(始终允许),让 Codex 以后无需再次询问即可使用该应用。你可以在 Codex 设置的 计算机操作(Computer Use) 区域中,从 Always allow 列表里移除应用。

Codex App 请求使用 Calculator 进行计算机操作的权限

Codex App 请求使用 Calculator 进行计算机操作的权限

Codex 在执行敏感或有破坏性的操作前,也可能再次请求许可。

如果 Codex 看不到或无法控制某个应用,请打开 System Settings > Privacy & Security,检查 Codex App 的 Screen RecordingAccessibility 权限。

安全建议

使用计算机操作时,Codex 可以查看屏幕内容、截取屏幕,并与目标应用中的窗口、菜单、键盘输入和剪贴板状态交互。请把可见的应用内容、浏览器页面、截图,以及目标应用中打开的文件都视为 Codex 可能在任务运行期间处理的上下文。

保持任务范围收敛,并在敏感流程中保持在场:

  • 每次只给 Codex 一个明确的目标应用或流程。
  • 你可以随时停止任务或接管电脑。
  • 除非任务需要,否则关闭敏感应用。
  • 避免要求 Codex 处理需要密钥的任务;如果必须处理,请保持在场并逐步审批。
  • 允许 Codex 使用应用前,先审查应用权限提示。
  • 只对你信任 Codex 今后自动使用的应用启用 Always allow
  • 对账户、安全、隐私、网络、支付或凭据相关设置保持在场。
  • 如果 Codex 开始操作错误窗口,请取消任务。

如果 Codex 使用你的浏览器,它可以与已经登录的页面交互。请像审查你自己正在执行的网页操作一样审查这些操作:网页可能包含恶意或误导性内容,站点也可能把已批准的点击、表单提交和登录态操作视为来自你的账户。若你希望 Codex 工作时自己继续使用浏览器,请要求 Codex 使用另一个浏览器。

该功能不能自动化终端应用或 Codex 自身,因为自动化这些应用可能绕过 Codex 的安全策略。它也不能以管理员身份认证,或代你批准电脑上的安全与隐私权限提示。

在适用时,文件编辑和 shell 命令仍然遵循 Codex 的审批与沙箱设置。通过桌面应用完成的改动,可能要等到保存到磁盘并被项目跟踪后,才会出现在评审面板中。你的 ChatGPT 数据控制设置也适用于 Codex 处理的内容,包括计算机操作截取的屏幕截图。


来源:https://developers.openai.com/codex/app/computer-use