Codex Memories：哪些偏好适合记住，哪些必须留在项目里

适用场景

这篇手册适合想让 Codex 记住个人偏好的用户。Memories 可以减少重复说明，但不能替代项目规则，也不能保存敏感信息。

OpenAI 官方文档提供了 Codex Memories 说明。具体产品行为可能随版本变化，应以当前官方页面和客户端设置为准。

步骤 1：先区分记忆和项目规则

适合 Memories：

• 你个人偏好的回答风格。
• 常用语言偏好。
• 你希望 Codex 默认如何汇报结果。
• 与所有项目都相关的个人习惯。

适合 AGENTS.md：

• 项目目录结构。
• 运行和测试命令。
• 代码风格。
• 内容 frontmatter 要求。
• 不能修改的文件。

适合当前提示词：

• 本次任务目标。
• 本次修改范围。
• 本次临时限制。

步骤 2：不要保存敏感信息

不要保存：

• API key。
• token。
• 密码。
• 客户数据。
• 内部系统地址。
• 私有仓库访问方式。

即使只是“为了方便”，也不要把秘密写成记忆。

步骤 3：用简短、稳定的偏好

好的记忆应该短、稳定、可复用。

示例：

用户偏好中文回答，技术说明保持简洁，并在完成代码修改后说明验证结果。

不好的记忆：

今天下午先帮我改 manual 页，暂时不要管 screenshots。

第二个只是临时任务，应留在当前对话里。

步骤 4：项目协作不要依赖个人记忆

团队项目不能依赖某个人的 Memories。

如果规则对项目重要，写进仓库：

# AGENTS.md

- 手册文章放在 content/manual。
- 没有官方截图时不使用概念图。
- 修改路由后运行 next build。

这样不同人、不同机器、不同 Codex 表面都能执行同一套规则。

步骤 5：定期清理过期记忆

偏好会变化，过期记忆会干扰任务。

建议检查：

• 是否有旧项目的偏好。
• 是否有已经不用的输出格式。
• 是否有可能误导当前任务的规则。
• 是否包含不该保存的信息。

如果不确定某条记忆是否还需要，宁可删除。

常见错误

不要把临时任务写成长期记忆。

不要把项目规范只存在 Memories 里。

不要保存秘密信息。

不要让 Memories 和 AGENTS.md 冲突。项目规则应优先明确写在仓库。

小结

Memories 适合保存个人、稳定、跨项目的偏好；项目规则应写进 AGENTS.md；当前任务限制应写在提示词里；敏感信息哪里都不应该随意保存。