使用记忆能力

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
Memories	记忆	让 Codex 跨会话记住偏好和上下文的能力。
Memory storage	记忆存储	记忆数据保存的位置和范围。
per-thread 控制	按线程控制	单个会话维度开关或清理记忆。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你配置和管理 Codex 的记忆能力，既好用又不留风险。

你是 Codex 记忆配置顾问，帮我配好记忆能力，既能跨会话省事又不留隐私和误记风险。

【角色】
你知道怎么启用 Memories、记忆如何工作、存储位置、按 thread 控制记忆、相关配置。

【输入】
- 我想让它记住什么（偏好 / 项目约定 / 流程）：___
- 哪些信息不能被记住（敏感 / 临时）：___
- 个人用还是多项目 / 多人：___
- 对隐私的顾虑：___

【工作流程】
1. 判断哪些该记、哪些不该记
2. 给启用和配置方式
3. 说明怎么按 thread 控制和清理
4. 给记忆出错（记了不该记的）时的处理

【输出规范】
▌一、该记 / 不该记的清单
▌二、启用与配置方式
▌三、按 thread 的控制和清理
▌四、误记的清理和防范

【硬约束】
- 敏感信息不进记忆，临时信息及时清
- 多项目 / 多人时注意记忆隔离
- 不确定记忆边界时保守开启
- 提醒定期复查记了什么
- 不确定的机制标注需查官方文档

Memories 默认关闭。launch 时，European Economic Area、United Kingdom 和 Switzerland 不可用。

你可以在 Codex settings 中启用 memories，或在 ~/.codex/config.toml 的 [features] table 中设置：

memories = true

Memories 让 Codex 可以把早期 threads 中有用的 context 带入未来工作。

启用 memories 后，Codex 可以记住 stable preferences、recurring workflows、tech stacks、project conventions 和 known pitfalls，这样你不需要在每个 thread 中重复相同 context。

required team guidance 仍应放在 AGENTS.md 或 checked-in documentation 中。

把 memories 当成有帮助的 local recall layer，不要把它当成必须始终生效的 rules 唯一来源。

Chronicle 可以帮助 Codex 从你的 screen 恢复最近 working context，并逐步建立 memory。

Enable Memories

在 Codex app settings 中启用 Memories。

如果用 config-based setup，在 config.toml 中添加 feature flag：

[features]
memories = true

config.toml 的 user-level configuration 存储位置，以及 Codex 如何加载 ~/.codex/config.toml，见 Config basics。

How Memories Work

启用 memories 后，Codex 可以把 eligible prior threads 中有用的 context 转成本地 memory files。

Codex 会跳过 active 或 short-lived sessions，从 generated memory fields 中 redact secrets，并在 background 更新 memories，而不是每个 thread 结束后立即更新。

thread 结束时，memories 不一定立刻更新。

Codex 会等 thread idle 足够久，避免把仍在进行中的工作提前 summarize。

当 Codex rate-limit remaining percentage 低于 configured threshold 时，memory generation 也可能跳过一次 background pass，避免在接近 limit 时消耗 quota。

Memory Storage

Codex 把 memories 存在 Codex home directory 下。默认是 ~/.codex。

Codex 如何使用 CODEX_HOME，见 Config and state locations。

主要 memory files 位于 ~/.codex/memories/，包括 summaries、durable entries、recent inputs，以及 prior threads 的 supporting evidence。

把这些 files 当成 generated state。

排错时，或分享 Codex home directory 前，你可以检查它们；但不要把手动编辑这些 files 当成 primary control surface。

Control Memories per Thread

在 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 注入 future sessions。
memories.disable_on_external_context：当值为 true 时，使用过 external context 的 threads 不参与 memory generation，例如 MCP tool calls、web search 或 tool search。旧 key memories.no_memories_if_mcp_or_web_search 仍作为 alias 接受。
memories.min_rate_limit_remaining_percent：控制 memory generation 开始前所需的 minimum remaining Codex rate-limit percentage。
memories.extract_model：override per-thread memory extraction 使用的 model。
memories.consolidation_model：override global memory consolidation 使用的 model。

Review Memories

不要把 secrets 存入 memories。

Codex 会从 generated memory fields 中 redact secrets，但在分享 Codex home directory 或 generated memory artifacts 前，你仍应 review memory files。