跳到主内容
✍️ 公众号文章
学生
研究者
经/管/金融人
AI 教师

手把手搭建 AI 原生笔记库

手把手教你用 Claude Code/OpenCode 加 Obsidian 搭建 AI 原生笔记库:通过目录结构、CLAUDE.md 总规则和各文件夹 _index.md 索引,让 AI 自动完成记录、归档、检索与更新,形成闭环知识系统。

李学恒10 分钟阅读#ai-native-notes#claude-code#obsidian#ainote#knowledge-management

AI 原生笔记库封面

这篇文章教你搭一套 AI 原生笔记系统:以后你无论是记一条想法、存一份资料、追问一个主题,还是让它帮你继续写,入口都先是 AI,而不是你自己去翻文件夹、改标题、补链接。

为什么会有这个需求?很多人本来就有记日记、做工作笔记、整理资料、积累知识卡片的习惯,只是传统笔记大多停留在手动记录、手动分类、手动建链接、手动回忆。到了 AI 时代,更自然的升级不是多装一个聊天插件,而是把整套笔记系统变成 AI 原生:以后你和这套笔记库的主要交互都通过 AI 完成,包括记录、整理、连接、检索和调用。

这样做的价值也很直接:这套系统一旦搭好,你和笔记库的每次交互都会自动沉淀成知识资产。 没有它,你还是得自己记、自己归类、自己回忆;AI 只是偶尔帮一下忙,不会真的替你管理这套库。前期花一些时间搭起来,后面每天都在吃这笔投入的红利。

AI 原生笔记,不是在传统笔记软件里加一个聊天框,而是从记录、归档、检索到更新,AI 一开始就在流程里。 前者是 AI-added,AI 只是配件;后者是 AI-native,AI 本身就是这套系统的主入口。

啥叫 AI 原生笔记

市面上很多 AI 笔记,本质上还是老笔记软件加了个聊天框。你可以问它问题,但分类、归档、建链接,很多时候还是得自己动手。

AI 原生就不一样了。你随口说一句“今天和供应商开了个会,他们说原材料涨价 15%,两周内要决定是否锁价”,AI 会判断这是一条会议记录,搜索你已有的供应商笔记,整理成规范格式,放进会议文件夹,再把索引一起更新,全程不用你手动归类。更关键的是,它认识你,知道你的工作方向和当前项目。同一段话,给你处理和给别人处理,结果会不一样。

特征AI-AddedAI 原生
分类手动操作AI 自动判断
连接手动建链接AI 自动搜索并建立
个性化通用功能了解你这个人
记忆靠你记语义检索,永不丢失
进化功能固定越用越懂你

AI-Added 和 AI 原生对比图

需要什么工具

两个。

Obsidian :一个很好用的 Markdown 笔记阅读器,免费,所有文件都是普通 Markdown 文本,存在你电脑上,不依赖云端,换软件也能照常打开。它很适合拿来看和浏览这套笔记库。

Claude Code 或 OpenCode :能直接读写你本地文件的 AI 编程助手,这是整套系统能跑通的基础。两者都可以用,逻辑完全一样:

  • Claude Code(claude.ai/claude-code):Anthropic 官方出品,接 Claude 模型,需要付订阅费
  • OpenCode(github.com/sst/opencode):开源免费工具,可以接国内的 DeepSeek、Kimi 等模型,按用量付费,日常用下来便宜很多

安装时要在终端粘贴一条命令——如果你从没打开过终端,别担心,后面会讲具体怎么操作。

说得更准确一点:Claude Code 或 OpenCode 是这套系统真正的工作入口;Obsidian 只是一个很好用、很推荐的阅读器和浏览界面,不是必需组件。

如果你不想从零手敲目录和模板,也可以直接配合这个 GitHub 仓库快速搭建:

github.com/Xueheng-Li/AiNote

它就是这篇文章对应的最小示例仓库,已经把基础目录、CLAUDE.md 模板和常用配置整理好了。你可以直接 clone 下来;如果你喜欢 Obsidian,就把它当成一个现成的 vault 打开;如果不用 Obsidian,也完全可以照常使用这套目录和 Markdown 文件。

