Claude Code + Obsidian:搭建本地 AI 知识库(保姆级教程)

用 Obsidian 存资料、用 Claude Code 整理资料、用 Markdown 长期沉淀——把散落在收藏夹、下载文件夹、各个 App 里的资料,变成一个能随时追问的本地 AI 知识库。小白也能照着复制。

📝
本文整理转载自 X 作者 @yunxi0623(云析) 的《Claude Code + Obsidian 搭建本地 AI 知识库,保姆级教程!》,由 API 快连排版,版权归原作者所有。原文链接
Claude Code + Obsidian — build a local AI knowledge base

很多人的资料现在是这样的:公众号文章收藏了一堆、PDF 丢在下载文件夹、网页链接存在浏览器收藏夹、课程笔记写在不同软件里、AI 对话记录散在各个平台,连 Obsidian 里的笔记也越写越乱。

这篇就讲一个小白也能复制的方案:用 Obsidian 存资料,用 Claude Code 整理资料,用 Markdown 搭一个属于自己的 AI 知识库。

一、这套组合到底是什么?

你可以这样理解三者的分工:

Obsidian:负责存资料

它像一个本地知识库外壳。你的笔记、文章、总结、索引,都以 Markdown 文件保存在自己电脑里。好处是:本地可控、文件清晰、方便迁移、适合长期维护,AI 也容易读取。

Claude Code:负责整理资料

它更像一个 AI 整理员。资料放进文件夹后,可以让它帮你:

  • 整理目录
  • 总结内容
  • 生成索引
  • 提炼标签
  • 发现重复
  • 生成学习路线
  • 基于资料回答问题

Markdown:负责长期沉淀

Markdown 就是纯文本格式,不会被某个软件绑死。今天用 Obsidian 看,明天也能用 VS Code、Typora、GitHub 或别的工具打开。

💡
一句话:Obsidian 负责存,Claude Code 负责整理,Markdown 负责长期可迁移。

二、适合哪些人?

这套方法特别适合这几类人:

✅ 自媒体创作者 —— 把选题、爆款拆解、工具资料、文章素材都放进去。以后写文章直接问:「我之前收藏的 AI 工具资料里,哪些适合写成小红书选题?」

✅ 学生 / 研究生 —— 放论文、课程笔记、教材摘要、读书笔记。复习时直接问:「请基于我的知识库,整理一份这门课的复习大纲。」

✅ 独立开发者 —— 放产品想法、技术文档、竞品分析、用户反馈。做产品时问:「根据我之前记录的用户反馈,哪些需求最值得先做?」

✅ 职场人 —— 放会议纪要、项目资料、SOP、报告模板、客户资料。写周报、方案、复盘时,不用从零开始。

✅ Obsidian 老用户 —— 如果你已经有 Obsidian 但笔记越来越乱,这套方法非常适合你。

只要你长期需要整理资料、复用资料、基于资料输出内容,AI 知识库就有价值。

三、第一步:先建一个 Obsidian 知识库

别一上来就把所有资料丢进去。先建一个新库,比如 AI-Knowledge-Base,然后在里面建 6 个文件夹:

目录结构
00_Inbox01_Raw02_Notes03_Wiki04_Output99_Archive

每个文件夹的作用很简单:

  • 00_Inbox(临时收集区) —— 看到资料先丢这里:网页文字、截图识别内容、公众号文章、临时想法、AI 对话记录。只负责收集,不要求整理。
  • 01_Raw(原始资料区) —— 放还没加工的资料:PDF 摘要、文章原文、课程讲义、产品说明、研究资料。
  • 02_Notes(个人笔记区) —— 放你自己的理解:读后感、实操记录、踩坑总结、案例拆解。
  • 03_Wiki(结构化知识区) —— 最重要的地方,放整理后的知识页面,比如「AI Agent 是什么」「Claude Code 使用方法」「Obsidian 知识库流程」。
  • 04_Output(输出区) —— 放基于知识库产出的内容:小红书文章、公众号长文、X 长帖、课程大纲、项目方案。
  • 99_Archive(归档区) —— 放过时、不常用、已处理完的资料。
📌
知识库不是所有东西混在一起,而是先区分:原料、笔记、知识、输出。

四、第二步:写一个 CLAUDE.md,告诉 Claude Code 怎么工作

在知识库根目录新建一个文件 CLAUDE.md,作用是告诉 Claude Code:这个知识库是干什么的、文件夹怎么分工、整理要遵守什么规则、输出要用什么格式、哪些事不能做。你可以直接复制下面这版:

CLAUDE.md
# 我的 AI 知识库工作规则你是我的本地知识库整理助手。这个知识库使用 Obsidian + Markdown 管理。## 文件夹说明- 00_Inbox:临时收集资料,未经整理- 01_Raw:原始资料- 02_Notes:我的个人笔记和理解- 03_Wiki:结构化知识页面- 04_Output:基于知识库生成的文章、方案、脚本- 99_Archive:过时或已归档资料## 工作原则1. 不要随意删除文件2. 修改文件前先说明你准备改哪里3. 原始资料不要直接覆盖4. 整理时优先保留来源和上下文5. 不确定的内容要标注「不确定」6. 不要把推测写成事实7. 输出内容要结构清晰,适合 Obsidian 阅读8. 新知识页尽量使用 Markdown 标题、列表、标签和双链## 常用输出格式每次整理资料时,请输出:- 核心摘要- 关键观点- 可执行动作- 相关概念- 可延伸问题- 适合输出成什么内容
💡
CLAUDE.md 就像知识库的说明书,你写得越清楚,Claude Code 越不容易乱整理。

