OpenAI Codex 中文文档(最近同步时间 2026.04.22)

Memories

让 Codex 把过往线程中的有用上下文带入后续工作。

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 文件。


来源:https://developers.openai.com/codex/memories