这里还要提醒你一个容易忽略、但其实是必不可少的部件:.claude/skills/takenote/。它是这套仓库默认的记笔记入口,最好不要删掉。 你平时记想法、整理会议纪要、处理一段原始文本时,最自然的用法不是随便聊一句,而是直接用 /takenote,或者输入“记一下”“帮我整理成笔记”这类会调用这个 Skill 的指令。

第一步:建目录结构

新建一个文件夹作为笔记库根目录,里面建几个子文件夹。参考结构:

MyNotes/
├── 1_关于我/        ← 个人背景、经历、偏好、长期项目
├── 2_想法/          ← 灵感、判断、随手记
├── 3_工作/          ← 项目和任务文档
├── 4_学习/          ← 读书笔记、课程笔记
├── 5_会议/          ← 会议记录
├── 6_研究/          ← 行业调研、深度分析
├── 7_行政/          ← 报告、汇报材料
├── 8_附件/          ← 图片、PDF
├── 9_代码/          ← 代码片段、技术备注
└── 临时工作区/       ← AI 的中间产物

这里有个和传统笔记很不一样的地方:这套系统不需要专门做一个“收件箱”。在我的实践里,Claude Code 的对话框本身就是默认入口。你有一个想法、一段会议纪要、一封邮件摘要,直接发给 Claude Code 就行;如果是 PDF、截图、录音转写这类附件,就先放进 8_附件/,再把路径发给它处理。

如果你用的是 AiNote 这套仓库,那这个“入口”最好再说得更具体一点:默认入口其实是 .claude/skills/takenote/ 也就是说,日常记笔记、收想法、整理原始材料时,优先通过 /takenote 或“记一下”来触发,而不是把它当成一段普通闲聊。

文件夹名字可以按你的工作性质调整,但最好一眼就看懂,因为 AI 也会靠这些名字判断内容该放哪里。可以继续往下分二级目录,比如工作下面再分客户 A、客户 B、内部项目。

根目录只放一个文件:CLAUDE.md,其他内容全进子文件夹。 因为对 Claude Code 来说,这个文件不是普通说明书,而是它进入这个笔记库后最先读的总规则。

AI 原生笔记库目录结构图

第二步:写 CLAUDE.md,这是整套系统的灵魂

Claude Code 在这个文件夹下工作时,每次对话开始都会自动读取 CLAUDE.md。可以把它理解成这套 AI 原生笔记系统的系统提示词。 你在里面写什么,Claude Code 就会按什么规则理解输入、决定步骤、选择落点、更新文件。

这件事一定要讲透。你给 Claude Code 输入一句话,比如“今天突然想到,我们是不是可以把周报改成短视频形式”,它不会凭空猜该怎么处理,而是先按 CLAUDE.md 里的规则判断:这是什么内容,要不要先搜旧笔记,应该放进哪个文件夹,要新建还是合并,输出要写成什么格式,要不要顺手更新索引。

所以 CLAUDE.md 不是简单地“告诉 AI 你是谁”。它其实是在规定这套笔记系统的工作流。 你写得越清楚,系统越稳;你写得含糊,后面每次处理都会飘。

这个文件至少要包含三块内容。

第一块:这个库是干什么的,你是谁。

这是上下文层,但这里有个很重要的原则:CLAUDE.md 里的用户背景要短,不要把完整的人物信息全堆进去。因为 CLAUDE.md 是总规则,应该尽量稳定、清晰、好维护。

更合理的做法是分两层。

第一层,CLAUDE.md 里只写极简背景,比如你的职业、当前主要工作、写作风格,以及这套库的大致用途和目录结构。

第二层,在笔记库里专门留一个“关于我”文件夹,放详细的人物背景文档,比如 1_关于我/个人背景.md。这里面集中写你的职业经历、长期项目、兴趣、关注主题、常见合作对象、写作偏好、决策习惯,甚至可以放一份简历。Claude Code 需要更深上下文时,再去读这份文档。

这样做有两个好处。第一,CLAUDE.md 不会越写越胖,核心规则始终清楚。第二,用户画像可以持续更新,而且它本身也是笔记库的一部分,能被 AI 正常引用和维护。

