让 Codex 和 Claude Code 不再失忆：用 Obsidian 管理你的长期 AI 记忆

能读文件，不等于有记忆

Codex、Claude Code、Cursor 这些工具已经可以直接进入你的项目文件夹或笔记库，读取本地文件，再基于真实上下文工作。这比网页聊天强太多了。

但用了一段时间你会发现一个问题：AI 进了文件夹，还是在临时找材料。它能打开文件，不代表它知道哪些文件最重要。每次新对话，它都不知道上次验证过什么、放弃过什么、你的偏好是临时的还是长期的。

说白了，它能读，但没有记性。 我想补的就是这一层：在 Obsidian 里放一组 Markdown 文件，专门记录项目背景、个人偏好、历史决策和常用流程。Codex 可以读，Claude Code 可以读，Obsidian 插件也可以读。只要 AI 能访问本地文件，它就能用这套记忆。

这套记忆最先解决的是入口问题。AI 不用每次都从整个 vault 里猜，而是先读固定的几份文件，再根据任务去找相关资料。

更重要的是，它能把跨对话的经验留下来。踩过的坑、跑通的流程、已经否定过的方向，如果不写进某个稳定位置，下次对话基本就等于没发生过。尤其是”为什么不做某件事”，这类信息很容易丢，但对 AI 特别有用。否则它会反复建议你已经否定过的方案，特别烦。

还有一个附带好处：这些记忆是 Markdown 文件，不属于某一个聊天产品。今天 Codex 读，明天 Claude Code 读，后天 Obsidian 插件读，都可以。

这里有个实际经验：记忆文件不是越多越好。让 AI 每次扫描整个 vault，看起来很智能，实际很容易读到过期信息和无关材料。给它一个清晰入口，效率会高很多。

系统搭建

💡

懒人方案

不想手动搭？直接把这篇文章丢给 Codex、Claude Code，或者任何能读取本地文件的 AI 工具，然后说：

“请先阅读这篇文章，总结核心思路，然后在我的 Obsidian vault（路径：xxx）里搭建一套 AI 长期记忆系统。不要照抄文章，根据结构和原则生成适合我的文件。不要动我现有的笔记。”

想了解背后的逻辑，或者想自己一步步搭，继续往下看。后面会有一些提示词，直接复制就能用。

结构和创建

在你的 Obsidian vault 里建一个文件夹，我用 Codex 这款软件，所以文件夹就统一叫 Codex

第一版只需要三个文件，真的就三个：

Codex/
  AGENTS.md      ← 规则文件：告诉 AI 怎么使用这套记忆
  INDEX.md       ← 路由文件：告诉 AI 不同任务该读哪些文件
  user.md        ← 个人偏好：AI 从你的 vault 中提取生成

不要一开始就建一堆空文件夹。空文件夹没有意义，还会给 AI 一种”这里应该有东西”的错觉。等后面真有内容要放了，再按需创建 projects/、workflows/、decisions/ 这些目录。

这里我会给两个硬限制：

• AGENTS.md 控制在 100 行以内。 这个文件 AI 每次都会读，越短越好。每一行都问自己：删掉它 AI 会不会犯错？不会就别写。
• 每个记忆文件控制在 50-100 行。 AI 每读一个文件都在消耗它的”工作记忆”（术语叫 context window），文件越多越长，留给干正事的空间就越小。一次对话加载的记忆文件别超过 3-5 个。

下面这段提示词可以直接复制给 AI，让它一次性帮你把骨架搭好：

请在我的 Obsidian vault 中创建一套 AI 长期记忆系统。

我的 Obsidian vault 路径是：
【替换成你的 vault 路径】

请创建文件夹 Codex，并在其中创建三个核心文件：

1. AGENTS.md —— AI 使用这套记忆系统的规则，控制在 100 行以内。
   至少包括以下规则：
   - 重要会话开始时，先读取 AGENTS.md 和 INDEX.md
   - 只读取当前任务相关的记忆文件，不要扫描整个 vault
   - 只保存长期可复用的信息，不保存临时聊天
   - 每个记忆文件控制在 50-100 行以内
   - 单次会话加载的记忆文件不超过 3-5 个
   - 发现过期、重复或冲突记忆时，先提醒我，不要擅自删除
   - 写入记忆前先列出候选内容，等我确认后再写入
   - 当记忆和我的最新指令冲突时，以最新指令为准
   - 不要在记忆文件中保存密码、客户隐私等敏感信息

2. INDEX.md —— 路由表，告诉 AI 不同类型任务应该读取哪些文件。
   格式参考：

   | 任务类型 | 建议读取 |
   |:---|:---|
   | 写文章 | user.md, workflows/writing.md |
   | 做项目开发 | user.md, projects/当前项目.md |
   | 做决策 | user.md, decisions/ 相关文件 |

3. user.md —— 我的个人偏好。请先轻量扫描我 vault 中的日记、项目笔记和
   常用文件，从中提取我的工作习惯、协作偏好和表达风格，
   生成初版 user.md，然后列出来让我确认和修改。

