3.9 记忆系统
让 Codex 记住一些长期有用的信息，方便以后继续工作。
项目级AGENTS.md
“` 写给 Codex 看的项目规则说明书。 “`
小白可以这样理解：
| 文件 | 主要读者 | 作用 | | — | — | — | | README.md | 人 | 告诉人这个项目是什么、怎么安装、怎么使用 | | AGENTS.md | Codex / AI Agent | 告诉 AI 在这个项目里应该怎么工作 | | .gitignore | Git | 告诉 Git 哪些文件不要上传 |
AGENTS.md 放在哪里
| 放置位置 | 作用范围 | 简单来说 | | — | — | — | | 项目根目录 AGENTS.md | 整个项目 | 当前项目的总规则 | | 子目录里的 AGENTS.md | 当前子目录及相关任务 | 某个模块的专属规则 | | 用户级 `~/.codex/AGENTS.md` | 你所有项目 | 个人通用规则 | | 项目级 AGENTS.md + 用户级 AGENTS.md | 叠加生效 | 个人习惯 + 当前项目规则 |
如何写 AGENTS.md
可以直接交给AI来写，让AI总结这个项目的核心内容制作成 AGENTS.md
前端项目 AGENTS.md 模板
“`
AGENTS.md
项目说明
这是一个前端网页项目，用于构建产品页面、工具页面或个人作品展示页面。
技术栈
– React – Vite – Tailwind CSS – JavaScript / TypeScript
常用命令
– 安装依赖：\`npm install\` – 启动项目：\`npm run dev\` – 构建项目：\`npm run build\`
项目结构
– \`src/\`：主要源代码 – \`src/components/\`：通用组件 – \`src/pages/\`：页面文件 – \`src/assets/\`：图片、图标等静态资源 – \`public/\`：公开静态文件
代码规范
– 优先使用 React 函数组件 – 优先使用 Tailwind CSS 写样式 – 不要引入 Bootstrap – 不要大范围重构无关代码 – 修改时保持文件结构清晰 – 中文文案要自然、简洁、适合普通用户阅读
UI 规则
– 页面要有清晰的信息层级 – 按钮、卡片、标题、留白要统一 – 移动端要基本可用 – 不要过度渐变、阴影和 AI 模板感 – 优先做真实产品感，而不是 Demo 感
禁止事项
– 不要修改 \`.env\`、\`.env.local\` – 不要输出 API Key、token、密码 – 不要删除已有核心功能 – 不要随意新增大型依赖 – 不要直接改动和当前任务无关的文件
完成任务后
每次修改完成后，请输出：
1. 修改了哪些文件 2. 每个文件改了什么 3. 为什么这样改 4. 是否需要运行 \`npm run build\` 5. 提醒我检查 diff “`
好的 AGENTS.md 有什么特点
| 特点 | 说明 | | — | — | | 具体 | 写清楚技术栈、命令、目录 | | 简洁 | 不要写成长篇废话 | | 可执行 | Codex 看了知道怎么做 | | 有限制 | 明确哪些文件不能碰 | | 有验证 | 写清楚运行什么命令检查 | | 有完成标准 | 让 Codex 知道交付什么 | | 可维护 | 项目变化后及时更新 |
全局级AGENTS.md
打开Codex的设置，找到个性化
输入指令，这里的指令会作为你的个人通用偏好影响后续 Codex 会话
使用AI编程的时候最怕AI乱删东西，可以用以下指令
禁止批量删除文件或目录。
不要使用：
– `del /s` – `rd /s` – `rmdir /s` – `Remove-Item -Recurse` – `rm -rf`
需要删除文件时，只能一次删除一个明确路径的文件。
正确示例：
“`powershell Remove-Item “C:\path → \file.txt” “`
如果需要批量删除文件，应停止操作，并向用户请求，让用户手动删除。
Codex记忆的最佳使用方法
很多人用 Codex 最大的问题，不是不会提问。
而是每次都从零开始交代：
> “我的项目怎么跑测试” “我喜欢什么输出风格” “这个仓库有哪些坑” “这个流程上次做到哪一步” “这些资料在哪里”
这其实是在把“记忆系统”当聊天记录用。
更好的方式，是把不同类型的信息放到不同的上下文层里，让 Codex 在合适的时候读取合适的信息。
先看一张总表：
| 你想让 Codex 记住什么 | 推荐放哪里 | 不建议放哪里 | 原因 | | — | — | — | — | | 当前任务的临时要求 | 当前 prompt / 当前会话 | AGENTS.md | 只用一次，不要污染长期规则 | | 个人偏好、常见习惯 | Memories / 全局 AGENTS.md | 每次重新说 | 稳定但不一定要进项目仓库 | | 仓库规则、测试命令、目录约定 | repo 的 AGENTS.md | Memories | 这是硬规则，应该随项目走 | | 可复用工作流 | Skill | AGENTS.md | Skill 能放参考文件、脚本、模板 | | 定期复盘、跟进、监控 | Automations | 记在脑子里 | 需要按时间唤醒，不是静态规则 | | Slack / GitHub / Docs 里的实时资料 | MCP / Connector | 手动复制粘贴 | 外部信息会变，应该现取现用 |
当前会话 / prompt：最适合放“这次任务”的要求
当前会话就是最短期的记忆，只用于这次任务，几乎不会重复使用。
比如：
> “这次网页背景改成蓝白色调” “在网页右上角加一个登录按钮” “这个方案只考虑 Windows” “先别提交 PR”
这类信息只对当前任务有用，不应该沉淀成长期规则。
如果把临时要求写进 AGENTS.md，后面每次打开项目，Codex 都可能误以为这是长期规则，反而会污染上下文。
Memories：适合放“稳定偏好”和“常见背景”
Memories 适合保存那些跨会话、跨项目也经常有用的信息。
简单来说，Memories 是：
> Codex 对你的个人工作习惯的软记忆。
比如：
– 你偏好中文回答。 – 你希望解释尽量通俗，不要堆术语。 – 你做项目时喜欢先看方案，再动手改代码。 – 你常用 Windows、PowerShell、某些固定目录或工具链。 – 你经常要求修改后说明 diff、验证命令和未验证项。
操作步骤：
*Codex设置里开启Memories的界面*
Codex设置里开启Memories的界面
1. 在 Codex 设置里开启 Memories。 2. 用几次真实任务让 Codex 形成稳定偏好。 3. 可以在下面这个目录里查看对应的记忆文件： “` ~/.codex/memories/ “`
*Codex memories目录文件示例*
Codex memories目录文件示例
常见文件和目录大致可以这样理解：
| 名称 | 作用 | 简单来说 | | — | — | — | | MEMORY.md | Codex 最主要的长期记忆文件，通常放稳定偏好、常用工作流、技术栈、项目习惯等 | 正式记忆本 | | memory\_summary.md | 对记忆内容做压缩总结，让 Codex 更快读取核心信息 | 记忆摘要 | | raw\_memories.md | 更原始的记忆条目，可能包含从历史 thread 提炼出来的未压缩记录 | 原始记录本 | | rollout\_summaries/ | 存放某些任务、会话或运行过程的摘要，用来支撑后续记忆生成 | 过去任务摘要库 | | extensions/ | 给扩展功能使用的记忆目录 | 扩展记忆区 |
建议定期检查 Memories：
– 有没有把一次性的临时要求记进去。 – 有没有把隐私信息、密钥、账号信息记进去。 – 有没有把已经过期或错误的偏好记进去。 – 有没有重要规则只存在 Memories 里，但没有同步到 AGENTS.md 或 Skill。
一句话总结：
> Memories 是 Codex 用来记录你长期偏好和常见背景的记忆。
AGENTS.md：最适合放“必须遵守的项目规则”
AGENTS.md 是我最推荐新手先用的一层。
它的作用很像写给 Codex 的工作说明书。Codex 开始工作前会读取 AGENTS.md，并把里面的规则当成当前项目或当前用户的工作约束。
值得注意的是，AGENTS.md 可以分为全局级和项目级。
全局级 AGENTS.md 会影响你在 Codex 中的大多数项目和会话，适合放个人长期规则。
文件位置通常是：
“` ~/.codex/AGENTS.md “`
操作步骤：
*Codex个性化设置写入全局AGENTS规则*
Codex个性化设置写入全局AGENTS规则
1. 直接在 Codex 设置里的个性化区域写入规则。 2. 只写几条最重要、最稳定的规则。 3. 不要把某一次任务的临时要求写进去。
比如：
> “每次文字输出都使用 Markdown 格式。” “不确定需求时，先指出不确定点，再给推荐方案。” “不要擅自删除文件、重命名核心目录或大范围重构。”
项目级 AGENTS.md 只影响当前项目，适合放仓库规则、测试命令、目录约定和交付标准。
文件位置通常是：
“` ~/xxx项目/AGENTS.md “`
操作步骤：
*在项目根目录创建AGENTS文件*
在项目根目录创建AGENTS文件
1. 在对应项目文件夹根目录里创建 AGENTS.md。 2. 只写这个项目必须遵循的规则。 3. 如果不确定怎么写，可以让 Codex 先阅读项目，再帮你生成初版。
比如：
> “使用项目现有技术栈，不要擅自更换框架。” “不要擅自删除、重命名核心目录。” “修 bug 时，优先找到根因，不要只做表面兼容。”
最简单的模板：
“`
AGENTS.md
Project overview
这是一个前端项目，主要用于构建网页、交互页面、小游戏或内容展示页。
Tech stack
– 使用项目现有技术栈，不要擅自更换框架。 – 如果是 Vite / React / Vue / Next.js 项目，先确认 \`package.json\` 再判断运行方式。 – 不要随意引入新的生产依赖。 – 如确实需要新增依赖，先说明原因、用途和替代方案，等待确认。
Project structure
– \`src/\`：主要源码目录。 – \`public/\`：静态资源目录。 – \`components/\`：组件目录，如果项目中存在则优先复用。 – \`assets/\`：图片、图标、样式资源。 – 不要擅自删除、重命名核心目录。 – 修改前先阅读相关文件，不要只凭文件名猜测。
Working rules
– 开始修改前，先简单说明计划。 – 优先小步修改，不要一次性大范围重构。 – 保持原项目代码风格、命名风格和目录结构。 – 修 bug 时，优先找到根因，不要只做表面兼容。 – 改 UI 时，注意中文排版、信息层级、间距、按钮状态和移动端适配。 – 不要覆盖用户已有改动。
Commands
请根据 \`package.json\` 判断实际命令。常见命令如下：
npm install npm run dev npm run build npm run lint “`
Skills：适合放“可复用工作流”
如果 AGENTS.md 是项目说明书，Skill 更像一个可复用工作流包。
Skill 可以包含 SKILL.md、参考文件、脚本和资源；它适合那些反复出现、需要步骤、示例或工具辅助的任务。
比如：
| 场景 | 应该做成 Skill 吗 | | — | — | | 每次都要写同一种 X Article | 应该 | | 每次都要按固定流程做 PR review | 应该 | | 只想提醒 Codex 用 pnpm | 不用，放 AGENTS.md | | 只对当前任务有效的语气要求 | 不用，放 prompt |
用来写作的 Skill，不是只记一句“帮我写推特”。
它真正应该沉淀的是：
– 写作风格。 – 输出结构。 – Markdown 格式。 – 图片占位。 – 教程步骤。 – 推荐规则。 – 质量检查。
操作步骤：
1. 先把反复做的任务列出来。 2. 如果一个任务出现 3 次以上，就考虑做成 Skill。 3. SKILL.md 只放核心规则。 4. 长模板、风格卡、检查表放 references/。 5. 能自动化的部分再放脚本。
最后的总结
如果前面看起来有点绕，可以这样理解：
| 层级 | 比喻 | 适合放什么 | | — | — | — | | 当前会话 / prompt | 临时便签 | 这次任务的一次性要求 | | Memories | 个人习惯档案 | 稳定偏好、常见背景、长期习惯 | | 全局 AGENTS.md | 个人工作规则 | 所有项目里都要尽量遵守的硬规则 | | 项目级 AGENTS.md | 项目工作说明书 | 当前仓库的技术栈、命令、目录和禁区 | | Skill | 可复用流程包 | 经常重复、需要步骤和模板的任务 | | Automations | 定时提醒和监控 | 定期复盘、跟进、巡检、监控 | | MCP / Connector | 实时资料入口 | Slack、GitHub、Docs 等会变化的外部信息 |
*Codex记忆系统各层级总结图*
Codex记忆系统各层级总结图
最后补充一句：
> Codex 的记忆和上下文，可以按“越临时、越具体、越靠近当前任务，优先级越高”来理解。
💎 【独家资源】火儿跨境科技 VIP 资料会员：
解锁全站 500+ 实战提示词库、自动化工作流脚本、商业源码与高阶专属圈子，持续沉淀一人公司数字资产。
👉 立即开通 VIP 资料会员（月度订阅 $9.99，即刻畅享核心工具箱） | 查看会员权益与等级说明
🚀 【体系大课】火儿跨境科技 官方实战课程：
告别零散摸索，全案拆解从建站、SEO长效获客到海外广告变现的工业级闭环流水线。
👉 《谷歌SEO优化系统课程》 | 《谷歌广告全系统基础夯实课》 | 《Facebook广告投放基础夯实课》 | 查看全部实战课程专区
💡 进阶指引：本文属于《03Codex从入门到实战》系统实操专栏。如需全面掌握从零构建智能体协作开发环境与自动化工程流水线，欢迎查阅对应大盘母舰专题：AI智能体团队协同。
