应用截图可以把最前方的应用窗口发送到 Codex 线程。当你正在另一款 Mac 应用里工作,并希望把当前上下文交给 Codex 处理时,可以使用它。
应用截图会捕获什么
一张应用截图只捕获最前方窗口。它可以包含:
- 可见窗口的图像。
- 该窗口可用的文本,包括可见文本,以及应用在可见滚动区域之外提供的文本。
把应用截图加入线程后,它会像 Codex 附件一样工作。和你手动附加的文件或图片一样,Codex 会把应用截图本地存储在 session 文件中。
何时使用应用截图
当 Codex 需要先了解某个 Mac 应用里的上下文才能行动时,可以使用应用截图。
示例:
- 分享一个 API reference 页面,并要求 Codex 写一段使用它的脚本。
- 分享邮件或日历视图,并要求 Codex 起草下一步。
- 分享图片编辑器、设计稿或预览窗口,并要求 Codex 修改相关资源或代码。
- 分享一条错误、设置面板或应用状态,因为它比文字描述更容易展示。
捕获应用截图
- 在 Mac 上打开 Codex App。
- 打开你想分享的应用和窗口。
- 按下左右两个 Command 键,或按你在 Codex 设置中配置的自定义快捷键。
- 如果 Codex 请求 macOS 权限,请允许。
- 让 Codex 基于这张应用截图执行任务。
默认情况下,Codex 会为应用截图新建一个线程。如果你在过去 60 秒内与某个 Codex 线程交互过,Codex 会把应用截图添加到那个最近线程中。连续捕获应用截图时,它们会继续加入同一个线程。
你可以在 Codex 设置中修改应用截图快捷键。
权限与安全
Codex 可能会先请求权限,才能捕获应用截图:
- Screen & System Audio Recording 让 Codex 可以捕获最前方窗口的图像。
- Accessibility 让 Codex 可以读取最前方窗口的可用文本。
捕获应用截图会把捕获到的图像和可用文本分享给 Codex。除非任务确实需要,请避免对敏感内容捕获应用截图。
请像审查要分享给 Codex 的截图和文档一样,审查应用截图。
限制与故障排查
应用截图是 Codex App 功能。请在 macOS 上从 Codex App 创建它们。如果你在 CLI 中恢复了一个已经包含应用截图的线程,该附件会作为线程历史的一部分存在,但 CLI 不能创建新的应用截图。
对于部分应用和网站,包括 Google Docs、Gmail、Google Sheets 和 Google Slides,Codex 可能只能收到可见截图,而无法收到完整文档或屏幕外文本。如果你安装了对应插件,Codex 可以用该插件访问相关应用内容,并继续帮助你完成请求。
如果应用截图无法工作:
- 打开 System Settings > Privacy & Security。
- 检查 Codex Computer Use 的 Screen & System Audio Recording 和 Accessibility 权限。
- 重启 Codex 后重试。