一、为什么需要持久记忆？
以前用 Codex 每次开新对话，都要重新交代一遍： - 你喜欢什么风格的代码 - 项目用什么技术栈 - 之前踩过哪些坑
有了持久记忆，这些不用重复说了。Codex 会把重要信息存起来，下次自动召回。
二、三档记忆系统详解
1️⃣ 全局自定义指令（最高优先级）
位置：设置 → 个性化 → 自定义指令
写入的内容，所有项目、所有对话都会自动带上。
典型用法： - 「回复用中文」 -「代码注释用英文」 -「输出要精简，不要写废话」
保存后，实际写入 ~/.codex/AGENTS.md 文件，每次启动 Codex 自动读取。
# 示例：写入自定义指令
你是一位资深全栈工程师。
- 所有回复使用简体中文
- 代码注释使用英文
- 输出要简洁，不做多余解释
- 如果用户没指定框架，默认使用 TypeScript
2️⃣ 项目级 AGENTS.md
位置：项目根目录下的 AGENTS.md 文件
只在该项目中生效，适合记录项目专属规范。
创建方式一：手动创建
在项目根目录新建 AGENTS.md，写入规则即可。
创建方式二：让 Codex 自动生成 直接对 Codex 说：
帮我根据当前项目生成一份 AGENTS.md
它会分析你的代码结构、配置文件，生成一份完整的项目规范文档。
典型内容：
# 项目：my-app
## 技术栈
- Node.js 22 + TypeScript 5
- PostgreSQL 通过 Prisma ORM
- 测试：Vitest + Playwright
## 命令
- 运行测试: `npm test`
- 类型检查: `npm run typecheck`
- 构建: `npm run build`
## 约定
- 文件命名使用 kebab-case
- 所有数据库查询走 `src/db/queries/`，禁止内联 SQL
- 禁止修改 `src/generated/` 目录
## 禁止事项
- 禁止自动运行数据库迁移
- 禁止修改 `.env` 文件
3️⃣ 自动记忆（最省心）
位置：设置 → 个性化 → 启用记忆
开启后，Codex 会在对话空闲一段时间后，自动在后台总结有用信息存入记忆文件。
记忆内容示例： - 你的编码偏好 - 常用工作流 - 技术栈信息 - 踩坑记录
注意：
- 太短的对话不会触发记忆
- 额度快用完时也会跳过
- 建议定期审查记忆文件 ~/.codex/memories/
三、如何开启自动记忆？
方法一：桌面端设置（推荐）
- 打开 Codex → 设置
- 进入「个性化」
- 找到「记忆」选项，开启开关
- 确认权限弹窗
方法二：修改配置文件
编辑 ~/.codex/config.toml，添加：
[features]
memories = true
四、记忆文件的存储位置
~/.codex/memories/
├── summaries/ # 对话摘要
├── durable_entries/ # 持久化条目
├── recent_inputs/ # 近期输入
└── evidence/ # 佐证材料
⚠️ 安全提醒：记忆文件中可能会包含敏感信息。Codex 会自动脱敏 API Key，但建议在分享给他人前，先检查记忆文件内容。
五、高级配置（config.toml）
如果想精细控制记忆行为，可以编辑 ~/.codex/config.toml：
[memories]
generate_memories = true # 是否允许新线程生成记忆
use_memories = true # 是否将已有记忆注入未来会话
disable_on_external_context = true # 使用 MCP/搜索的线程不生成记忆
min_rate_limit_remaining_percent = 20 # 剩余配额低于此值不生成记忆
extract_model = "gpt-5.4-mini" # 单线程记忆提取模型
consolidation_model = "gpt-5.5" # 全局记忆整合模型
六、线程级控制
在对话中使用 /memories 命令，可以控制当前线程的记忆行为：
- 是否使用已有记忆
- 当前线程是否可以作为未来记忆的生成来源
💡 最佳实践：把明确的规则写在 AGENTS.md 里（可版本控制、可团队协作），把个人偏好交给自动记忆（随用随学、无需手动维护）。
来源：程序员鱼皮《Codex 又叕重置额度了！送你一份零基础实战教程》（腾讯新闻，2026-08-01）；OpenAI 官方文档《Memories》（developers.openai.com/codex/customization/memories）
资料最后核对日期：2026-10-01 · 内容整理自 CodexGuide 社区公开教程