记忆

记忆功能使 Codex 能够将早期线程中的有用上下文带入未来的工作中。启用记忆后，Codex 可以记住固定偏好、常用工作流、技术栈、项目约定以及已知陷阱，因此您无需在每个线程中重复相同的上下文。

将团队必需的指导原则保留在 AGENTS.md 或已提交的文档中。将记忆视为一个有用的本地召回层，而不是必须始终遵守的规则的唯一来源。

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

启用记忆

在 Codex 应用中，在设置中启用记忆。

对于基于配置的设置，请将 feature flag 添加到 config.toml:

[features]
memories = true

查看 配置基础 以了解 Codex 存储用户级配置的位置以及 Codex 如何加载 ~/.codex/config.toml.

记忆的工作原理

启用记忆后，Codex 可以将符合条件的先前线程中的有用上下文转换为本地记忆文件。Codex 会跳过活动或短暂的会话，对生成的记忆字段中的机密信息进行脱敏处理，并在后台更新记忆，而不是在每个线程结束后立即更新。

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

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

记忆存储

Codex 将记忆存储在您的 Codex 主目录下。默认情况下，该路径为 ~/.codex。请参阅 配置与状态位置 for how Codex uses CODEX_HOME.

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

请将这些文件视为已生成的状态。您可以在排查故障或共享 Codex 主目录之前检查它们，但不要将手动编辑它们作为主要的控制手段。

按线程控制记忆

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

线程级别的选择不会改变您的全局记忆设置。

配置

在 Codex 应用设置中启用记忆，或设置 memories = true in the [features] 位于 config.toml.

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

常见的记忆特定设置包括：

• 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 主目录或生成的记忆产物之前，您仍应检查记忆文件。