构建个人思考OS：基于Obsidian与Claude Code的智能笔记系统实践

昨天在Twitter上读到一篇阅读量破百万的好文，探讨在“Vibe Coding”时代如何进行“Vibe Note-Taking”：

原文：Heinrich - obsidian + claude code 101
作者：Heinrich (@arscontexta)
日期：February 13, 2026

---

过去一年，作者Heinrich构建了一套“思考OS”——用AI来驱动他的Obsidian知识库（后文简称为vault）。

Claude Code直接接管了这个vault。

它会自动提取关键概念，将你已经理清的想法串联起来，构建出一个能实时反映你思维活动的知识网络。现在，作者基本只在这个vault里工作了。这些Markdown文件知晓他发现的一切，结构清晰，并能自动注入上下文信息来进行基于上下文的学习（in-context learning）。

作者使用了一个vault索引来帮助AI Agent决定拉取哪些笔记，这与Claude Code决定加载哪些Skill的逻辑如出一辙。仔细想想，每篇笔记本质上就是一个Skill——一份高度精选的知识，在恰当的时刻被注入到上下文中。

更深层的是：vault编码的是你的思维方式，而不仅仅是你思考过的内容。方法论本身成为了系统的一部分——所有东西都是Markdown文件，完全归你所有。AI是你的思考伙伴，而不仅仅是写作助手。

作者意识到：知识库和代码库其实有很多共同点。
它们都是文本文件的集合，文件之间存在各种关联；都遵循特定的约定和模式；都能受益于能在其中导航和操作的Agent。

Vibe Coding 改变了我们编写软件的方式——让AI处理实现细节，你专注于方向。同样的转变也适用于知识工作（即 Vibe Note-Taking）。

你不再仅仅是做笔记了，你是在运营一个帮你做笔记的思考系统。

什么是 Vault？

Vault就是一个文件夹，里面装满了相互链接的Markdown文件：

my-vault/
├── 00_inbox/           # 收集区，零摩擦
├── 01_thinking/        # 你的笔记和整合
│   └── notes/          # 独立思考笔记
├── 02_reference/       # 外部知识
│   ├── tools/          # 工具文档
│   ├── approaches/     # 方法和模式
│   └── sources/       # 外部知识源
├── 03_creating/        # 进行中的内容
│   └── drafts/
├── 04_published/       # 已完成作品归档
├── 05_archive/         # 非活跃内容
├── 06_system/          # 模板和脚本
├── CLAUDE.md           # 教 AI 你的系统
└── attachments/        # 图片和文件

文件之间使用 [[wiki links]] 连接（Obsidian默认的双向链接方式），从而编织出想法的网络。当你在笔记中写入 [[质量才是难点]] 时，它会创建一个可点击的链接，指向另一篇同名的笔记。Agent可以顺着这些链接，发现你或许已经遗忘的联系。

如何撰写这些链接至关重要。
许多人习惯将引用放在文末，像脚注一样。相反，应该把链接自然地编织进你的句子里。
不要写“这跟质量有关，参见：quality-note”。应该写“因为 质量才是难点，所以我们得专注于筛选”。
这样，链接就成为了你思考过程的一部分，Agent可以通过跟随链接来追踪你的推理脉络。

还需要撰写能够独立存在、可组合的笔记。
如果有人通过链接跳转到某篇笔记，不应该需要先阅读另外五篇才能理解。把笔记想象成乐高积木。 每一块都是完整的个体，但连接起来就能构建出更庞大的结构。当你的笔记以这种方式运作时，网络本身就产生了价值。

教 AI 你的思维方式

问题是，AI不会自动理解你的思维模式。你必须教它。

作者痛苦地认识到，看着AI完全无视自己的思维模式时，你才会意识到自己脑子里藏着多少隐性知识。突然间，你得把所有东西都文本化。他的 CLAUDE.md 文件现在已经超过2000行，因为他一直在打磨哪些方法有效、哪些无效。

大多数指南错在哪里？ 它们给你一个系统然后说“照做”，但每个vault服务于不同的目的，需要不同的原则。就像代码库一样——你不会用同样的文件夹结构来构建CLI工具和Web应用。

作者运营着多个vault。一个用于思考AI和知识管理（就是本文分享的例子）。另一个用于工作，追踪项目和客户，规则完全不同。模式根据目的而变化。

不变的底层模式是：

1. 带链接的Markdown文件，任何AI都能读取。
2. CLAUDE.md文件，用于教导Agent你特定的系统规则。
3. 能让Agent快速定位内容的结构化目录。
4. 写成明确指令的约定，确保AI行为一致。

