OpenAI Codex Chronicle 能把屏幕上下文加入 Codex memories，减少反复补充背景信息的成本，适合需要让 Codex 理解你当前在看什么、正在用什么工具的场景。开启前要确认你是 macOS 上的 ChatGPT Pro 用户，且不在 EU、UK 或 Switzerland；同时需要先启用 Memories，再授予 Screen Recording 和 Accessibility 权限。
OpenAI Codex Chronicle 开启与排查
Chronicle 是 Codex memories 的屏幕上下文增强功能，能让 Codex 更容易理解你正在处理的内容。它目前属于 opt-in research preview，只在 macOS 上的 ChatGPT Pro 可用，且不适用于 EU、UK 和 Switzerland。
Chronicle 能解决什么问题
Chronicle 的目标是减少你每次都要重述的上下文。Codex 可以借助最近的屏幕内容，更快判断你在看什么、应该查哪个来源、以及你常用哪些工具和工作流。
用屏幕上的内容补上下文
开启后，Codex 可以利用你当前屏幕上的内容理解你正在做什么，减少来回切换和重复说明。
自动补全缺失信息
如果你没有把背景一次性讲全，Chronicle 可以帮助 Codex 补上缺口，让它更快进入状态。
记住工具和工作流
当 Codex 反复看到你常用的工具、流程或操作方式时，它能更好地跟上你的习惯，不必每次都重新解释。
在这些情况下，Codex 会用 Chronicle 提供额外上下文。若读取具体文件、Slack 线程、Google Doc、dashboard 或 pull request 更合适，Codex 会先用 Chronicle 找到对应来源，再直接使用那个来源。
怎么开启 Chronicle
- 在 Codex app 中打开 Settings。
- 进入 Personalization，确认 Memories 已启用。
- 在 Memories 下方打开 Chronicle。
- 查看 consent dialog，选择 Continue。
- 按提示授予 macOS Screen Recording 和 Accessibility 权限。
- 设置完成后，选择 Try it out，或者新建一个 thread。
如果 macOS 提示 Screen Recording 或 Accessibility 被拒绝，打开 System Settings > Privacy & Security > Screen Recording 或 Accessibility，把 Codex 设为允许。
如果权限受 macOS 或你的组织策略限制，等限制解除后、Codex 重新获得所需权限，Chronicle 才会启动。
怎么暂停或关闭 Chronicle
你可以随时控制 Chronicle 是否继续基于屏幕上下文生成 memories。
- 在 Codex 菜单栏图标中选择 Pause Chronicle 暂停。
- 选择 Resume Chronicle 恢复。
- 在开会前，或查看不想让 Codex 记住的敏感内容时，建议先暂停。
如果要彻底关闭，回到 Settings > Personalization > Memories，把 Chronicle 关掉。
你也可以按 thread 控制 memories 是否参与该对话。
了解更多
Rate limits
Chronicle 会在后台运行 sandboxed agents，从截图里生成 memories，因此会比较快地消耗 rate limits。
隐私与安全
Chronicle 会使用屏幕截图，截图里可能包含你正在屏幕上显示的敏感信息。它不会访问麦克风，也不会访问系统音频。
不要在未获得对方同意的情况下，用 Chronicle 记录会议或他人通信内容。查看不想被记住的内容时，先暂停 Chronicle。
Chronicle 的数据存在哪里
屏幕截图是临时文件，只会短暂保留在你的电脑上。Chronicle 运行时，临时截图文件可能出现在：
$TMPDIR/chronicle/screen_recording/
Chronicle 运行期间，超过 6 小时的截图会被删除。
Chronicle 生成的 memories 和其他 Codex memories 一样，都是未加密的 markdown 文件，你可以读取、修改，Codex 也可以搜索它们。若想让 Codex 忘记某些内容，可以删除对应文件，或者编辑 markdown 文件，把不想保留的信息移除。不要手动新增内容。
生成的 Chronicle memories 会保存在本地：
$CODEX_HOME/memories_extensions/chronicle/
通常是：
~/.codex/memories_extensions/chronicle
截图目录和 memories 目录都可能包含敏感信息。不要与他人共享这些内容，也要注意同一台电脑上的其他程序也可能读取这些文件。
Chronicle 会向 OpenAI 共享哪些数据
Chronicle 会先在本地捕获屏幕上下文，然后周期性地调用 Codex，把最近活动总结成 memories。为了生成这些 memories，Chronicle 会启动一个临时的 Codex session，并让它访问这段屏幕上下文。该 session 可能处理选定的截图帧、从截图中提取的 OCR 文本、时间信息，以及相关时间窗口内的本地文件路径。
用于生成 memories 的截图只会临时保存在设备上。它们会被发送到服务端处理，用来生成 memories，然后再把生成结果保存在本地。OpenAI 不会在处理后继续保存这些截图，除非法律要求，也不会把它们用于训练。
生成的 memories 是保存在本地的 Markdown 文件，路径为 $CODEX_HOME/memories_extensions/chronicle/。当 Codex 在未来 session 中使用 memories 时，相关内容可能会作为上下文加入该 session；如果你的 ChatGPT 设置允许，也可能用于改进模型。
了解更多
Prompt injection 风险
使用 Chronicle 会增加来自屏幕内容的 prompt injection 风险。比如你浏览了一个带有恶意 agent instructions 的网站，Codex 可能会跟随这些指令。
Chronicle 怎么排查打不开或不生效
怎么启用 Chronicle
如果你看不到 Chronicle 选项，先确认两件事：
- 你安装的是包含 Chronicle 的 Codex app build。
- 你已经在 Settings > Personalization 中启用了 Memories。
还要注意当前限制：
- Chronicle 目前只对 macOS 上的 ChatGPT Pro subscribers 开放。
- Chronicle 不适用于 EU、UK 和 Switzerland。
如果设置没有完成：
- 确认 Codex 已获得 Screen Recording 和 Accessibility 权限。
- 退出并重新打开 Codex app。
- 打开 Settings > Personalization，检查 Chronicle 状态。
Chronicle 生成 memories 用的是什么模型
Chronicle 使用和其他 Memories 相同的模型。
如果你没有配置特定模型，它会使用默认的 Codex model。要指定模型，可以在 configuration 中更新 consolidation_model。
[memories]
consolidation_model = "gpt-5.4-mini"常见问题
OpenAI Codex Chronicle 怎么开启
先在 Codex app 的 Settings > Personalization 里开启 Memories，再打开 Chronicle，然后按提示授予 macOS 的 Screen Recording 和 Accessibility 权限。设置完成后可以选择 Try it out 或新建 thread。
Chroncile 不显示怎么办
先确认你用的是包含 Chronicle 的 Codex app build，并且账号是 macOS 上的 ChatGPT Pro subscribers。还要检查你所在地区是否在 EU、UK 或 Switzerland，因为这些地区目前不可用。
OpenAI Codex Chronicle 会访问麦克风吗
不会。Chronicle 会使用屏幕截图来生成 memories，但不会访问麦克风或系统音频。