Memories 默认关闭。在 European Economic Area、United Kingdom 和 Switzerland，Codex 只会在你于 Codex settings 中启用 memories，或在 ~/.codex/config.toml 的 [features] table 中设置 memories = true 后，才会使用或生成 memories。
Memories 让 Codex 可以把早前 threads 中有用的 context 带入未来工作。启用 memories 后，Codex 可以记住稳定偏好、重复工作流、技术栈、项目约定和已知陷阱，因此你不需要在每个 thread 中重复相同 context。
请把必需的团队 guidance 放在 AGENTS.md 或已提交到仓库的 documentation 中。把 memories 视作有帮助的 local recall layer，而不是必须始终适用的规则的唯一来源。
Chronicle 会帮助 Codex 从你的屏幕恢复最近的 working context，用于构建 memory。
启用 memories
在 Codex app 中，请在 settings 里启用 Memories。
如果通过 config 设置，请把 feature flag 添加到 config.toml：
[features] memories = true关于 Codex 存储 user-level configuration 的位置，以及 Codex 如何加载 ~/.codex/config.toml，请参见 Config basics 。
Memories 如何工作
启用 memories 后，Codex 可以把符合条件的 prior threads 中有用的 context 转换为 local memory files。Codex 会跳过 active 或 short-lived sessions，从生成的 memory fields 中 redacts secrets，并在后台更新 memories，而不是在每个 thread 结束时立即更新。
Thread 结束后，memories 可能不会立刻更新。Codex 会等待 thread idle 足够久，以避免总结仍在进行中的工作。
当你的 Codex rate-limit remaining percentage 低于配置阈值时，memory generation 也可能跳过一次 background pass，这样 Codex 就不会在你接近 limit 时消耗 quota。
Memory 存储
Codex 会把 memories 存储在你的 Codex home directory 下。默认情况下，这个目录是 ~/.codex。关于 Codex 如何使用 CODEX_HOME，请参见 Config and state locations 。
主要 memory files 位于 ~/.codex/memories/ 下，包含来自 prior threads 的 summaries、durable entries、recent inputs 和 supporting evidence。
请把这些文件视为 generated state。你可以在 troubleshooting 时，或在分享 Codex home directory 前检查它们，但不要把手动编辑它们作为主要 control surface。
按 thread 控制 memories
在 Codex app 和 Codex TUI 中，使用 /memories 控制当前 thread 的 memory behavior。Thread-level choices 让你决定当前 thread 是否可以使用 existing memories，以及 Codex 是否可以使用该 thread 来生成 future memories。
Thread-level choices 不会更改你的 global memory settings。
Configuration
请在 Codex app settings 中启用 memories，或在 config.toml 的 [features] section 中设置 memories = true。
关于 config file locations 以及完整 memory-related settings 列表，请参见 configuration reference 。
常见的 memory-specific settings 包括：
memories.generate_memories：控制 newly created threads 是否可以作为 memory-generation inputs 存储。
memories.use_memories：控制 Codex 是否会把 existing memories 注入未来 sessions。
memories.disable_on_external_context：为 true 时，会把使用 external context 的 threads 排除在 memory generation 之外，例如 MCP tool calls、web search 或 tool search。较旧的 memories.no_memories_if_mcp_or_web_search key 仍会作为 alias 被接受。
memories.min_rate_limit_remaining_percent：控制 memory generation 启动前所需的最低 remaining Codex rate-limit percentage。
memories.extract_model：覆盖 per-thread memory extraction 使用的 model。
memories.consolidation_model：覆盖 global memory consolidation 使用的 model。
Review memories
不要在 memories 中存储 secrets。Codex 会从生成的 memory fields 中 redact secrets，但你仍应在分享 Codex home directory 或 generated memory artifacts 前 review memory files。