这些指令具体写什么，完全取决于你的目的。

• 工作vault可能强调：先收集后整理、按项目和会议组织的文件夹、为AI准备的客户上下文。
• 研究vault可能强调：来源追踪与引用、文献笔记、主张验证。
• 创意vault可能强调：想法收集与孵化、草稿进展追踪、参考资料整理。

本文分享的这个vault专注于培养深度理解和思考。其模式根植于 CLAUDE.md 文件。作者能明显感觉到维护良好的vault与充满噪音的vault之间的巨大差异。深度远比广度更重要。

这是 CLAUDE.md 中的一段，强调了这一理念：

depth over breadth. quality over speed. tokens are free.

this is not about efficiency. this is about excellence. when you pick a task, you are committing to understanding it completely and leaving behind work that future agents can build on.

深度大于广度。质量大于速度。token 是免费的。

这不是关于效率。这是关于卓越的。当你选择一项任务时，你承诺要完全理解它，并留下未来 Agent 可以在此基础上构建的成果。

分层定位系统

当Claude开始一个会话时，它需要理解vault里有什么，但又不可能阅读每一个文件。当成千上万条笔记时，这是不现实的。因此，这个系统采用了分层设计，让Agent能够快速定位：

"hooks": {
    "SessionStart": [{
        "hooks": [{
            "type": "command",
            "command": "tree -L 3 -a -I '.git|.obsidian' --noreport"
        }]
    }]
}

1. Claude先看到文件夹结构。 一个Hook会在会话开始时自动显示存在哪些文件夹和文件。
2. 索引文件，列出每条笔记的一句话描述。Claude可以在几秒钟内扫描50条笔记，而无需打开它们。
3. 主题页面（MOCs），链接到相关笔记。这些充当每个主题的目录。

这些页面还包含了Claude给自己写的笔记，记录它在遍历知识图谱时的所学，为未来的会话留下“面包屑”。AI从广阔的结构开始，逐步收窄到相关主题，然后跟随链接来构建深层的理解。

Vault 的规则

以下规则适用于作者的思考vault。其他类型的vault可能需要不同的规则：

1. 可组合性
这篇笔记能从其他地方链接过来并且仍然讲得通吗？如果链接到它迫使你必须先解释另外三件事，那就拆分它。这就是可组合性。

2. 用主张来命名笔记
作者不再用主题来命名笔记，而是用核心主张。不是“关于AI垃圾内容的思考”，而是“质量才是难点”。当你链接到它时，标题会自然地成为你句子的一部分（这也迫使Claude在构建句子时进行不同方式的思考，作者相信这是有益的，因为它需要真正理解）。

3. 网络就是知识
洞察到单个笔记的价值不如它们之间的关系重要。一条拥有许多入链（被链接）的笔记，比一条孤立的笔记更有价值，因为每个链接都创造了一条新的阅读和理解路径。

自动化工作流

每个任务都从定位开始。Claude扫描结构，检查索引以寻找相关笔记，并在进行任何修改前阅读主题页面。它跟随链接来构建上下文，没有充分理解前不会做改动。

当Claude发现关于如何导航某个主题的有用信息时，它会记录在对应的主题页面里。未来的会话会读取这些笔记，从过去的探索中学习。这就是vault如何“记住”如何去思考。

有时，两条笔记会以有趣的方式互动。Claude会创建一条新笔记，捕捉它们结合时产生的洞察。每个新收集的条目都会触发对相关笔记的搜索，Claude会添加上下文的链接。

vault/
├── 00_inbox/           # 收集区
├── 01_thinking/        # 你的笔记和主题页面
│   ├── knowledge-work.md    # 示例主题页面
│   └── notes/               # 独立笔记
├── 02_reference/       # 来自他人的东西
├── 03_creating/        # 进行中的草稿
├── 04_published/       # 已完成作品
├── 05_archive/         # 旧东西
└── 06_system/          # 模板和配置

这个结构适用于个人思考vault。重点不在于具体的文件夹名称，而在于文件夹的位置能够告诉你某物是什么。

Markdown 就是系统

Markdown就是系统本身。像Obsidian这样的工具只是观察它的窗口。vault可以承受任何特定应用程序的消失。 一切都是纯文本，任何编辑器都能读取，任何AI都能处理。你的数据完全归你所有。

开始使用：

