第16课 · 让 AI 记住你
本节要点
- 理解 CLAUDE.md / AGENTS.md 记忆文件的作用和原理
- 三大 AI 编程工具（Claude Code、OpenCode、Codex）的记忆文件对比
- 三级加载体系：全局 → 项目 → 子目录
- 写好记忆文件的 5 个原则
- 实战：创建属于自己的记忆文件
1. 你是不是每次都要重复说一遍？
用 AI 工具的时候，你一定遇到过这种情况：
- 每次新对话都要说"请用中文回复"
- 每次都要告诉它"我是做审计的"
- 每次都要指定"输出用表格格式"
- 每次都要提醒"代码注释用中文"
有没有办法让 AI 记住这些，不用每次都重复？
答案是有的。所有 AI 编程工具都有一个记忆文件，它就像给 AI 的一份「入职手册」——新员工第一天看手册就懂规矩，AI 也是一样。
2. 三大 AI 编程工具的记忆文件
三大工具都支持记忆文件，只是文件名和放置位置不同：
| 对比项 | 🟠 Claude Code | 🔵 OpenCode | 🟣 Codex |
|---|---|---|---|
| 记忆文件 | CLAUDE.md | AGENTS.md | AGENTS.md |
| 全局路径 | ~/.claude/CLAUDE.md | ~/.config/opencode/AGENTS.md | ~/.codex/AGENTS.md |
| 项目路径 | ./CLAUDE.md | ./AGENTS.md | ./AGENTS.md |
| 特殊能力 | Auto Memory + Rules | 兼容读取 CLAUDE.md | Override 覆盖机制 |
实际使用中，三个工具的体验差别不大。我自己用 Claude Code 和 OpenCode，并没有感觉到多少区别。
唯一的一点区别：在 Claude Code 中，如果你跟 AI 说"记住这个"，它可能会把信息写到单独的 MEMORY.md 文件里，而不是直接写进 CLAUDE.md。你可以自己试试。
3. 三级加载体系
三个工具都有一个共同的特点：三级加载。
第一级：全局级
放在家目录下的配置文件。
不管你在哪个项目里打开 AI 工具，全局级的记忆都会被无条件读取。
适合放：个人偏好、常用路径、回复语言等所有项目通用的信息。
第二级：项目级
放在项目根目录里的配置文件。
只有当你用 AI 工具打开了这个项目文件夹，它才会被加载。
适合放：这个项目的特殊约定、编码规范、数据路径等只在当前项目生效的信息。
第三级：子目录级
在项目的子文件夹里也可以创建记忆文件。
适合放：某个模块的特殊规则，只在该子目录下生效。
加载规则
- 三级文件全部加载，不是只读一个
- 后加载的会补充前面的，不是覆盖
- AI 把所有内容合并理解后执行
4. 记忆文件里可以写什么？
以我自己为例。我的全局记忆文件在 ~/.config/opencode/AGENTS.md，里面有这些内容：
- 用中文回复
- Python 开发者，熟悉终端
- 常用的服务器连接信息（避免每次都要告诉它）
- Obsidian 仓库路径
这些内容不一定是必须的，你可以把对你最重要的信息加进去。
而且，这些内容不用自己写。你可以直接告诉 AI："帮我把这个信息记忆到 AGENTS.md 里面"，AI 工具会自己帮你写。
比如我在录制这个 AI 课程的时候，课程的记忆信息就放在课程项目文件夹的 AGENTS.md 里。这些信息只对课程项目生效，其他项目不会读到。
5. 除了记忆文件，还有其他记忆方式吗？
记忆文件不是唯一的让 AI 记住你的方式。常见的还有：
| 记忆方式 | 持久性 | 适合场景 |
|---|---|---|
| 记忆文件（本课重点） | ⭐⭐⭐ 永久 | 个人偏好、项目约定 |
| 系统提示 / Custom Instructions | ⭐⭐ 半永久 | 通用人格、回复风格（如 ChatGPT 的自定义指令） |
| Auto Memory（Claude Code） | ⭐⭐ 半永久 | AI 自动记录工作笔记 |
| 对话上下文 | ⭐ 临时 | 当前对话里的历史消息，关闭就没了 |
| 插件记忆 | ⭐⭐ 半永久 | 如 OpenCode 的 opencode-agent-memory 插件 |
我的建议：用好记忆文件就够了，不需要装额外的记忆插件。
原因很简单：每次新对话应该是上下文干净的。如果塞了太多历史信息，反而会造成上下文污染，让 AI 的回答质量下降。大部分历史会话里的信息对当前任务来说是没用的。
我自己没有安装任何记忆插件，记忆文件已经完全够用。
6. 实战：创建你的记忆文件
创建记忆文件有两种方式：
方式一：让 AI 帮你创建
在对话中直接告诉 AI：
帮我记住以下信息，加到 AGENTS.md 里：
- 我是一名审计师，主要用 Python
- 回复用中文
- 代码注释也要用中文或者更简单：
我希望你帮我记忆一下，下次不要忘记AI 会自动帮你写入记忆文件。
方式二：手动创建
自己用编辑器创建文件，直接写内容。
全局记忆文件示例（所有项目通用）：
## 关于我
- Python 开发者，审计背景
- 中文沟通，代码注释也用中文
## 回复要求
- 默认用中文回复
- 解释要简洁，带适度背景
- 示例用 Python 写
## 常用路径
- 工作文档：/Users/xxx/Documents/项目记忆文件示例（审计项目专用）：
## 项目：XX公司年审
## 编码规范
- 文件命名：科目_程序表.py
- 输出格式：Excel，带格式
- 金额单位：万元
## 注意事项
- 凭证数据在 ./data/ 目录
- 不要修改原始数据文件
- 报告模板在 ./templates/一次写好，每次打开 AI 都自动遵循，不用再提醒。
7. 写好记忆文件的 5 个原则
原则一：简洁，不超过 200 行
AI 指令超过 150 条后遵从度会下降。只写真正有用的，不要写废话。
原则二：具体且可验证
❌ "代码要写好" — 太笼统
✅ "用 Python，函数加 type hints，注释用中文" — 具体可验证
原则三：分层放置
通用偏好放全局，项目约定放项目文件夹，局部规则放子目录。不要把所有东西都堆在一个文件里。
原则四：不要写 AI 本来就懂的东西
像格式问题、代码规范这种 AI 本来就懂的知识，不用写。只有在实际沟通中发现 AI 做得不对的地方，才值得加到记忆文件里。
原则五：持续迭代
发现 AI 反复犯错？加一条到记忆文件里，以后就不再犯了。记忆文件不是写一次就完事的，它应该随着你的使用不断优化。
善用网络资源
网上有大量优秀的 CLAUDE.md / AGENTS.md 示例。你可以直接搜索"CLAUDE.md best practices"或"AGENTS.md 示例"，看看别人是怎么写的，借鉴适合自己的部分。GitHub 上也有很多开源项目的记忆文件值得参考——站在巨人的肩膀上，不用从零开始。
⚠️ 常见问题
记忆文件改了要重启吗？
不需要。记忆文件每次新对话开始时自动加载，改完直接开新对话就生效了。
全局和项目的记忆冲突了怎么办？
不会冲突。后加载的（项目级）是补充全局的，不是覆盖。如果确实有矛盾，以项目级的为准。
可以让 AI 自动更新记忆文件吗？
可以。直接在对话中说"帮我把这个加到记忆文件里"，AI 会自动写入。但建议你偶尔检查一下写入的内容，确保准确。
记忆文件会很大吗？
建议控制在 200 行以内。内容越多，AI 遵从度越低。只写最重要的规则。
Skill 里面也有类似的信息，和记忆文件有什么区别？
Skill 是按任务触发的，只有当你执行特定任务时才加载。记忆文件是每次对话都加载的，是更基础的全局设置。两者互补。
关键收获
TIP
记忆文件（CLAUDE.md / AGENTS.md）就是给 AI 的入职手册。一次写好，每次对话 AI 都自动遵循。写好记忆文件的关键是：简洁（<200 行）、具体可验证、分层放置、不写废话、持续迭代。创建方式也很简单——直接告诉 AI "帮我记住"，或者自己手动创建 Markdown 文件。用好记忆文件就够了，不需要装额外的记忆插件。
下一步
你已经学会了让 AI 记住你。但 AI 的记忆只有这些基础配置还不够——在实际工作中，你会遇到大量重复性的操作流程。
下一节课，我们会学习如何把这些重复性的工作流程自动化，让 AI 真正成为你的效率搭档。
更多课程：课程大纲