13 · Memory

📚 系列导航：上一篇 12 Skill 把重复步骤打包成 Skill。这一篇聊更底层的事——怎么让 Codex 跨会话记住你。Codex 有两套记忆系统，不是一套。

01 记忆分两套

维度	AGENTS.md	Memories（自动记忆）
谁写的	你（手动写）	Codex（自己生成）
装什么	必须每次生效的指令和规则	从过往会话学到的稳定上下文
典型内容	构建/测试命令、代码约定、禁区	技术栈、项目惯例、踩过的坑
默认开关	一直生效	默认关着，手动开
写入时机	你保存即生效	会话闲够久后，后台异步生成
可靠性	确定性	概率性
进不进 git	进，全队共享	不进，机器本地

NOTE

Memories 是锦上添花，不是兜底保险。必须每次生效的死规矩写进 AGENTS.md，别赌 Memories。

02 开启 Memories

Memories 默认关闭，需要手动开启。

法一：配置文件

toml

# ~/.codex/config.toml
[features]
memories = true

法二：在 Codex App 设置里打开

WARNING

地区限制： 欧洲经济区（EEA）、英国、瑞士不可用。这是功能层面的开关，不是网络问题。

03 它怎么工作

Memories 的几个关键行为：

不是实时写——它不会在会话一结束就立刻更新，得等这个会话空闲足够长时间，确认你不是还在干，才在后台总结。
从「够格的过往会话」里提炼——太短命的、还在进行中的会话会跳过，避免把没干完的活儿瞎总结。
配额紧张时跳过——当你的 rate-limit 剩余百分比低于配置阈值时，后台记忆生成会被跳过。
存在本地——~/.codex/memories/，明文 markdown，不进 git。
密钥脱敏——Codex 会对记忆字段里的密钥做脱敏，但这是兜底不是许可。

04 控制记忆行为

会话级：`/memories`

在 Codex App 或 CLI 里敲 /memories，管当前这一个会话：

这次要不要用已有记忆
这次要不要生成新记忆
或者干脆关掉

TIP

干「正经项目活」时正常记；干「一次性脏活/实验/敏感操作」时，先进去 /memories 把生成关掉。

全局级：config.toml

toml

[memories]
use_memories = true            # 设 false 则已有记忆不注入未来会话
generate_memories = true       # 设 false 则新会话不被拿去生成记忆
disable_on_external_context = false  # 用过外部工具的会话不参与生成
min_rate_limit_remaining_percent = 25 # 限额低于此值跳过生成

05 该记什么、不该记什么

❌ 别指望它记（写 AGENTS.md 或别记）	✅ 它的主场
「依赖只用 pnpm」（必须每次生效→写 AGENTS.md）	常用的技术栈
「这次先用 8081 端口」（一次性）	反复出现的工作流
数据库密码 / API key / token（红线！）	踩过的坑和修复方案

三条原则：

必须每次生效的→写 AGENTS.md。Memories 是概率性的，不可靠。
会变的/一次性的→不必记。下次用不上就别占预算。
密钥绝对别进记忆。会脱敏但明文落盘，分享 ~/.codex/ 前先去 memories/ 扫一眼。

06 Chronicle（实验性）

Codex 独有的实验性功能——从你屏幕的内容里学，而不只是从对话里学。

硬限制： 仅 macOS + ChatGPT Pro 订阅。EU/英国/瑞士不可用。

开启： Codex App 设置 → Personalization → 确认 Memories 已开 → 打开 Chronicle → 授予屏幕录制和辅助功能权限。

WARNING

官方的三条隐私警告：仅特定模型、有滞后、用户应通过 /memories 控制。

07 小结

知识点	一句话
两套记忆	AGENTS.md（你写规矩）+ Memories（Codex 自己写）
默认开关	Memories 默认关闭，需 `memories = true`
写入时机	后台异步，等会话闲够久，不是实时
存放位置	`~/.codex/memories/`，不进 git
会话控制	`/memories` 管当前会话用不用、记不记
全局控制	`use_memories` / `generate_memories` / `disable_on_external_context`
地区限制	EEA/英国/瑞士不可用
红线	密钥不进记忆

NOTE

下一篇：14 Git 工作流：自动提交、冲突解决、检查点回退。

13 · Memory ​

01 记忆分两套 ​

02 开启 Memories ​

03 它怎么工作 ​

04 控制记忆行为 ​

会话级：/memories ​

全局级：config.toml ​

05 该记什么、不该记什么 ​

06 Chronicle（实验性） ​

07 小结 ​