我将 Claude Code 与 Obsidian CLI 配对，终于整理好了五年的笔记
在多年的美好愿望和一 vault 充满混乱之后，某个下午，Claude Code 做到了没有任何插件能做到的事情。
如果你使用 Obsidian 记笔记已经超过一年，你可能有一个秘密。你的资料库一团糟。我的不仅仅是凌乱，它更像是一个“无标题”笔记和孤立标签的墓地，感觉不像是第二大脑，更像是认知负担。
不是一个可爱、古怪的灾难。是真正的灾难。有五年的笔记散落在超过800个文件中，附加文件孤立无依，命名不一致，我后来才注意到的标签毫无意义，还有互相矛盾的文件夹。而我的图谱看起来更像是恐慌发作绘成的点和线，而不是知识网络。
我尝试过各种方法。模板。甚至一些最好的插件。我两年前开始的一次完整重组，但几个小时后就放弃了。我几乎不理解的 Dataview 设置。没有一种方法奏效，因为问题不在于结构，而是在于达到目标所需的庞大修复工作量。
然后在今年年初，我尝试了一些不同的方法：我将问题交给了Claude Code，就像其他人一样，并配合一些Obsidian CLI命令，目睹它在大约90分钟内完成了我五年都未能做到的事情。
什么是Claude Code，为什么它对记笔记很重要？
一个在你的终端中工作的 AI，而不是聊天框
如果你还没有接触过，Claude Code 是 Anthropic 的命令行 AI 工具。与 Claude 更传统的界面不同，Claude Code 直接在你的终端中运行，可以读取本地系统的文件，编写和编辑代码，并自主执行多步骤任务，而无需你管理每一个提示。
最后那部分就是使 Claude Code 与众不同的地方。大多数 AI 工具都要求你保持参与，不断地来回提供信息。Claude Code 可以被赋予一个目标，获得对某个目录的访问权限，并且可以信任它系统地解决问题。它看到你的文件系统的方式就像开发者一样，而不是像聊天机器人那样。
对于像重新整理笔记库这样的任务，这种区别非常重要。
如何将 Claude Code 连接到你的 Obsidian 保管库
为什么 notesmd-cli 是完成这项工作的合适工具
为了实现这一功能，我使用了 notesmd-cli。虽然 Obsidian 在 2026 年初发布了官方 CLI，但我目前无法使用。notesmd-cli 是事实上的社区标准；它是免费的，可以通过一个 Homebrew 命令安装，并且处理繁重工作：批量重命名那 63 个“未命名”笔记、编辑 frontmatter 以标准化我凌乱的标签，以及在不需要保持 Obsidian 应用打开的情况下移动文件。
这两种工具的结合创造了真正有用的东西：一个能够阅读你所有笔记的人工智能，理解内容，然后采取行动，重命名、标记、移动、链接，而你无需对每个决定进行监督。
如何构建你的 Claude Code 提示以进行金库清理
让你掌控全局的三阶段方法
我给了Claude Code一个相当具体的任务，分为几个阶段：
- 第一阶段：审计保险库。列出里面的内容，文件名、现有标签、文件夹位置、大致内容类别等，然后在动任何东西之前汇报一份总结。
- 第二阶段：根据实际发现的内容，而不是我以为存在的内容，提出文件夹结构和标签分类。
- 第三阶段：逐个文件执行重组，并记录每一次更改，以便我之后可以审查（并在需要时撤销）。我是作家，不是赌徒。我绝不会让一个大型语言模型在没有约束的情况下删除五年的研究。我首先强制Claude遵循严格的“看但不碰”协议。
Claude Code 在分析了 847 条笔记时发现的内容
改变了我看待自己保管库方式的类别划分
Claude Code 在第一阶段返回的总结确实令人谦卑。在我的 847 条笔记中，大约 340 条没有标签，另外 200 条使用了我不一致应用的标签。我还有 14 个不同的文件夹，其用途重叠。另外有 63 个文件的名称是“未命名笔记”的某种变体。最后，有 11 个是空的。
我知道情况很糟，但我不知道糟糕到这种地步。
我发现最有用的是审计产生的类别细分。它根据我笔记的实际内容，在我的资料库中识别出了七个清晰的内容集群：专业写作、个人日记、旅行研究、技术参考、书籍和媒体笔记、健康追踪，以及一个杂项集合。我原本在脑海中把资料库组织成这些集合大致相等的样子。但事实并非如此。专业写作和技术参考约占全部内容的60%。
Claude Code 是如何从零构建文件夹结构的
为什么以证据为基础的组织比以意图为基础的组织更有效
Claude Code 提出的分类法比我自己设计的任何东西都更清晰，正是因为它是基于证据而非意图。
它建议使用相对扁平的文件夹结构，包含七个与内容集群对应的顶级文件夹，并使用统一的标签方案，标签为小写并用连字符连接。它标记了 11 个空文件，等待我确认后删除。它还建议将 63 个未命名的笔记移动到一个单独的审阅文件夹，而不是猜测它们的类别，这是正确的决定。
我对提案做了两个修改：我将旅行文件夹分为“旅行计划”和“旅行回忆”，因为2022年的航班确认号列表是杂乱的，但对加勒比某地日落的感官描述是一种资源。
然后我批准了它。
当Claude Code重新整理你的保险库时实际上会发生什么
让我有信心运行它的变更日志
我不会假装自己全程都在看它运行。我去做了咖啡，回复了一些邮件，做了一些社交网络活动，然后才回去。当我回来的时候，我发现了一个更改日志，这是一个纯文本文件，由Claude Code在我的保险库根目录中创建，记录了所有采取的操作。
宝库随后首次在黑曜石中打开时，立刻看起来不同了。我曾认为无用而放弃的图表视图，现在显示出了群集；真实的、可读的群集。我批准的七个内容类别在可视化中作为松散的社区可见。
我花了大约30分钟查看变更日志，抽查移动情况，并确认了11个空文件的删除。我发现有三个文件我想以不同的方式移动；就这些。
使用 Claude Code 进行 Obsidian 组织的真正局限
有三件事你仍然必须自己做
诚实地承认我所经历的局限是有价值的。
例如，Claude Code 无法解决真正模棱两可的笔记。一个没有内容的简短文章片段，一份没有解释的名字列表。这些默认会被放入杂项文件夹，这是正确的行为。此外，我仍然需要处理 40 条真正不清楚的笔记。
它也无法提高我写的东西的质量。组织不良的思维即使出现在一个整理好的文件中，依然是组织不良的思维。组织是有用资料库的前提条件，而不是更好笔记的替代品。
而且 Obsidian CLI 的设置确实需要对终端有一定的熟悉度。这并不是即插即用的过程，如果你不习惯在命令行中工作，设置起来会有很大的摩擦感。这还不是主流的消费者工作流程，尽管我相信它可能在短短几个月内就会成为主流。
为什么Claude Code能成功而Obsidian插件失败
我以前尝试的每一个基于插件的解决方案都将组织负担重新放回到我身上。我仍然不得不做成百上千的微小决定，而且所需的努力每次都超出了我的耐心。
Claude Code 改变了动态，因为它是在大规模做决策，而不仅仅是提供让你自己去做的工具。审核-提出-执行结构让你可以进行监督，而不必陷入每一个具体选择的细节。
还有一点就是它把你的笔记当作文本来读取：不是元数据，不是文件名，而是实际内容。这正是一个有心的人类助理处理任务的方式，并且它产生的结果反映了你的笔记实际内容，而不是你三年前深夜给它们起的名字。
Claude Code 适合你的 Obsidian 金库吗？
如果你是一个长期使用 Obsidian 的用户，并且你的资料库已经大到超出你手动维护的能力，是的——但有一些注意事项。
你应该对终端感到熟悉，或者愿意学习足够的知识以达到这一点。你应该采取分阶段的方法，不要在执行前跳过审计评审步骤。你还应该在开始之前备份你的保险库，这本应是不言而喻的，但绝对有必要说明。
对我来说，这是一个重组项目真正完成的第一次。多年来第一次，我真的可以找到某一章的研究资料，而不会被“恐慌发作”图表视图嘲笑。我不仅仅是清理了一个文件夹；我重新找回了我的思绪空间。