## 用途和背景
这是我的个人知识库,用来记录工作想法、会议记录、学习笔记和研究资料。
每次我给你输入内容,帮我整理成笔记,放到合适的文件夹里。

我的简要背景:
- 职业:市场策划
- 当前主要工作:新产品上市、品牌传播
- 写作风格:简洁,喜欢条列式
- 如需更完整的人物背景,先读 `1_关于我/个人背景.md`

目录结构:
- 1_关于我/:个人背景、兴趣、长期项目、写作偏好
- 2_想法/:灵感和随手记的点子
- 3_工作/:项目相关文档
- 4_学习/:读书和课程笔记
- 5_会议/:所有会议记录
- 6_研究/:深度分析和调研
- 7_行政/:汇报和行政文档
- 8_附件/:图片、PDF、邮件导出、录音转写等附件
- 9_代码/:技术相关

第二块:当用户输入一段内容时,AI 要按什么步骤处理。

这是最关键的一块,因为它直接决定 Claude Code 每次收到输入以后会怎么做。不要只写“帮我整理笔记”,要把处理顺序写出来,尤其要写明什么时候需要去读那份详细的人物背景文档。

## 每次我输入一段内容时,按这个顺序处理:
1. 分析输入的主题和关键词
2. 先读本文件中的规则;如果任务需要个性化判断,再读 `1_关于我/个人背景.md`
3. 搜索已有笔记,看有没有可以合并的
4. 判断放进哪个文件夹(不确定就问我)
5. 创建或更新笔记,加标签、建链接
6. 同步更新对应文件夹的 _index.md
7. 告诉我创建了什么、放在哪里、改了什么

你甚至可以继续往下写细一点。比如,会议记录要提炼决策项,读书笔记要保留原句和自己的判断,邮件附件或 PDF 先放 8_附件/ 再读取路径处理。规则越具体,Claude Code 的行为越像你亲手训练过的助手。

如果你愿意再进一步,可以在 CLAUDE.md 里直接补一句规则:凡是涉及我的长期项目、职业判断、写作口吻、合作关系的任务,先读取 1_关于我/个人背景.md 再处理。这样既保留了总规则的简洁,也保留了个性化上下文的深度。

第三块:笔记格式和写作要求。

这是输出层。AI 写东西很容易带点机器腔,笔记格式也容易忽左忽右,所以要一起规定清楚。

## 笔记格式
每条笔记开头要有:
created: 日期
tags:
  - type/idea
  - status/draft

## 写作要求
- 写自然流畅的中文,像人说话一样
- 不用值得注意的是、综上所述这类套话
- 如非必要,不用引号
- 中英文之间加半角空格

所以你可以把整套系统理解成一句话:Markdown 文件负责承载内容,Claude Code 负责干活,而 CLAUDE.md 负责规定它怎么干活;Obsidian 只是一个很顺手的阅读器。

这份 CLAUDE.md 写得越具体,AI 的表现通常越稳。以后你随时都能改,系统也会跟着调整。

但还有一个前提要补上:如果你用的是 AiNote 仓库,CLAUDE.md 不是单独工作的,它和 .claude/skills/takenote/ 是配套的。 前者规定规则,后者负责接住“/takenote”“记一下”“帮我整理成笔记”这类输入,并把它们送进这套规则里处理。

写完后先验一遍 :在终端启动 Claude Code,输入“请读一下 CLAUDE.md,告诉我你理解的规则”。如果它复述的跟你写的一致,配置成功。如果理解偏了,直接在 CLAUDE.md 里改,下次对话自动生效。

CLAUDE.md 驱动流程图

第三步:给每个文件夹建索引文件

笔记多了之后,光靠 CLAUDE.md 里那几行目录说明还不够,AI 还是可能找不准。解决方法是给每个文件夹建一个 _index.md,里面列出这个文件夹下所有笔记的路径和一句话说明。

比如 2_想法/_index.md

# 2_想法 - 索引

| 文件 | 内容 |
| ---- | ---- |
| 社群运营新模式.md | 用每日任务打卡提高成员 AI 能力的社群设计思路 |
| 客户沟通复盘.md | 客户提出价格异议时的应对框架 |
| 年度目标调整.md | 2026 年第二季度重新设定优先级的思考 |