1. 创建一个带有子文件夹的文件夹，结构匹配你的目的。思考你实际需要组织什么。
2. 编写一个 CLAUDE.md 文件来解释你的系统。从简单的规则开始，随着你摸索出有效的方法而不断进化。
3. 让Claude来运营。收集一些内容，让Claude寻找联系。让它导航和发现关系，并建议内容应该放在哪里。

务必审阅它产出的内容，通过编辑来保证质量。
你不再仅仅是做笔记，而是在指导一个帮你做笔记的系统。你的工作变成了判断——决定什么才是重要的。人类的角色从作者演变为编辑，从创作者演变为策展人。

总结

• Vibe coding 改变了我们写软件的方式。Vibe note-taking 改变了我们思考的方式。
• Vault就是相互链接的Markdown文件集合。
• LLM没有长期记忆，因此vault为它们提供了一个外部记忆体。
• CLAUDE.md 教导AI你的系统如何运作。
• 每个vault根据其目的需要自己的设计哲学。
• 不变的核心是：Markdown、链接、由AI运营并由人类提供判断。

实践部署

1. 安装Obsidian专用Claude Code插件Claudian

Claudian可能是Obsidian上最好的Claude Code插件，比通过Obsidian的Terminal插件运行Claude Code更稳定，并且针对Obsidian做了大量易用性优化。如果你想深入探索人工智能如何与本地知识库结合，这是一个绝佳的起点。

1. 在Obsidian设置项 -> “第三方插件” -> 点击“浏览”。
   

2. 搜索“BRAT”。
   

3. 点击“安装”，并“启用”。

4. 安装后，进入Obsidian的“第三方插件”列表，点击“BRAT” -> 点击“Add beta plugin”。
   

5. 在弹出的窗口中输入 https://github.com/YishenTu/claudian，然后点击“Add plugin”。
   

6. 等待安装完成，然后在社区插件列表中启用“Claudian”。

7. 点击进入Claudian插件的设置页面。
   

8. 在“环境” -> “自定义变量”区域，输入大模型提供商对应的配置（以MiniMax M2.5为例）：

   ANTHROPIC_API_KEY=你的API_KEY
   ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
   ANTHROPIC_MODEL=MiniMax-M2.5

   请将 你的API_KEY 替换为从相应平台获取的实际密钥。

9. 各大模型厂商都提供了兼容Claude Code的base_url和model name，以下是三个主流国产模型的配置参考：

   智谱
   文档：https://docs.bigmodel.cn/cn/coding-plan/tool/claude
   ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic

   KIMI
   文档：https://www.kimi.com/code/docs/more/third-party-agents.html
   ANTHROPIC_BASE_URL=https://api.kimi.com/coding/

   MiniMax
   文档：https://platform.minimaxi.com/docs/coding-plan/claude-code
   ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic

10. 滚动到Claudian配置项底部，填写Claude CLI的安装路径。
    

11. 如果你不知道Claude CLI的路径，在终端输入 which claude，将输出的完整路径粘贴到配置项中。
    

12. 配置完成后，回到Obsidian主界面，点击左侧边栏的小机器人头像图标。Claudian聊天面板应该会在右侧边栏打开，并正确显示你当前使用的模型名称（例如：MiniMax M2.5）。
    

2. 创建【思考OS】目录结构

现在，让我们用Claudian来初始化我们的思考系统。

1. 在Claudian的聊天输入框中，输入以下指令：

   https://x.com/arscontexta/status/2013045749580259680?s=46 请阅读这篇Twitter Article，然后用里面的方法搭建我的这个Obsidian Vault
   

2. Claudian会快速理解文章内容，并自动为你创建好完整的Vault目录结构。
   

从现在开始，你就可以使用Obsidian + Claude Code（通过Claudian）来推进你自己的【思考OS】了！文章中提到的Hook或者其他高级技巧，都可以通过与Claudian互动来实现。
记住：
一切都是文本，一切都是链接，一切都可以和Claude Code互动！
这就是Vibe Coding时代的Vibe Note-Taking！

扩展与美化

1. 为了让使用体验更愉悦（这很重要），你还可以为你的Obsidian vault搭建一个静态网站。
2. 下图是使用Fumadocs搭建的一个静态站点示例：
   
3. 本文（同样是在Obsidian中撰写的）渲染出来的效果大概是这样：
   

通过这样的方式，你的思考过程不仅被高效地管理和连接，还能以美观的形式呈现甚至分享。这正是将个人知识管理从私密笔记升级为可交互、可扩展的思维操作系统。在实践中不断调整你的 CLAUDE.md 和目录结构，让它真正贴合你的思维习惯，你会在云栈社区发现，还有很多开发者也在用类似的方法构建他们的数字大脑。

---