摘要
Codex App 用户普遍因工具缺乏稳定长期记忆，面临重复沟通、上下文缺失导致的意外执行等核心痛点，严重影响工作效率。本文系统讲解通过AGENTS.md 分层配置与Memories 自动记忆功能构建完整记忆体系的方法：AGENTS.md 采用全局 + 项目双层架构，分别承载通用规则与项目专属规范；Memories 功能可自动沉淀对话中的有效信息。结合规则分层、按需迭代、保持精简三大最佳实践，可实现 Codex 对用户意图的精准理解，综合提效可达 90%。
一、问题本质：Codex 长期记忆缺失的痛点
在使用 Codex App 进行开发、自动化任务与日常办公时，用户常遇到两类高频问题：每次新建对话需重复说明语言偏好、安全边界等基础要求；因工具不了解项目背景与操作规范，易执行超出预期的系统命令或生成不符合标准的内容。这些问题的核心并非工具能力不足，而是缺乏可跨会话继承的长期记忆机制，导致大量无效沟通与操作返工。
二、AGENTS.md：静态规则的核心载体
1. 功能定位
AGENTS.md 是 Codex 的核心规则配置文件，每次启动时会自动加载并全局生效。未配置该文件时，Codex 每次会话均处于无上下文的初始状态；通过预先定义标准化规则，可实现用户偏好、操作边界与项目规范的永久生效，彻底消除重复说明。
2. 分层配置方法
AGENTS.md 采用就近优先级原则（子目录 > 根目录 > 全局），建议按以下两层架构配置：
全局层：存放于 ~/.codex/AGENTS.md，对应 Codex App「个性化设置 - 自定义指令」页面，对所有项目生效。适合配置通用规则，推荐基础模板如下：
# AGENTS.md 全局配置
## 基础行为
- 默认使用中文回答，任务描述不清晰时先提问确认
- 回答简洁直接，不主动推测用户未明确的需求
## 安全边界
- 默认只读模式，不可逆操作前必须二次确认
- 禁止输出密钥、Token 等敏感凭证
## 工程规范
- 避免过度设计，仅完成任务明确要求的改动
- 仅在逻辑不自明时添加注释，直接删除无用代码
项目层：存放于项目根目录，针对特定项目定制规则。核心应包含：项目背景与目录结构、启动 / 测试 / 部署执行命令、代码风格与提交规范、任务交付验收标准。
3. 最佳实践
规则分层，职责清晰：全局层仅放通用规则，项目层存放专属规范，避免局部规则意外覆盖全局底层逻辑。
从基础开始，按需迭代：无需一次性写全所有规则，当 Codex 重复犯错时，可通过指令让其自动复盘并更新规则："你刚才犯了和上次相同的错误，请总结原因并补充到 AGENTS.md 中"。
保持精简，拆分复杂内容：将项目架构、API 文档等复杂内容单独写成文件，在 AGENTS.md 中通过引用方式关联，避免主文件臃肿。
三、Memories 功能：动态记忆的自动沉淀
除静态规则外，Codex 提供 Memories 自动记忆功能，用于动态提取对话中的关键信息。该功能需在「设置 - 个性化 - 记忆」中开启，开启后 Codex 会自动总结用户偏好、操作习惯与项目细节，写入 ~/.codex/memory/Memory.md 文件。用户可随时查看与编辑该文件，手动修正或补充记忆内容，实现静态规则与动态记忆的互补。
结语
构建 Codex 记忆系统是一个持续进化的过程。通过 AGENTS.md 建立标准化静态规则，结合 Memories 功能沉淀动态使用经验，可逐步让 Codex 成为最理解用户意图的个性化生产力工具，显著降低沟通成本，提升任务执行效率。
评论(0)