Claude Code / Gemini CLI 集成

上一篇是”你把笔记复制给 AI”，这一篇是”AI 自己走进来读写”。差别看似一步，实则是一整层能力的跃迁——当 AI 代理能直接访问你的 vault 文件夹，它就从”被咨询的助手”变成了”能动手的同事”。

上一节我们聊过 Obsidian CLI 把笔记变成了可被命令调用的原子。终端里的 AI 代理，正是这些原子最理想的调度者。

Claude Code：把 vault 当成一个项目

Claude Code 是 Anthropic 官方的命令行 AI 代理。它不是聊天框，而是一个能真正动手的工具——内置 Read、Write、Edit、Bash、Grep、Glob 等工具，可以在终端里读写文件、跑命令、改代码。

对 Obsidian 来说，这意味着一件朴素却关键的事：你的 vault 就是一个普通的文件夹，里面全是 .md 文本。Claude Code 不需要任何专门适配，就能像操作代码仓库一样操作它。

进到 vault 目录，启动 Claude Code，你就可以用自然语言下达指令：

“扫一遍这个库，找出所有提到’睡眠周期’的笔记。”
“把这三篇会议记录合并成一篇纪要，保留每个人的待办。”
“给’健康’主题下的笔记各补一个 aliases 属性。”

它会自己去 Read 文件、Grep 关键词、Write 结果，全程你只说话、不敲命令。

CLAUDE.md：给 AI 一份 vault 说明书

Claude Code 有个贴心的机制——CLAUDE.md。把它放在 vault 根目录，它就成了 AI 的”项目记忆”：每次启动都会自动读取，理解你的库怎么组织、用什么规范。

一份好的 CLAUDE.md 可以写清：

笔记命名规则（如”原子笔记用名词短语，日记用 YYYY-MM-DD”）；
属性字段约定（必填 tags、created、status）；
双链与 MOC 的使用习惯；
哪些文件夹是”只读归档”、哪些可以改。

有了这份说明书，AI 的每次出手都会更贴合你的风格，而不是按它自己的默认套路乱来。

Gemini CLI：开源的终端伙伴

Gemini CLI 是 Google 在 2025 年开源（Apache 2.0 协议）的命令行 AI 代理。和 Claude Code 思路相近，它同样能在终端里读文件、跑命令、做任务，用自然语言驱动。它用 GEMINI.md 作为项目上下文文件，机制与 CLAUDE.md 异曲同工。

两者放在一起，对 Obsidian 用户的意义是：你不被绑在任何一个模型上。今天 Claude 擅长的活交给 Claude Code，明天需要长上下文啃一整本笔记的活交给 Gemini——vault 还是那个文件夹，换的只是终端里敲的那个命令。

[!tip] 选哪个 Claude Code 的代理式工具调用（agentic tool use）在多步骤、需反复读写文件的任务上更成熟；Gemini CLI 胜在开源与免费配额。不必二选一，按任务挑趁手的。

自动化知识图谱构建

当 AI 能直接读 vault，一件原本费时费力的活就自动化了——补全知识图谱。

你可以让 AI 读完一批笔记后做三件事：

找断链：哪些笔记明明在讲相关话题，却没有 [[双链]] 连起来？
提候选：为每篇笔记列出”建议链接到哪几篇”，附理由。
建 MOC：把一个主题下的笔记拢成一张内容地图，分组、排序、加注释，生成规范的索引页。

AI 给的是草稿，你只需审一遍——同意的留下，牵强的删掉。原本要花一整个下午的整理，压缩成十几分钟的复核。

Skills 机制：教会 AI 熟练操作 Obsidian

Claude Code 还有个更精巧的设计——Skills。一个 Skill 本质上就是一个 Markdown 文件，里面写着”遇到这类任务，该怎么做”。把它放进项目，AI 就”学会”了这项手艺。

你可以为 Obsidian 写几个 Skill，例如：

obsidian-new-note.md——新建笔记的标准流程：填哪些属性、用什么命名、链向哪个 MOC；
obsidian-moc.md——生成 MOC 的模板与分组逻辑；
obsidian-daily-review.md——每日复盘的固定动作。

写好之后，你说”按 daily-review skill 整理今天的日记”，Claude Code 就会照着 Skill 里的步骤一步步执行，产出格式规范的笔记。这等于把你的工作流固化成了 AI 能复用的程序。

一个真实示例

想象这样一个傍晚：你刚写完一篇关于”番茄钟与注意力残留”的笔记。在终端里对 Claude Code 说——

“用 obsidian-new-note skill 检查这篇笔记的属性是否齐全，然后扫库找出三篇最该双链的笔记，最后更新 [[专注力 MOC]]。”

它自己 Read 笔记、补属性、Grep 全库、挑候选、Edit MOC。几分钟后，一篇链接丰满、属性齐全、归位妥当的笔记就躺在库里了。你做的，只是说了那一句话。

下一篇，我们把这些能力串成四条可以日常复用的工作流。