本文为非官方中文翻译，内容以 OpenAI 官方英文文档为准。
官方来源：https://developers.openai.com/codex/memories

记忆

Codex 如何在线程之间延续有用的上下文

记忆默认处于关闭状态，并且在上线时不适用于欧洲经济区、英国或瑞士。可在 Codex 设置中启用，或在 ~/.codex/config.toml 的 [features] 表中设置 memories = true。

记忆让 Codex 能够将较早线程中的有用上下文带入未来的工作。启用记忆后，Codex 可以记住稳定的偏好、重复出现的工作流、技术栈、项目约定和已知陷阱，这样你就不必在每个线程中重复相同的上下文。

请将团队必需的指导保存在 AGENTS.md 或已提交的文档中。应将记忆视为有帮助的本地回忆层，而不是那些必须始终适用规则的唯一来源。

Chronicle 可帮助 Codex 从你的屏幕恢复最近的工作上下文，以构建记忆。

启用记忆

在 Codex 应用中，在设置里启用 Memories。

如需基于配置进行设置，请将该功能标志添加到 config.toml：

[features]
memories = true

有关 Codex 存储用户级配置的位置以及 Codex 如何加载 ~/.codex/config.toml，请参阅配置基础。

启用记忆后，Codex 可以将符合条件的先前线程中的有用上下文转换为本地记忆文件。Codex 会跳过活跃的或短生命周期的会话，从生成的记忆字段中删去秘密信息，并在后台更新记忆，而不是在每个线程结束时立即更新。

线程结束后，记忆可能不会立刻更新。Codex 会等到线程空闲足够长时间后，才会进行处理，以避免总结仍在进行中的工作。

当你的 Codex 剩余速率限制百分比低于已配置阈值时，记忆生成也可能跳过一次后台处理，这样 Codex 就不会在你接近限制时消耗配额。

Codex 会将记忆存储在你的 Codex 主目录下。默认情况下，该目录是 ~/.codex。有关 Codex 如何使用 CODEX_HOME，请参阅 Config and state locations。

主要的记忆文件位于 ~/.codex/memories/ 下，其中包括摘要、持久条目、近期输入以及来自先前线程的支持性证据。

请将这些文件视为生成的状态。你可以在排查问题时查看它们，或在分享你的 Codex 主目录前进行检查，但不要依赖手动编辑它们作为主要控制方式。

在 Codex 应用和 Codex TUI 中，使用 /memories 控制当前线程的记忆行为。线程级选择可让你决定当前线程是否可以使用现有记忆，以及 Codex 是否可以使用该线程来生成未来的记忆。

线程级选择不会更改你的全局记忆设置。

在 Codex 应用设置中启用记忆，或在 config.toml 的 [features] 部分中设置 memories = true。

有关配置文件位置和与记忆相关设置的完整列表，请参阅配置参考。

常见的记忆相关设置包括：

memories.generate_memories：控制新创建的线程是否可被存储为记忆生成输入。
memories.use_memories：控制 Codex 是否会将现有记忆注入未来会话中。
memories.disable_on_external_context：当设为 true 时，会使使用了外部上下文（例如 MCP 工具调用、网页搜索或工具搜索）的线程不参与记忆生成。较旧的 memories.no_memories_if_mcp_or_web_search 键仍可作为别名使用。
memories.min_rate_limit_remaining_percent：控制开始生成记忆前所需的最低 Codex 剩余速率限制百分比。
memories.extract_model：覆盖用于按线程提取记忆的模型。
memories.consolidation_model：覆盖用于全局记忆整合的模型。

不要在记忆中存储秘密信息。Codex 会从生成的记忆字段中删去秘密信息，但在分享你的 Codex 主目录或生成的记忆产物之前，你仍应检查记忆文件。