本地 Memories
开启和控制 Codex 的本地记忆,区分使用已有记忆与贡献新记忆。
This page has not been translated into English yet. The original Chinese version is shown below.
本地 Codex Memories 与 ChatGPT 网页 memory 是不同存储和控制。它适合复用之前工作的上下文,团队必须遵守的规则仍应放在 AGENTS.md 或版本管理中的文档。
启用与聊天控制
Memories 默认关闭。桌面 Settings > Personalization 的 Enable Codex memories 作用于选中的机器,也可配置:
[features]
memories = true桌面和 TUI 的 /memories 分别控制当前聊天能否使用已有记忆,以及能否参与未来记忆生成。这些选择不会修改全局设置。IDE 使用连接 Codex 主机的本地存储和对应聊天控制。
生成时机和文件
记忆在后台从符合条件的既有聊天提取,跳过仍活动或过短的会话。聊天结束不会马上生成,系统等待足够空闲后处理;剩余额度低于配置阈值也可能跳过生成。
默认文件在 ~/.codex/memories/,随 CODEX_HOME 改变。包括摘要、持久条目、近期输入与证据,属于生成状态,不应依赖手改文件作为主要控制方式。虽然生成字段会脱敏,分享主目录或记忆产物前仍应检查。
可用设置
| 键 | 用途 |
|---|---|
| memories.generate_memories | 新聊天是否能成为生成输入 |
| memories.use_memories | 是否向后续会话注入已有记忆 |
| memories.disable_on_external_context | true 时排除用过 MCP、搜索或 tool search 的聊天 |
| memories.min_rate_limit_remaining_percent | 生成所需最低剩余额度比例 |
| memories.extract_model | 单聊天提取模型覆盖 |
| memories.consolidation_model | 全局整合模型覆盖 |
旧 no_memories_if_mcp_or_web_search 仍可作为 disable_on_external_context 的别名。本文不为官方未在该页给出的键补写默认值。
删除与其他功能
桌面 Delete Codex memories 经确认重置所选机器存储;本机在 Computer History 可用时也会清除该历史。Computer History 是另有可用条件的 macOS 功能,不应与普通会话记忆混淆。