Codex Appshots：把 Mac 前台窗口作为上下文发给 Codex

适用场景

Appshots 适合把 Mac 上某个应用的当前状态直接发给 Codex。比如你正在看 API 文档、邮件、日历、设计稿、错误弹窗或配置面板，用文字描述很麻烦，就可以用 Appshot 把前台窗口作为上下文交给 Codex。

这类功能很实用，但也更需要注意隐私：你发送的不只是文字，还可能包括窗口图像和应用暴露出的文本内容。

Appshot 会捕获什么

根据官方文档，Appshot 只针对前台窗口。它可能包含：

• 当前可见窗口图像。
• 窗口中可获得的文本，包括可见文本，以及应用对系统暴露的部分非可见文本。

添加到线程后，Appshot 类似一个附件，会成为 Codex 当前任务的上下文。

步骤 1：准备窗口

在触发 Appshot 前，先整理窗口：

1. 把要分享的应用窗口置于最前。
2. 关闭或遮挡无关标签页、聊天、账号信息和密钥。
3. 如果窗口里有客户数据或内部信息，确认这个任务确实需要它。
4. 把 Codex App 保持打开并已登录。

Appshot 的价值在于“让 Codex 看到当前状态”，所以窗口越干净，Codex 越容易理解任务。

步骤 2：触发 Appshot

在 macOS 上，官方文档说明可以按两个 Command 键，或使用你在 Codex 设置里配置的 Appshots 热键。

触发后，如果 macOS 要求授权，请按提示授予必要权限。常见权限包括屏幕录制和辅助功能访问。

步骤 3：告诉 Codex 要做什么

不要只发送 Appshot。发送后最好立刻补一句明确任务：

请根据这个错误窗口判断失败原因，并告诉我下一步应该检查哪个配置。先不要修改代码。

或者：

这是我正在看的 API 文档，请根据窗口内容写一个最小可运行的调用示例，并说明需要哪些环境变量。

Appshot 提供上下文，任务说明决定 Codex 如何使用上下文。

步骤 4：理解线程归属

官方文档说明，默认情况下 Appshot 会创建新线程；如果你刚刚和某个 Codex 线程交互过，它可能会追加到最近线程中。连续 Appshot 也可能进入同一个线程。

如果你担心上下文混淆，建议在发送前新开一个主题清晰的线程。

权限和安全

Appshots 可能需要：

• 屏幕录制权限：捕获前台窗口图像。
• 辅助功能权限：读取应用可提供的文本。

不要对包含密码、支付信息、客户资料、私有聊天或内部系统后台的窗口随手 Appshot。发送前把它当作“向 Codex 分享截图和文档”一样审查。

排错方法

如果 Appshot 不工作：

1. 打开 macOS 系统设置。
2. 进入隐私与安全。
3. 检查屏幕录制和辅助功能权限中是否允许 Codex 或 Codex Computer Use。
4. 重启 Codex App。
5. 重新触发热键。

对于 Google Docs、Gmail、Google Sheets、Google Slides 等应用或网页，Codex 可能只能获得可见截图，而不是完整文档文本。需要稳定访问时，应考虑对应插件或更直接的文件上下文。

小结

Appshots 的定位是“把当前 Mac 应用状态快速变成 Codex 上下文”。它适合难以用文字描述的界面、错误、文档和设计状态；使用时要先清理窗口、控制敏感信息、补充明确任务，并在权限异常时从 macOS 隐私设置排查。