不要创建其他文件夹。后续需要 projects/、workflows/、decisions/ 时再按需创建。

要求：
- 所有文件用 Markdown，内容用中文
- 规则要简洁、明确、可执行
- 不要移动、删除或改动我 vault 中已有的文件

生成 vault 地图

创建完核心文件后，先别急着让 AI 总结你的整个 vault。我试过，直接全量总结会冒出一大堆噪音。

更好的方式是让它先画一份”地图”——不是详细总结，而是让 AI 知道你的 vault 里大概有哪些区域、哪些文件值得以后重点看。

请按照 Codex/AGENTS.md 和 Codex/INDEX.md 的规则，轻量读取我的 Obsidian vault，
并生成 Codex/vault-map.md。

要求：
1. 只读取目录结构、文件名和少量核心入口文件。
2. 不要全量读取整个 vault，不要复制原始笔记全文。
3. 识别主要项目、内容主题、工作流、素材区域和历史资产。
4. 值得后续重点读取的文件，只在 vault-map.md 中列为入口，不要立刻展开。
5. 不确定的区域标注为"待确认"，不要强行推断。

有了这份地图，AI 以后遇到具体任务时，至少知道从哪里开始找，而不是每次都在瞎猜。

补三类最有价值的记忆

记忆系统刚搭好的时候不用追求完整。让 AI 基于 vault 地图，优先提取三类最值钱的信息：

1. 项目记忆：当前项目的状态、目标、约束、下一步。
2. 流程记忆：你反复使用的工作方法（写文章、做视频、复盘项目等）。
3. 决策记忆：已经做出的关键取舍，尤其是”为什么不做某件事”。

请基于 Codex/vault-map.md，帮我建立第一批长期记忆。

请从我的 vault 中提取三类内容：
1. 当前最重要的项目 → 写入 Codex/projects/
2. 我反复使用的工作流程 → 写入 Codex/workflows/
3. 已经做出的关键选择和取舍 → 写入 Codex/decisions/

如果相应文件夹不存在，请先创建。

要求：
- 从 vault 中的实际内容提取，不要让我手动填写。
- 只保存未来会复用的信息，不要复制原始笔记全文。
- 每条记忆尽量短，保留判断和理由，每个文件控制在 50-100 行。
- 不确定的信息标注"置信度低"或写明来源不足。
- 提取完成后先列出来让我确认，确认后再写入文件。
- 同时检查 INDEX.md 是否需要新增入口。
- 不要为了填满结构而硬写内容，空着也可以。

做到这里，这套系统就能用了。它不会突然变成一个完全懂你的助理，但至少下次开始任务时，它有地方可以查：你现在在忙什么、有哪些偏好、哪些弯路不要再走。

一个具体的例子

光说结构可能还是有点抽象，这里展示几个记忆文件实际长什么样。

user.md（AI 从你的 vault 中提取生成，你确认后定稿）：

---
status: active
updated: 2026-05-27
---

# 个人偏好

## 工作习惯
- 喜欢先出 MVP 再迭代，不追求一步到位。
- 偏好简洁的代码和文字，厌恶过度抽象和冗长表达。
- 写作时习惯先列大纲再填充。

## 协作偏好
- AI 给建议时，先说结论再说理由。
- 不需要鼓励性语言。
- 重要决定不要自动执行，先列出候选方案让我选。

## 技术偏好
- 前端偏好 React + TypeScript。
- 文档和笔记全部用 Markdown。
- 能用本地工具就不用云服务。

decisions/2026-05-不做小程序.md：

---
status: active
created: 2026-05-15
confidence: high
---

# 决策：当前阶段不做小程序

## 结论
专注 Web 端，不做微信小程序。

## 原因
1. 目标用户主要在桌面端，移动端需求不到 10%。
2. 小程序审核流程会拖慢迭代速度。
3. 当前只有一个人，无法同时维护两个端。

## 触发条件
如果移动端流量超过 30%，重新评估。

这些文件不需要一次写完。让 AI 先从你的 vault 里提取一版，你看看对不对，改改就行。后面真遇到新项目、新流程、新决策，再慢慢补。

加入自定义指令

如果每次开聊都要手动说一句”先读 AGENTS.md”，那这套系统迟早会被你忘掉。所以建议把下面这段加进你常用 AI 工具的自定义指令里，一劳永逸：

请使用我的 Obsidian AI 长期记忆系统作为跨项目、跨会话的外部记忆。

记忆库路径：
【替换成你的 vault 路径】/Codex

在重要会话开始时：
1. 先读取 AGENTS.md。
2. 再读取 INDEX.md。
3. 判断当前任务需要哪些记忆文件。
4. 只读取与当前任务相关的记忆文件，不超过 3-5 个。

当本次会话产生长期可复用的信息时：
- 项目状态和下一步写入 projects/。
- 可复用流程写入 workflows/。
- 重要决策和理由写入 decisions/。
- 稳定的个人偏好写入 user.md。
- 暂时无法归类但可能有用的信息写入 inbox.md。

