记忆

记忆让 ChatGPT 和 Codex 能够将先前工作中的有用上下文带入 后续工作。 ChatGPT 网页版使用 ChatGPT 记忆，而本地 Codex 客户端使用独立的本地 记忆存储和控制项。

请将团队必须遵循的指导放在 AGENTS.md 或已签入的文档中。应将 记忆视为辅助回忆层，而不是必须始终应用的规则的唯一来源。

在 ChatGPT 桌面应用中，使用 /memories 选择某个聊天能否使用 本地记忆或用于生成后续记忆。如需开启或关闭此功能，请前往 设置 > 个性化进行管理。

计算机历史记录是 macOS 桌面端的一项 功能，它会将获准应用和网站中的活动转化为记忆和时间线，供 ChatGPT 和 Codex 参考。

本地 Codex 记忆的工作原理

启用记忆后，Codex 可以将符合条件的过往聊天中的有用上下文转化为本地 记忆文件。Codex 会跳过仍在进行或生命周期较短的会话，从生成的记忆字段中 隐去密钥，并在后台更新记忆，而不是在每次聊天结束后立即更新。

聊天结束后，记忆可能不会立即更新。Codex 会等到聊天空闲足够长的时间， 以免对仍在进行的工作进行总结。

如果 Codex 速率限制的剩余百分比低于配置的阈值，记忆生成也可能跳过某次 后台处理，以免在接近限制时消耗配额。

本地记忆存储

Codex 将记忆存储在 Codex 主目录下。默认路径为 ~/.codex。请参阅配置和状态位置， 了解 Codex 如何使用 CODEX_HOME。

主要记忆文件位于 ~/.codex/memories/ 下，包括摘要、 持久条目、近期输入和过往聊天中的支持证据。

请将这些文件视为生成的状态。排查问题或分享 Codex 主目录前可以检查它们， 但不要将手动编辑这些文件作为主要控制方式。

按聊天控制本地记忆

在 ChatGPT 桌面应用和 Codex TUI 中，使用 /memories 控制当前聊天的记忆行为。 聊天级选项允许你决定当前聊天能否使用现有记忆，以及 Codex 能否使用该聊天 生成后续记忆。

聊天级选项不会更改全局记忆设置。

检查本地记忆

不要在记忆中存储密钥。Codex 会从生成的记忆字段中隐去密钥， 但在分享 Codex 主目录或生成的记忆制品前，你仍应检查记忆文件。

配置本地记忆

本地 Codex 记忆默认关闭。在 ChatGPT 桌面应用中，打开 设置 > 个性化并开启启用记忆。

若要通过配置启用，请将功能标志添加到 config.toml：

[features]
memories = true

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

常用的记忆专属设置包括：

• 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：覆盖用于整合全局记忆的 模型。