Skip to content
FunCoding

Search

Search docs, Skills and MCP

本地 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_contexttrue 时排除用过 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 功能,不应与普通会话记忆混淆。