记忆
Codex 中文站说明: 本页围绕“记忆”重新补充了中文使用场景和验证重点。界面名称可能随 Codex 版本更新,请以当前客户端为准。
ChatGPT 和 Codex 如何在聊天和任务之间延续有用上下文
记忆让 ChatGPT 和 Codex 可以把先前工作中的有用上下文带入后续工作。ChatGPT Web 使用 ChatGPT memory(记忆功能);本地 Codex 客户端则使用一套独立的本地记忆存储和控制方式。
团队必须遵守的指导应保存在 AGENTS.md 或已提交到仓库的文档中。记忆只是一层辅助回忆机制,不应成为必须始终生效的规则的唯一来源。
在 ChatGPT 桌面应用中,使用 /memories 决定当前聊天能否使用本地记忆,以及该聊天能否用于生成后续记忆。需要全局开启或关闭时,前往 Settings > Personalization(设置 > 个性化)。
Chronicle 是桌面端专属功能,可以帮助 Codex 从屏幕活动中恢复最近的工作上下文并建立记忆。
本地 Codex 记忆如何工作
启用记忆后,Codex 可以把符合条件的旧聊天中的有用上下文写入本地记忆文件。Codex 会跳过仍在进行或生命周期很短的 session,对生成的记忆字段进行秘密信息脱敏,并在后台更新记忆,而不是在每个聊天结束时立即处理。
聊天结束后,记忆可能不会立刻更新。Codex 会等待聊天空闲足够长的时间,避免在工作仍在继续时过早总结。
当 Codex 剩余速率限制百分比低于配置阈值时,后台记忆生成也可能跳过,以免在额度接近上限时继续消耗配额。
本地记忆存储
Codex 把记忆保存在 Codex home 目录下,默认位置是 ~/.codex。Codex 如何使用 CODEX_HOME,请参阅配置和状态位置。
主要记忆文件位于 ~/.codex/memories/,其中包括摘要、持久条目、最近输入,以及来自旧聊天的支持证据。
这些文件属于生成状态。排查问题或分享 Codex home 目录前可以检查它们,但不要把手工编辑这些文件作为主要控制方式。
按聊天控制本地记忆
在 ChatGPT 桌面应用和 Codex TUI 中,使用 /memories 控制当前聊天的记忆行为。聊天级选项可以决定当前聊天能否使用现有记忆,以及 Codex 能否把该聊天用于生成未来记忆。
聊天级选择不会改变你的全局记忆设置。
检查本地记忆
不要在记忆中保存秘密信息。Codex 会从生成的记忆字段中脱敏秘密信息,但在分享 Codex home 目录或生成的记忆产物前,仍应检查相关文件。
配置本地记忆
本地 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 工具调用、Web 搜索或工具搜索等外部上下文的聊天用于生成记忆。旧键memories.no_memories_if_mcp_or_web_search仍可作为别名使用。memories.min_rate_limit_remaining_percent:开始生成记忆所需的最低 Codex 剩余额度百分比。memories.extract_model:覆盖每个聊天执行记忆提取时使用的模型。memories.consolidation_model:覆盖执行全局记忆合并时使用的模型。
本站实践建议
处理“记忆”相关配置前,建议先备份现有配置文件,并在测试项目中逐项启用。每次只改变一个设置,便于出现异常时快速定位和回滚。
Codex API 与国内使用
在实践“记忆”相关功能时,如需为 Codex 配置 OpenAI-compatible API,可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。