Codex Computer Use（电脑操控）
Computer Use（电脑操控） 是 Codex 提供的一项功能：
允许 Codex 查看和操作 macOS 或 Windows 上的图形用户界面（GUI）
当命令行工具或结构化集成无法满足需求时，可以使用此功能来完成桌面应用操作、浏览器交互、应用设置调整等任务。
Computer Use（电脑操控）让 Codex 具备了「看」和「操作」桌面应用的能力
与命令行工具不同，Computer Use 可以直接与图形界面交互，包括点击按钮、输入文字、浏览菜单等操作
Computer Use（电脑操控）功能适用于需要视觉验证或图形界面交互的场景，
例如测试桌面应用、复现仅出现在 GUI 中的 bug、或者操作没有提供插件的数据源。
💤
Computer Use 会影响项目工作区之外的应用和系统状态
建议仅用于范围明确的任务，并在执行过程中留意权限提示。
环境设置
在使用 Computer Use 之前，需要先完成必要的插件安装和权限配置
安装 Computer Use 插件
打开 Codex 设置，找到 Computer Use 选项，点击 Install 安装 Computer Use 插件
安装完成后即可让 Codex 开始操作桌面应用
63%
37%
macOS 权限配置
在 macOS 上，需要授予以下两项系统权限：
#fmZpSRCAekbe text { white-space: pre; }#fmZpSRCAekbe .fb0 { stroke: var(--N900-FG, 0.15); }#fmZpSRCAekbe .fb0 {stroke: rgba(31,35,41, 0.15)}#fmZpSRCAekbe .fx0 { stroke-miterlimit: 10; }#fmZpSRCAekbe .fx0 {stroke-miterlimit: 10}#fmZpSRCAekbe .fa1 { fill: rgb(187, 191, 196); }#fmZpSRCAekbe .fa1 {fill: rgb(187, 191, 196)}#fmZpSRCAekbe .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#fmZpSRCAekbe .fx1 {font-style: normal}#fmZpSRCAekbe .fx2 { text-anchor: middle; }#fmZpSRCAekbe .fx2 {text-anchor: middle}#fmZpSRCAekbe .fx3 { dominant-baseline: central; }#fmZpSRCAekbe .fx3 {dominant-baseline: central}#fmZpSRCAekbe .fx4 { stroke: none; }#fmZpSRCAekbe .fx4 {stroke: none}#fmZpSRCAekbe .fc0 { fill: var(--text-caption); }#fmZpSRCAekbe .fc0 {fill: #646a73}#fmZpSRCAekbe .fa2 { fill: var(--text-link-disabled); }#fmZpSRCAekbe .fa2 {fill: rgb(187, 191, 196)}#fmZpSRCAekbe .fa3 { fill: rgb(59, 58, 56); }#fmZpSRCAekbe .fa3 {fill: rgb(59, 58, 56)}#fmZpSRCAekbe .fx5 { font: 700 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#fmZpSRCAekbe .fx5 {font-style: normal}#fmZpSRCAekbe .fx6 { text-anchor: start; }#fmZpSRCAekbe .fx6 {text-anchor: start}#fmZpSRCAekbe .fx7 { dominant-baseline: alphabetic; }#fmZpSRCAekbe .fx7 {dominant-baseline: alphabetic}#fmZpSRCAekbe .fc1 { fill: rgb(255, 255, 255); }#fmZpSRCAekbe .fc1 {fill: rgb(255, 255, 255)}#fmZpSRCAekbe .fx8 { font: 700 14px LarkHackSafariFont, LarkEmojiFont, SFMono-Regular, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Helvetica, "Noto Sans", Tahoma, "Nimbus Sans L", Arial, "Liberation Sans", "PingFang SC", "Hiragino Sans GB", "Noto Sans CJK SC", "Source Han Sans SC", "Source Han Sans CN", "Microsoft YaHei", "Wenquanyi Micro Hei", "WenQuanYi Zen Hei", STHeiti, SimHei, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji", system-ui; }#fmZpSRCAekbe .fx8 {font-style: normal}#fmZpSRCAekbe .fc2 { fill: rgb(51, 51, 51); }#fmZpSRCAekbe .fc2 {fill: rgb(51, 51, 51)}#fmZpSRCAekbe .fx9 { font: 400 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#fmZpSRCAekbe .fx9 {font-style: normal}#fmZpSRCAekbe .fb1 { fill: var(--N900-FG, 0.15); }#fmZpSRCAekbe .fb1 {fill: rgba(31,35,41, 0.15)}#fmZpSRCAekbe .fb2 { fill: rgb(212, 212, 212); }#fmZpSRCAekbe .fb2 {fill: rgb(212, 212, 212)}#fmZpSRCAekbe .fb3 { fill: rgb(232, 234, 246); }#fmZpSRCAekbe .fb3 {fill: rgb(232, 234, 246)}#fmZpSRCAekbe .fa4 { fill: var(--bg-body); }#fmZpSRCAekbe .fa4 {fill: #fff}AB123权限用途屏幕录制（ScreenRecording）辅助功能（Accessibility）允许 Codex 查看目标应用的界面内容允许 Codex 执行点击、输入、导航等交互操作
系统会在首次使用时弹出权限请求，按提示授权即可。
Windows 使用说明
在 Windows 上，Computer Use 需要在活动桌面上运行。
执行任务期间，目标应用必须保持在当前活动桌面上可见，Codex 会接管鼠标指针和键盘输入。
在 Windows 上，Computer Use 无法在后台运行。如果你需要同时继续使用桌面，建议使用虚拟机或第二台设备。
接下来我们只要在对话窗口让它打开一个网站，它就会使用 Computer Use:
使用场景
当任务依赖于图形用户界面，且难以仅通过文件或命令行输出来验证时，应选择 Computer Use。
适合使用 Computer Use 的场景
#PyTnatkVZLFt text { white-space: pre; }#PyTnatkVZLFt .fb0 { stroke: var(--N900-FG, 0.15); }#PyTnatkVZLFt .fb0 {stroke: rgba(31,35,41, 0.15)}#PyTnatkVZLFt .fx0 { stroke-miterlimit: 10; }#PyTnatkVZLFt .fx0 {stroke-miterlimit: 10}#PyTnatkVZLFt .fa1 { fill: rgb(187, 191, 196); }#PyTnatkVZLFt .fa1 {fill: rgb(187, 191, 196)}#PyTnatkVZLFt .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#PyTnatkVZLFt .fx1 {font-style: normal}#PyTnatkVZLFt .fx2 { text-anchor: middle; }#PyTnatkVZLFt .fx2 {text-anchor: middle}#PyTnatkVZLFt .fx3 { dominant-baseline: central; }#PyTnatkVZLFt .fx3 {dominant-baseline: central}#PyTnatkVZLFt .fx4 { stroke: none; }#PyTnatkVZLFt .fx4 {stroke: none}#PyTnatkVZLFt .fc0 { fill: var(--text-caption); }#PyTnatkVZLFt .fc0 {fill: #646a73}#PyTnatkVZLFt .fa2 { fill: var(--text-link-disabled); }#PyTnatkVZLFt .fa2 {fill: rgb(187, 191, 196)}#PyTnatkVZLFt .fa3 { fill: rgb(59, 58, 56); }#PyTnatkVZLFt .fa3 {fill: rgb(59, 58, 56)}#PyTnatkVZLFt .fx5 { font: 700 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#PyTnatkVZLFt .fx5 {font-style: normal}#PyTnatkVZLFt .fx6 { text-anchor: start; }#PyTnatkVZLFt .fx6 {text-anchor: start}#PyTnatkVZLFt .fx7 { dominant-baseline: alphabetic; }#PyTnatkVZLFt .fx7 {dominant-baseline: alphabetic}#PyTnatkVZLFt .fc1 { fill: rgb(255, 255, 255); }#PyTnatkVZLFt .fc1 {fill: rgb(255, 255, 255)}#PyTnatkVZLFt .fx8 { font: 400 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#PyTnatkVZLFt .fx8 {font-style: normal}#PyTnatkVZLFt .fc2 { fill: rgb(51, 51, 51); }#PyTnatkVZLFt .fc2 {fill: rgb(51, 51, 51)}#PyTnatkVZLFt .fb1 { fill: var(--N900-FG, 0.15); }#PyTnatkVZLFt .fb1 {fill: rgba(31,35,41, 0.15)}#PyTnatkVZLFt .fb2 { fill: rgb(212, 212, 212); }#PyTnatkVZLFt .fb2 {fill: rgb(212, 212, 212)}#PyTnatkVZLFt .fb3 { fill: rgb(232, 234, 246); }#PyTnatkVZLFt .fb3 {fill: rgb(232, 234, 246)}#PyTnatkVZLFt .fa4 { fill: var(--bg-body); }#PyTnatkVZLFt .fa4 {fill: #fff}AB12345678场景说明桌面应用测试浏览器操作Bug 复现应用设置调整非插件数据源macOS 后台任务跨应用工作流测试 Codex 正在构建的 macOS 应用、Windows 应用、iOS 模拟器流程或其他桌面应用执行需要通过 Web 浏览器完成的任务复现仅在图形界面中出现的 bug修改需要通过 UI 点击才能完成的应用设置查看或操作没有提供插件的应用或数据源中的信息在 macOS 上运行限定范围的后台任务，同时继续在其他地方工作执行涉及多个应用的自动化流程
对于本地构建的 Web 应用，优先使用 Codex 的内置浏览器（in-app browser），而非 Computer Use。
Windows 前台使用
在 Windows 上，Computer Use 运行在当前活动桌面上。
它无法在后台运行，因此在任务执行期间，Codex 会移动鼠标指针、输入文字并接管前台操作。
如果需要让 Windows 任务在你离开时继续运行，有以下两种方案：
•
保持 Windows 设备解锁并连接到互联网，通过手机的远程控制功能查看进度或发送后续指令。
•
在 Windows 虚拟机中运行 Codex，这样 Computer Use 接管的是虚拟机而非你的主桌面。
启动 Computer Use 任务
在提示词中提及 @Computer 或 @AppName，或者直接让 Codex 使用 Computer Use。
需要明确描述 Codex 应操作的具体应用、窗口或流程。
可以在输入框输入以下内容调用：
可以在输入框中使用 @Chrome 调用浏览器浏览器：
例如：
打开 @Chrome 并验证最新改动后结账页面是否仍然正常工作。
💤
如果目标应用提供了专用的插件或 MCP 服务器，优先使用这些结构化集成来进行数据访问和可重复操作。只有在需要视觉化检查或操作应用时才选择 Computer Use
权限与审批
Computer Use 的系统权限与 Codex 中的应用审批是分开的。
在 macOS 上，屏幕录制和辅助功能权限允许 Codex 查看和操作应用。
应用审批则决定你允许 Codex 使用哪些应用。
文件读取、文件编辑和 shell 命令仍然遵循线程的沙箱和审批设置。
应用权限管理
使用 Computer Use 时，Codex 只能查看和操作你允许的应用。
任务执行过程中，Codex 在使用某个应用之前会请求你的许可。
你可以选择 始终允许（Always allow），这样 Codex 以后使用该应用时就无需再次询问。
可以在 Codex 设置的 Computer Use 板块中，从「始终允许」列表中移除应用。
敏感操作审批
对于敏感或具有破坏性的操作，Codex 可能还会额外请求许可。
故障排除
如果 Codex 无法查看或控制某个应用，请按以下步骤检查：
•
在 macOS 上，打开 系统设置 > 隐私与安全性，检查 Codex 应用的「屏幕录制」和「辅助功能」权限是否已开启。
•
在 Windows 上，确保目标应用在当前活动桌面会话中可见。
锁定使用（macOS）
锁定使用（Locked Use）是 macOS 专属功能。
它允许 Codex 在你的 Mac 锁屏后继续使用 Computer Use，但需要你事先手动启用。
适用场景：从已连接的设备发起 Codex 任务，任务需要使用桌面应用，但 Mac 已经锁屏。
工作原理
启用锁定使用后，Codex 会安装一个 Apple 授权插件（authorization plug-in），参与 macOS 的解锁流程。
锁定使用的设计范围非常有限：它不是通用的远程解锁路径，也不允许其他应用或本地进程解锁电脑。
启用步骤
打开 Codex 设置 > Computer Use。
启用「锁定计算机使用（Locked computer use）」。
从已连接设备启动一个使用 Computer Use 的任务（在 Mac 屏幕锁定之后）。
安全机制
当 Codex 任务在 Mac 锁屏后通过 Computer Use 访问应用时，Codex 会临时解锁 Mac，同时阻止本地使用并保留锁屏保护。
解锁前，Codex 会验证该解锁请求是否属于一个活跃且受信任的 Computer Use 回合。
在该短暂的授权窗口之外，Codex 会拒绝解锁并提示你手动解锁。
锁定使用的安全保护
安全指南
使用 Computer Use 时，Codex 可以查看屏幕内容、截取屏幕截图，并与目标应用中的窗口、菜单、键盘输入和剪贴板状态进行交互。
目标应用中可见的应用内容、浏览器页面、截图和打开的文件，都可能被 Codex 在任务执行期间作为上下文处理。
安全操作建议
#QGBBPyHigDkE text { white-space: pre; }#QGBBPyHigDkE .fb0 { stroke: var(--N900-FG, 0.15); }#QGBBPyHigDkE .fb0 {stroke: rgba(31,35,41, 0.15)}#QGBBPyHigDkE .fx0 { stroke-miterlimit: 10; }#QGBBPyHigDkE .fx0 {stroke-miterlimit: 10}#QGBBPyHigDkE .fa1 { fill: rgb(187, 191, 196); }#QGBBPyHigDkE .fa1 {fill: rgb(187, 191, 196)}#QGBBPyHigDkE .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#QGBBPyHigDkE .fx1 {font-style: normal}#QGBBPyHigDkE .fx2 { text-anchor: middle; }#QGBBPyHigDkE .fx2 {text-anchor: middle}#QGBBPyHigDkE .fx3 { dominant-baseline: central; }#QGBBPyHigDkE .fx3 {dominant-baseline: central}#QGBBPyHigDkE .fx4 { stroke: none; }#QGBBPyHigDkE .fx4 {stroke: none}#QGBBPyHigDkE .fc0 { fill: var(--text-caption); }#QGBBPyHigDkE .fc0 {fill: #646a73}#QGBBPyHigDkE .fa2 { fill: var(--text-link-disabled); }#QGBBPyHigDkE .fa2 {fill: rgb(187, 191, 196)}#QGBBPyHigDkE .fa3 { fill: rgb(59, 58, 56); }#QGBBPyHigDkE .fa3 {fill: rgb(59, 58, 56)}#QGBBPyHigDkE .fx5 { font: 700 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#QGBBPyHigDkE .fx5 {font-style: normal}#QGBBPyHigDkE .fx6 { text-anchor: start; }#QGBBPyHigDkE .fx6 {text-anchor: start}#QGBBPyHigDkE .fx7 { dominant-baseline: alphabetic; }#QGBBPyHigDkE .fx7 {dominant-baseline: alphabetic}#QGBBPyHigDkE .fc1 { fill: rgb(255, 255, 255); }#QGBBPyHigDkE .fc1 {fill: rgb(255, 255, 255)}#QGBBPyHigDkE .fx8 { font: 400 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#QGBBPyHigDkE .fx8 {font-style: normal}#QGBBPyHigDkE .fc2 { fill: rgb(51, 51, 51); }#QGBBPyHigDkE .fc2 {fill: rgb(51, 51, 51)}#QGBBPyHigDkE .fb1 { fill: var(--N900-FG, 0.15); }#QGBBPyHigDkE .fb1 {fill: rgba(31,35,41, 0.15)}#QGBBPyHigDkE .fb2 { fill: rgb(212, 212, 212); }#QGBBPyHigDkE .fb2 {fill: rgb(212, 212, 212)}#QGBBPyHigDkE .fb3 { fill: rgb(232, 234, 246); }#QGBBPyHigDkE .fb3 {fill: rgb(232, 234, 246)}#QGBBPyHigDkE .fa4 { fill: var(--bg-body); }#QGBBPyHigDkE .fa4 {fill: #fff}AB12345678910建议说明一次一个目标随时可中断关闭不必要的敏感应用留意 Windows 前台占用避免涉及密钥的任务审查应用权限提示谨慎使用「始终允许」关键设置需在场注意窗口切换每次只给 Codex 一个明确的目标应用或流程你可以随时停止任务或接管电脑的控制权除非任务需要，否则保持敏感应用处于关闭状态在 Windows 上，Codex 会接管前台输入；建议使用第二台设备、虚拟机，或在亲自使用桌面之前先停止任务除非你在场并能批准每一步操作，否则避免执行需要密钥的任务在允许 Codex 使用某个应用之前，仔细查看权限提示仅对你信任 Codex 在未来任务中自动使用的应用选择「始终允许」涉及账户、安全、隐私、网络、支付或凭证相关设置时，务必在场监督如果 Codex 开始与错误的窗口交互，立即取消任务
浏览器使用注意事项
如果 Codex 使用你的浏览器，它可以与你已登录的页面进行交互。
请像自己亲自操作一样审查网站行为：网页可能包含恶意或误导性内容，而网站可能将已批准的点击、表单提交和已登录操作视为来自你的账户。
如果需要在 Codex 工作的同时继续使用浏览器，可以让 Codex 使用另一个不同的浏览器。
功能限制
Computer Use 无法自动化终端应用或 Codex 自身，因为自动化这些可能会绕过 Codex 的安全策略。
它也无法以管理员身份进行身份验证，或批准电脑上的安全和隐私权限提示。
数据说明
文件编辑和 shell 命令仍然遵循 Codex 的审批和沙箱设置。
通过桌面应用所做的更改，在保存到磁盘并被项目追踪之前，可能不会出现在审查面板中。
你的 ChatGPT 数据控制设置适用于通过 Codex 处理的内容，包括 Computer Use 所截取的屏幕截图。