记忆
记忆让 ChatGPT 和 Codex 能够将先前工作中的有用上下文带入未来的工作中。ChatGPT 网页版使用 ChatGPT 记忆,而本地 Codex 客户端使用单独的本地记忆存储和控制项。
将必需的团队指导放在 AGENTS.md 或已纳入版本控制的文档中。将记忆视为有助于回忆的层,而不是始终适用规则的唯一来源。
在 ChatGPT 桌面应用中,使用 /memories 选择聊天是否可以使用本地记忆,或是否可以为未来的记忆提供内容。需要启用或停用此功能时,请前往 Settings > Personalization 进行管理。
Chronicle 是一项仅限桌面的功能,可帮助 Codex 从屏幕中恢复近期工作上下文,以构建记忆。
本地 Codex 记忆的工作方式
Section titled “本地 Codex 记忆的工作方式”启用记忆后,Codex 可以将符合条件的历史聊天中的有用上下文转换为本地记忆文件。Codex 会跳过活跃会话或短期会话,从生成的记忆字段中删除机密信息,并在后台更新记忆,而不是在每次聊天结束时立即更新。
聊天结束后,记忆可能不会立即更新。Codex 会等待聊天处于空闲状态足够长的时间,以避免总结仍在进行中的工作。
当你的 Codex 速率限制剩余百分比低于配置的阈值时,记忆生成也可能跳过一次后台处理,这样在接近限制时,Codex 就不会消耗配额。
本地记忆存储
Section titled “本地记忆存储”Codex 将记忆存储在 Codex 主目录下。默认情况下,该目录为 ~/.codex。有关 Codex 如何使用 CODEX_HOME,请参阅配置和状态位置。
主要记忆文件位于 ~/.codex/memories/ 下,其中包括先前聊天的摘要、持久条目、近期输入和支持性证据。
将这些文件视为生成的状态。你可以在排查问题时检查它们,也可以在共享 Codex 主目录前检查它们,但不要将手动编辑这些文件作为主要控制手段。
控制每个聊天中的本地记忆
Section titled “控制每个聊天中的本地记忆”在 ChatGPT 桌面应用和 Codex TUI 中,使用 /memories 控制当前聊天的记忆行为。聊天级选项让你可以决定当前聊天是否能够使用现有记忆,以及 Codex 是否可以使用该聊天来生成未来的记忆。
聊天级选项不会更改你的全局记忆设置。
查看本地记忆
Section titled “查看本地记忆”不要将机密信息存储在记忆中。Codex 会从生成的记忆字段中删除机密信息,但在共享 Codex 主目录或生成的记忆工件前,你仍应检查记忆文件。
配置本地记忆
Section titled “配置本地记忆”本地 Codex 记忆默认处于关闭状态。在 ChatGPT 桌面应用中,打开 Settings > Personalization,然后启用 Enable memories。
如需基于配置进行设置,请将功能标志添加到 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:覆盖用于整合全局记忆的模型。