15.5k Star：把 Claude Code 嵌进 Obsidian，这个插件让笔记库变成 AI 工作区

如果你用 Obsidian 写笔记，又用 AI 帮你改，大概率经历过这种流程：在笔记里选中一段文字，复制，切到 AI 对话框，粘贴，说明要怎么改，等 AI 输出，再复制结果，切回 Obsidian，粘贴回去，然后逐字对比改动。一套下来，改一段文字要切五六次窗口。

也有些 AI 插件做侧边聊天，省去了切窗口，但它们改不了你的笔记文件——AI 在聊天框里给你一段新文字，你还是得手动贴回去。

Claudian 走了另一条路。它把 Claude Code、Codex、Grok 这类终端级 AI Agent 直接嵌进 Obsidian，让 Agent 拿到你笔记库的读写权。15.5k Star，1k Fork，MIT 开源。

差别在哪：不是在侧边栏聊天，是 Agent 能直接读写你的笔记文件、搜索库内内容、跑命令、做多步推理。

这是什么

Claudian 是一个 Obsidian 插件，作用是把 AI 编程代理嵌入你的知识库。支持 Claude Code CLI、Codex CLI、Grok Build、OpenCode、Pi 等多个终端级 Agent，通过统一的适配器层接入，理论上后续有新 Agent 也能扩展。

装好之后，你的笔记库就是 Agent 的工作目录。文件读写、全文搜索、bash 命令、多步骤工作流，Agent 都能直接用。它不是给 Obsidian 加个聊天窗，是让 Agent 把笔记库当成自己的工作空间。

技术栈是 TypeScript，用 esbuild 构建，Jest 测试。Obsidian v1.13.0 及以上版本，桌面端三大平台（macOS、Linux、Windows）都能用。

内联编辑：选中就改，词级 Diff

这是日常用得最多的功能。

在笔记里选中一段文字，或者把光标放在某个位置，按快捷键呼出浮层，输入修改要求。AI 直接在原地修改，并且输出词级 Diff 对比预览——新增的词、删除的词、改动的词，逐个高亮标出来。你扫一眼就能看清 AI 改了什么，确认无误后一键替换。

不用逐字逐句对比原文和新文，不用切窗口复制粘贴。改一段笔记的摩擦成本，从五六步降到两步：呼出、确认。

@引用：让 Agent 通读你的多篇笔记

侧边聊天插件有个硬伤：AI 只看到你粘贴进去的那段文字，不知道你库里还有什么。想让它整理多篇笔记，你得一篇篇手动喂上下文。

Claudian 用 @ 引用解决这个。输入 @，能引用知识库里的文件、文件夹或标签。Agent 调起底层工具，自己通读你引用的这些笔记，做交叉索引、批量格式整理、长文脉络梳理。

比如你写了十几篇关于某个主题的零散笔记，用 @ 把它们都引出来，告诉 Agent 帮你整理成一篇结构化的长文。它会读完所有引用的笔记，提取脉络，重组成一篇。不用你手动复制粘贴拼接。

斜杠命令和侧边对话

斜杠命令。输入 / 或 $，调用可复用的提示模板。分用户级和知识库级两个作用域，你可以在库里定义一套自己的命令模板，重复用，不用每次重新描述需求。

侧边对话。用 /side 或 /btw 开一个独立的临时对话，在里面追问、调工具，主对话不受影响。有时候你想就某个细节问一下 AI，又不想打断主对话的上下文，侧边对话就是干这个的。

MCP：让笔记软件连数据库、跑脚本

这是它和普通 AI 插件拉开代际差距的地方。

MCP（Model Context Protocol）是个协议，让 AI 能调用外部工具。Claudian 继承各 Agent 原生 CLI 的 MCP 配置，你的笔记软件就不只是读写 Markdown 了——它能连数据库查数据、跑本地脚本处理信息、调用网络工具抓取资料，再把结果写回笔记。

举个例子，你写一篇关于某项目的笔记，让 Agent 通过 MCP 连数据库拉最新指标，跑个脚本算下趋势，然后把结果整理进笔记。整个过程在 Obsidian 里完成，笔记软件变成了一个能调外部工具的本地工作台。

Collab：像开 PR 一样协作改笔记

这个功能目前是实验性的，但思路有意思。

Claudian 支持多人多端协同。两种模式：局域网（LAN）模式，团队在本地网络内协作；自托管 Cloud 模式，数据存在你自己搭的 Claudian Cloud Server 上。配合 Git 追踪库内改动，团队能像写代码开 PR 一样协作改笔记——谁改了哪段、加了什么、删了什么，有版本记录，能审查，能回滚。

知识库不再是一个人的事，可以像代码仓库一样被团队协作维护。

实际用起来

安装两种方式。

社区插件商店（推荐）：Obsidian → Settings → Community plugins → Browse，搜 Claudian，安装，启用。

从源码构建：克隆仓库到 .obsidian/plugins 目录，npm install && npm run build，回 Obsidian 启用。

装好之后，选一个 Agent 提供者（Claude Code、Codex、Grok 等），配置对应的 CLI，就可以开始用内联编辑和 @引用了。兼容的 API 提供者包括 OpenRouter、Kimi、GLM、DeepSeek 等，不局限于一家。

实际感受。选中一段笔记，快捷键呼出，说”把这段改得更紧凑”，AI 输出词级 Diff，改动逐词高亮，确认替换，整个过程不离开笔记编辑区。@引用多篇笔记做交叉索引，比手动拼接高效得多。MCP 工具链需要你先在 CLI 里配好，有一定门槛，但配通之后能力跃升明显。

和其他工具比

和 Obsidian 其他 AI 插件比（比如 Copilot 类）：多数是侧边聊天，AI 给你一段文字，你手动贴回去。Claudian 是文件级 Agent，能直接读写笔记、跨笔记检索、跑命令，能力范围不同。

和在 AI 网页版里写笔记比：网页版没有你笔记库的结构，每次都得重新喂上下文。Claudian 有库的读写权，Agent 能自己通读引用的文件。

和独立用 Claude Code 比：终端里的 Agent 不认识 Markdown 笔记库的语义结构，也没有 Obsidian 的编辑体验。Claudian 把终端 Agent 的能力和笔记库的语境桥接起来。

适合什么人

如果你符合这几条，Claudian 值得一试：Obsidian 重度用户，笔记多到需要 AI 整理；在用 Claude Code 或 Codex 这类终端 Agent，想把能力用到笔记场景；追求知识管理智能化，希望跨笔记重构和批量整理；团队需要协作改笔记，想要版本控制。

几个提醒。插件因集成了 Claude Agent SDK，包大小超过 5MB，Obsidian 社区插件页会显示大插件警告，Obsidian 官方 Sync 服务不同步主插件文件（只支持 5MB 以下），多设备用户要在各设备上分别装。Collab 是实验性功能，目前还有 37 个开放 issue 在迭代。运行 Agent 需要对应 CLI 的本地配置。Claudian 不运行遥测，网络活动只限于明确的 Agent 运行时工作。

获取方式：Obsidian 社区插件商店搜 Claudian，或 GitHub 仓库 github.com/YishenTu/claudian。

笔记库可以是只读的存档，也可以是 AI 能读写的活的工作区。Claudian 选了第二条路。把终端级 Agent 嵌进来，笔记不再只是被翻阅，而是被整理、被重构、被协作。15.5k Star 说明了这条路有多少人在走。