不要保存一次性聊天内容、未经验证的猜想、敏感信息或纯粹的临时 brainstorm，除非我明确要求。

写入记忆前先列出候选内容，等我确认后再写入。

当记忆内容和我的最新明确指令冲突时，以我的最新指令为准。

加好之后你不用管它。大多数正式任务里 AI 会自己去读记忆；你随口问个小问题，它也不会每次都大动干戈去翻记忆库，没必要。

如果哪次你觉得 AI 好像没读记忆，补一句”按 Codex 记忆系统开始这次任务”就行，很简单。

平时怎么使用

因为规则已经写在 AGENTS.md 里了，平时你不需要重复那些规则，也不需要记任何英文文件夹名。正常情况下，AI 会根据规则判断该放哪里；不确定时，它应该先问你。

日常就三句话的事：

开聊时——如果你加了自定义指令，其实大多数时候不用说这句，AI 会自己去读记忆。但如果你觉得它好像没读，提醒一下就行：

用 AI 记忆系统开始。

中间有值得记住的东西时——比如做了一个重要决定、跑通了一个流程、改变了项目方向，随口说一句就行：

帮我把这些决定记录到 Codex 文件夹中。

你不用说”写入 Codex/decisions/“——AI 读过 AGENTS.md，它知道该放哪里。

结束时——如果这次对话内容比较重要，可以让 AI 自己判断：

这次聊的东西有没有值得保存在记忆系统中的？帮我看看。

就这么简单。不是每次对话都需要更新记忆。记忆库最怕的不是信息少，而是信息脏。值得保存的通常就这几种：项目方向变了、长期偏好被修正了、某个流程跑通了、某个方向被明确放弃了。其他的随它去吧。

怎么处理冲突和过期记忆

这套系统创建起来不难，真正难的是维护。记忆库如果只进不出，用不了多久就会变成垃圾堆。

不过别被吓到——维护不需要每条都做，做好最重要的一两条就够了。 如果你只做一件事，那就做”定期审查”；如果愿意多花点心思，再加上”冲突处理”。下面这几个机制是完整版，按你自己的节奏慢慢来就好。

1. 给日记留一个更新入口

很多重要变化是藏在日记、周记、随手记录里的。但千万不要让 AI 每天自动把日记全塞进长期记忆——日记是原始材料，不是长期记忆。

更好的方式是每周让 AI 从日记里”淘”一次，看看有没有值得进入长期记忆的变化：

请阅读我最近的日记和周记，提取可能值得进入 Codex 长期记忆的信息。

只提取这几类：
1. 项目方向、状态、下一步发生变化。
2. 做出了新的重要决定。
3. 明确否定或放弃了某个方向。
4. 反复提到某个稳定偏好或工作方式。
5. 某个流程、方法跑通了，以后还会复用。

要求：
- 先列出候选记忆，不要直接写入。
- 每条标注建议写入的文件、来源和置信度（高/中/低）。
- 临时情绪、流水账、未经验证的想法，不要写入。

2. 冲突时别急着删，留下来龙去脉

记忆冲突太常见了：项目方向从 A 变成 B、以前觉得好的工具后来发现不合适、写作风格变了。

碰到这种情况不要直接删旧内容。当前有效的结论写在项目文件或 user.md 里，变化原因写进 decisions/，旧内容有参考价值的移到 archive/。

关键是：不要只改结论，还要留下”为什么变了”。否则过一段时间，AI 只知道现在是 B，却不知道为什么不是 A——然后它可能又建议你回到 A 去。

3. 给记忆加个状态标签

这一步不是必须的，但做了以后会舒服很多。给重要记忆文件加几个简单字段：

---
status: active       # active / superseded / archived / draft
updated: 2026-05-27
confidence: high     # high / medium / low
---

AI 看到 superseded 就知道这条记忆已经过时了，不会再拿来当现成结论用。

4. 定期做一次记忆审查

建议每两周或每月做一次。如果所有维护动作你只选一个，就选这个。

请审查 Codex 记忆系统，做一次清理建议。

检查：是否有重复记忆、过期项目、互相冲突的判断、置信度低但被当成事实的内容、
inbox.md 中应该归类的内容、INDEX.md 中过期的入口。

先输出建议（分为：应更新、应归档、应删除、待确认），不要直接删除，等我确认。

不用每次大扫除，但隔一段时间清理一下，系统就不容易变成新的负担。

5. 可持续的节奏

总结一下我自己的节奏，供参考：

• 平时正常写日记、项目笔记，该怎么用 Obsidian 还怎么用。
• 重要任务结束时，让 AI 判断一下是否需要更新记忆。
• 每周从日记里提取一次候选记忆。
• 每两周或每月做一次审查。
• 重大方向变化时，必须写进 decisions/，这条比较重要。

记忆库不是另一个需要你手动维护的大工程。它更像是从日常笔记里长出来的一层”AI 可读摘要”——你正常做笔记，它在旁边帮你攒经验。

最后

这套东西我也还在继续试。如果你也在用 Codex、Claude Code 或者 Obsidian AI 插件，有更好的思路，欢迎留言聊聊。