不用任何插件,Claude Code 直接读懂你的 Obsidian 笔记

不上传、不导入、不装插件。但”本地读取”不等于”本地处理”——这一点必须说清楚。

我第一次发现 Claude Code 能直接读取 Obsidian 本地文件时，有点不敢相信。

当时我在测试各种 AI 工具和 Obsidian 的连接方式。试过 Obsidian 的官方同步，试过第三方插件，试过把笔记导出再上传给 AI。每种方式都有各种限制和麻烦。

然后我抱着试试看的心态，在 Claude Code 里直接输入了 Obsidian vault 的本地目录路径。

它就读懂了。

不需要任何插件，不需要任何 API，不需要任何中间层。Claude Code 直接读取我电脑上的 .md 文件，理解里面的文字、链接、结构。

那一刻的感觉是：原来这么简单？

具体怎么操作

原理说起来简单，但具体怎么告诉 Claude Code 你的 vault 在哪？

打开终端，进入 Claude Code，直接输入一句话就行：

「读取 D:\new\Journal\ 这个目录下的所有 .md 文件」

Claude Code 会自己遍历目录，读取文件，理解结构。你不需要逐个打开文件，不需要导出，不需要格式转换。它能读懂 Obsidian 的反链语法、标签体系、文件夹层级。

我第一次试的时候，直接让它读了整个 Journal 目录。2861 篇笔记，它花了几分钟就全部读完了。读完之后，它能说出我的三层结构是什么——每日小计、当年重点、操作系统。它知道哪些笔记之间有反链关联，知道我的标签体系是怎么组织的。

不需要你手动整理成「AI 能读懂的格式」。.md 文件本来就是纯文本，Claude Code 天然能读懂。

从 Cursor 到 Claude Code 的迁移

去年我用 Cursor，它确实好用。AI 辅助写代码，输入需求就能生成代码片段，比我从零开始学编程快多了。

但用了一段时间，我发现一个问题。Cursor 的核心场景是「在编辑器里写代码」，它需要你在它的编辑器里打开文件才能操作。我的 Obsidian 笔记有 2861 篇，全存在本地硬盘上，我不可能把它们全搬到 Cursor 的编辑器里。

而且 Cursor 对非技术人员不太友好。它的界面、快捷键、工作流都是为程序员设计的。我的主业是广告公司，内容创作是副业，我不需要一个代码编辑器，我需要一个能理解我知识库的 AI。

后来接触到 Claude Code，发现它能直接读取本地目录。我所有笔记、所有思考、所有记录，它都能看到。

这一下就通了。不是 Cursor 不好，是我的需求变了。从「用 AI 写代码」变成了「让 AI 理解我的知识库」。

数据主权——必须诚实说

这一点我必须单独说，而且要说清楚。

很多人对 AI 工具有一个担心：我的数据会不会被上传？会不会被用来训练模型？会不会泄露？

用 Claude Code 读取本地文件，读取动作本身不需要上传——它直接访问你硬盘上的文件。但读完之后，文件内容会通过 API 发送到 Anthropic 的服务器进行处理。这是 Claude Code 的工作原理，必须说清楚。

所以「数据主权」不是「数据完全不出本机」，而是「你选择什么时候分享、分享哪些内容」。

你可以指定只读某个文件夹，不读另一个。你可以指定只读某几篇笔记，不读全部。控制权在你手里，但数据处理确实在云端完成。

如果你对隐私极度敏感，这一点需要考虑。但对我而言，这个权衡是值得的——因为我需要的是 AI 理解我的知识库，而不是一个只在本地跑的简单工具。

你的笔记是你的资产。你选择什么时候分享给 AI，分享哪些内容，都是你说了算。AI 只是一个读者，不是主人。但读者是在云端读的，这一点要心里有数。

工具迁移的自由

还有一个好处，很多人没意识到。

如果你用的是 Obsidian Sync 或者某个第三方插件来连接 AI，有一天你不想用这个工具了，你的笔记数据怎么办？

如果数据是存储在第三方服务器上的，你可能需要导出、迁移、重新配置。过程麻烦不说，还可能有数据丢失的风险。

但如果你的笔记就是本地的 .md 文件，那你根本不用担心这个问题。

今天你用 Claude Code 读这些文件，明天你换了一个新的 AI 工具，同样的 .md 文件它也能读。后天又出了一个更厉害的 AI，你还是用同样的文件。

工具会过时，.md 文件不会。

这是本地文件最大的优势。你的数据不绑定任何一个工具，不绑定任何一个平台。你拥有完全的控制权。

一个意外的发现

有一次，我让 Claude Code 读我三年前的一篇笔记。那篇笔记记录了我当时对一个行业的判断。

读完之后，Claude Code 说：「你三年前的这个判断，和你最近一篇笔记里的观点是一致的，但角度不同。三年前你从市场角度分析，最近你从技术角度分析。」

这个关联是我自己都没发现的。三年前的笔记我早就忘了写了什么，但 Claude Code 读完之后，自动帮我建立了这个连接。

那一刻我意识到，这些 .md 文件不只是存储，它们是活的。当 AI 读取它们时，它们之间会自然产生关联和洞察。

你写下的每一句话，都可能在未来某个时刻，成为 AI 帮你做决策的关键线索。

从「存笔记」到「用笔记」

以前我对笔记的理解是「存」。把想法记下来，存好，以后可能有用。

现在我对笔记的理解是「用」。不只是自己用，也是给 AI 用。你存下的每一篇笔记，都是在为未来的 AI 对话积累原料。

Claude Code 直接读取本地文件这件事，让我彻底想通了：笔记系统的价值，不在于它能帮你回忆过去，而在于它能帮 AI 理解你。

而这一切的前提，是你的笔记得是本地的 .md 文件，得有清晰的结构，得有真实的内容。

你现在用什么方式让 AI 读你的笔记？有没有遇到什么障碍？评论区说说，我帮你看看有没有更简单的方案。

工具链：Obsidian 本地 .md + Claude Code 直接读取目录

下篇预告：《一个知识库，同时喂给抖音、公众号、视频号》

Obsidian+claudecode 让2861篇笔记变成了AI能读懂的知识库

Claude Code安装教程（四）：CLAUDE.md是什么，为什么必须写