Memories 让 Codex 可以把早先线程中的有用上下文带入未来工作。启用后,Codex 可以记住稳定偏好、重复工作流、技术栈、项目约定和已知陷阱,这样你不必在每个线程里重复相同背景。
团队必须遵守的指导仍应放在 AGENTS.md 或已提交的文档中。把 Memories 视为有帮助的本地上下文层,而不是必须始终生效的规则的唯一来源。
Chronicle 是 Codex 的长期上下文记录功能,可以从你的屏幕恢复最近的工作上下文,并用它建立 Memories。
启用 Memories
在 Codex App 中,可以在设置里启用 Memories。
如果通过配置启用,请把功能开关加入 config.toml:
[features]
memories = true参见配置基础,了解 Codex 在哪里存放用户级配置,以及如何加载 ~/.codex/config.toml。
Memories 如何工作
启用 Memories 后,Codex 可以把符合条件的早先线程中的有用上下文转成本地 Memories 文件。Codex 会跳过活跃或短生命周期会话,从生成的 Memories 字段中移除密钥,并在后台更新 Memories,而不是在每个线程结束后立即更新。
线程结束时,Memories 不一定会立刻更新。Codex 会等到线程闲置足够长时间后再处理,避免总结仍在进行中的工作。
Memories 存储
Codex 会把 Memories 存放在你的 Codex 主目录下。默认位置是 ~/.codex。关于 Codex 如何使用 CODEX_HOME,参见配置与状态位置。
主要 Memories 文件位于 ~/.codex/memories/,包括摘要、持久条目、近期输入,以及来自早先线程的支持证据。
请把这些文件视为生成状态。排障或共享 Codex 主目录之前,你可以检查它们,但不要把手动编辑这些文件作为主要控制方式。
按线程控制 Memories
在 Codex App 和 Codex TUI 中,可以使用 /memories 控制当前线程的 Memories 行为。线程级选择让你决定当前线程是否可以使用已有 Memories,以及 Codex 是否可以用该线程生成未来 Memories。
线程级选择不会改变你的全局 Memories 设置。
配置
你可以在 Codex App 设置中启用 Memories,也可以在 config.toml 的 [features] 小节中设置 memories = true。
关于配置文件位置和所有 Memories 相关设置,请参见配置参考。
常见的 Memories 专用设置包括:
memories.generate_memories:控制新建线程是否可以被存为 Memories 生成输入。memories.use_memories:控制 Codex 是否把已有 Memories 注入到未来会话中。memories.disable_on_external_context:设为true时,会把使用过 MCP 工具调用、Web search 或 tool search 等外部上下文的线程排除在 Memories 生成之外。旧的memories.no_memories_if_mcp_or_web_search键仍会作为别名接受。memories.extract_model:覆盖用于按线程提取 Memories 的模型。memories.consolidation_model:覆盖用于全局 Memories 合并的模型。
审查 Memories
不要把密钥存入 Memories。Codex 会从生成的 Memories 字段中移除密钥,但在共享 Codex 主目录或生成的 Memories artifact 前,你仍应审查这些 Memories 文件。