五、第三步:先丢一部分资料,别一口气导入 1000 条

小白最容易犯的错:刚搭完系统就想把所有资料塞进去,结果知识库还没跑通,先被资料淹没了。第一版只放 10 条,先丢进 00_Inbox,然后让 Claude Code 整理。提示词可以这样写:

提示词
请阅读 00_Inbox 里的资料。先不要移动或删除文件。请帮我:1. 列出每份资料的主题2. 判断它适合归到哪个文件夹3. 提炼每份资料的核心观点4. 建议可以生成哪些 Wiki 页面5. 输出整理计划,等我确认后再执行

等它给出计划、你确认后,再说:

提示词
我确认按这个整理计划执行。请把资料整理成 03_Wiki 里的结构化知识页,同时保留原始资料在 01_Raw。

六、第四步:让 Claude Code 生成 Wiki 页面

Wiki 页面不是普通笔记,它应该是结构化、可复用、方便以后追问的知识页。比如你放了一堆 Claude Code 资料,可以让它生成 03_Wiki/Claude_Code_入门.md

提示词
请基于 01_Raw 和 02_Notes 中关于 Claude Code 的资料,生成一篇结构化 Wiki 页面。文件名:03_Wiki/Claude_Code_入门.md内容包括:1. Claude Code 是什么2. 适合哪些人3. 能做什么4. 不能做什么5. 新手第一步怎么用6. 常见提示词模板7. 注意事项8. 相关链接和延伸主题要求:不要编造事实。如果资料里没有明确依据,请标注「不确定」。

这样以后就不用每次重新读一堆资料,直接问这个 Wiki 页面就行。

七、第五步:建立一个首页索引

知识库越来越大,没有索引还是会乱。建议建一个首页 00_HOME.md,内容可以这样写:

00_HOME.md
# 我的 AI 知识库首页## 核心主题- [[Claude Code]]- [[Obsidian]]- [[AI Agent]]- [[X 增长]]- [[内容创作]]- [[独立开发]]- [[AI 工具]]## 最近整理-## 待处理资料-## 可输出选题-## 常用提示词-

然后让 Claude Code 定期更新首页:

提示词
请扫描 03_Wiki 和 04_Output,帮我更新 00_HOME.md。要求:1. 按主题分类2. 列出最近新增的知识页3. 标出还没整理完的资料4. 提炼 10 个可以输出成文章的选题

八、第六步:用知识库回答问题

以后你可以直接问,比如:

提示词
请基于 03_Wiki 里的内容回答:我想写一篇关于 Claude Code + Obsidian 知识库的文章,最适合从哪个角度切入?

或者让它直接产出大纲:

提示词
请基于我的知识库,整理一篇小红书图文大纲。主题:如何搭建本地 AI 知识库要求:1. 面向小白2. 口语化3. 不夸大4. 有操作步骤5. 有避坑提醒

还可以做主题聚合:

提示词
请帮我找出知识库里关于「AI 内容工作流」的所有资料,总结成一篇 1500 字文章大纲。
💡
知识库真正的价值,是让你的旧资料不断参与新输出。

九、第七步:每周维护一次,别搭完就不管

建议每周做一次维护,提示词:

提示词
请帮我维护这个知识库。任务:1. 扫描 00_Inbox 中未处理资料2. 找出重复或相似主题3. 标出过时内容4. 更新 00_HOME.md5. 提炼本周新增知识点6. 给出下周可以输出的 10 个选题注意:不要删除文件。涉及移动和归档的操作,先给建议,等我确认。
📌
这个动作很重要——不维护的知识库,迟早又会变回收藏夹。

十、关于「离线」和「隐私」,一定要说清楚

Obsidian 的文件可以本地保存,但 Claude Code 通常需要连接模型服务,并不等于默认纯离线的本地模型。所以如果你处理的是这类内容:

  • 公司内部文档
  • 客户隐私
  • 合同
  • 财务数据
  • 未公开项目
  • 个人敏感信息

——不要随便交给任何云端 AI 工具处理。更稳的做法是:

  • 先脱敏
  • 只放可公开资料
  • 重要内容本地备份
  • 敏感文件不进入 AI 流程
  • 需要离线时使用真正的本地模型方案

十一、小白最小可行版本

如果上面看着多,先按这 7 步跑通最小版本:

  1. 安装 Obsidian,建一个库 AI-Knowledge-Base
  2. 建 4 个文件夹:00_Inbox01_Raw03_Wiki04_Output
  3. 新建 CLAUDE.md,写清整理规则。
  4. 00_Inbox 放 10 条资料。
  5. 让 Claude Code 先出整理计划,不要直接改。
  6. 确认后生成 Wiki 页面。
  7. 用 Wiki 页面生成一篇文章或学习大纲。

跑通这 7 步,你就已经不是简单收藏资料,而是在搭自己的 AI 知识系统了。

总结

Claude Code + Obsidian 搭知识库,本质不是「多装一个工具」,而是一套流程:

  • Obsidian 存资料
  • Markdown 保持可迁移
  • CLAUDE.md 约束整理规则
  • Claude Code 整理和生成结构
  • Wiki 页面沉淀知识
  • 首页索引管理全局
  • 每周维护持续迭代
💡
真正的核心是:收藏夹是仓库,知识库是系统。
本文里的 Claude Code 用 API 快连 的统一 Key 即可驱动,默认模型 claude-opus-4-8,整理、生成、追问都走同一个 Key。打开控制台创建 Key →