这样一来,CLAUDE.md 负责告诉 AI 应该怎么找,_index.md 负责告诉 AI 这个文件夹里到底有什么。两者配合,定位才会又准又快。

这些索引不用手动写。CLAUDE.md 写好后,直接告诉 Claude Code:

帮我给每个子文件夹创建一个 _index.md,列出文件夹内所有文件的路径和一句话说明

它会自动完成。

索引系统闭环图

第四步:在 CLAUDE.md 加两条规则,完成闭环

## 搜索方式
每次搜索,先读根目录的目录结构,进入相关子文件夹后先读 _index.md,
再读具体笔记。

## 更新规则
每次创建或更新笔记后,同步更新对应文件夹的 _index.md。

加上这两条,系统就闭合了:用户输入内容 → Claude Code 按 CLAUDE.md 处理 → 写入或更新笔记 → 自动更新索引 → 下次搜索更准。

加完后验一遍 :问它“我之前记过什么关于 XX 的笔记”(XX 换成你库里确实有的主题),看它是不是通过索引精准找到了。如果找偏了,检查 _index.md 里对应笔记的一句话说明是不是写得太模糊。

用起来是什么体验

搭好后,在笔记库目录下启动 Claude Code,直接开始用。

记笔记 :你可以直接输入“/takenote 今天和供应商开了个会,他们说原材料涨价 15%,两周内要决定是否锁价,涉及采购、财务和销售三个部门协调。”也可以说“记一下:今天和供应商开了个会……”。Claude Code 会按 takenote 的入口规则接住这段内容,再按 CLAUDE.md 的工作流分析内容、搜索已有的供应商相关笔记,整理成格式规范的笔记放进 5_会议/,再同步更新索引。 你不用自己判断它该放哪。

问答 :问“我上个月记了什么关于供应链风险的内容?”它先读索引,定位相关文件夹,找到具体笔记,给你摘要。

处理附件 :如果你有一份 PDF、邮件导出或者录音转写文件,就先放进 8_附件/,再把路径连同 /takenote 或“记一下”一起发给 Claude Code。它会先读附件,再决定是提炼成会议笔记、研究摘要,还是合并进已有文档。

为什么不用 RAG

懂技术的读者可能知道 RAG(向量检索):把文档切成每 500 字一段,转换成向量,根据相关度匹配最接近的片段。

把它想成一个图书馆,RAG 是用摘录卡片找书——找到的只是某一段话,上下文全丢了。Claude Code 的方式是直接找到相关书架,取出整本书来读。

对于几百到几千篇笔记的个人知识库来说,后者准确率更高,也不需要额外搭建向量数据库。

开始就好,不用等完美

这套系统是慢慢长出来的,先跑起最简版本,用的过程中你会知道哪里需要调整,那时候改 CLAUDE.md 就行。

如果你想更快一点,不用从空文件夹开始,最省事的做法就是直接拿这个仓库做底板,再把里面的 1_关于我/个人背景.mdCLAUDE.md 和目录结构改成自己的:

github.com/Xueheng-Li/AiNote

行动清单

  1. 安装 Claude Code 或 OpenCode(推荐国内用户用 OpenCode 接 DeepSeek,更省钱)
  2. 直接 clone github.com/Xueheng-Li/AiNote,或者自己新建文件夹和子目录
  3. 如果你喜欢图形界面阅读,再安装 Obsidian(obsidian.md,免费)并打开这个文件夹
  4. 务必保留 .claude/skills/takenote/,不要删掉
  5. 修改 1_关于我/个人背景.md 和根目录的 CLAUDE.md
  6. 启动 Claude Code,让它读一下 CLAUDE.md 验证配置
  7. 让 Claude Code 给每个子文件夹创建 _index.md
  8. CLAUDE.md 末尾加上搜索方式和更新规则
  9. /takenote 或“记一下”开始记第一条笔记

搭完之后,记第一条笔记的那一刻,你会理解这套系统和普通笔记的区别。

参考资料

related