2026年1月22日星期四

Claudian:在Obsidian中集成Claude Code的高效AI插件

Claudian是一款Obsidian插件,让用户能在笔记软件内直接使用Claude Code的AI功能。安装需先配置Claude CLI,可通过手动或BRAT插件完成。与Copilot等文本生成工具不同,Claudian作为智能代理(Agent),能跨文件主动检索、读写和整理笔记,适合处理需要多步推理的复杂知识管理任务。它通过按需读取文件而非全库加载,优化了Token消耗,将AI深度融入思考与写作流程。

  见字如面,我是艾康。
点击关注👆防止迷路。







 

本文字数 2733,阅读大约需 5 分钟

最近,有一个 Obsidian 插件很火。

虽然它还没有上架到官方的插件应用市场,但是用过的都说好。

img

这个插件叫做 Claudian,也就是可以在 Obsidian 里使用Claude Code 。

这篇文章,就来说清楚:

Claudian 应该怎么装?装完怎么用?它和 Obsidian 里的其他 AI 插件又有什么本质区别?

如果你也想尝试这个插件,接着往下看。

如何安装和使用?

前面也说了,Claudian 目前还没上架 Obsidian 的插件市场,也就是你不能通过搜索插件名一键安装。

安装步骤比常规插件稍微麻烦一点。

在开始之前,你需要确认两件事:

第一,你的电脑上已经安装了 Claude Code(这是 Anthropic 官方出的命令行工具)。

(如果没有安装,可以通过官方教程进行安装:https://code.claude.com/docs/zh-CN/overview)

第二,你的 Obsidian 版本在 1.8.9 以上。

确认完这两点,开始装插件。

方式一:下载 Github 源码包

如果你习惯手动管理插件,可以选这个方式:

1、在你的 Obsidian 插件文件夹里(路径在 你的Obsidian目录/.obsidian/plugins/),新建一个名为 claudian 的文件夹

img

2、去 Github 下载最新的 main.jsmanifest.jsonstyles.css,把文件复制进上面创作的文件夹

下载地址:https://github.com/YishenTu/claudian/releases/latest

img

3、打开 Obsidian,进入设置 → 社区插件 → 重新加载插件 → 启用 Claudian

img

方式二:通过 BRAT 安装(推荐)

如果你嫌上面的步骤麻烦,或者想要自动更新,用这个方法:

1、先在插件市场装一个叫 BRAT 的插件(它专门用来安装那些还没上架的 Beta 插件)

2、启用并打开 BRAT 设置,点击「添加 Beta 插件」

3、输入仓库地址:https://github.com/YishenTu/claudian

4、点击「Add Plugin」,等它自动安装完

img

5、回到社区插件页面,启用 Claudian

装完之后,你会在 Obsidian 侧边栏看到一个小机器人图标🤖,点一下,右侧就会弹出对话窗口。

img

试着随便输入点什么,比如「你好」,看看它能不能正常回复。

不出意外,你看到的输出应该是:

❌ Error: Claude CLI not found. Please install Claude Code CLI.
img

并不是因为你没有安装 Claude Code,而是 Obsidian 作为一个 Electron 应用,通过图形界面启动时,往往读不到你在终端配置文件(如 .zshrc.bashrc)里设置的环境变量。

简单说,就是它找不到 Claude Code 装在哪。

解决办法很简单:

打开你的终端,输入这行命令:

which claude

正常情况下,它会输出一行路径,这就是你的 Claude Code 安装位置(前提是你真的安装了)。

复制这个路径,回到 Obsidian。

进入 Claudian 的设置页面,往下划,找到「高级」选项,里面有一项叫「Claude CLI Path」。

把刚才复制的路径粘进去。

img

再回到对话窗口,随便输入点内容。

如果这次它正常回复了,恭喜🎉,成功了。

img

同样是 AI,差别在哪?

装好之后,你可能会想:

「这看起来和我之前用的 Copilot、Smart Composer 也没什么区别啊?都是输入问题,AI 给答案。」

主要区别在这张表里:



维度Obsidian CopilotClaudian
大模型定位
文本生成器
Agent(会思考、会行动)
输入方式
当前笔记 / 选中文本
整个 Vault 作为工作目录
能否主动查找
❌ 不会
✅ 会
能否跨文件读取
✅ 可以(通过 RAG)
✅ 可以(主动检索)
能否跨文件写入/修改
❌ 不能
✅ 可以
是否有「执行过程」
❌ 一问一答
✅ 多步任务
思维模式
Prompt → Output
Goal → Plan → Act

看起来有点抽象?我举几个实际场景你就明白了。

Copilot 擅长的事:

  • • 「帮我润色这段话」
  • • 「总结当前这篇笔记的核心观点」
  • • 「把这段文字改写成更口语化的表达」
img

它的特点是:面向微任务,处理单段文本或当前笔记,主要用来写作、润色、总结等。

Claudian 擅长的事:

  • • 「帮我找出 Vault 里最近三个月关于『技能学习』的笔记,提炼出共识观点,并整理成一篇新笔记」
  • • 「查找我在不同日记里提到『焦虑』的所有段落,分析一下我的情绪变化规律」
  • • 「把『项目 A』文件夹下所有笔记里的待办事项,汇总到一个清单里」
img

十年之河,并不是一个世界知识,是我的笔记里的一个概念,但是它自己找出来了👆

它的特点是:面向目标,可以跨文件操作,擅长那些需要「先找 → 再判断 → 再回答/修改」的任务。

这就是两者最本质的差别:

Copilot 是一个「文本生成器」,你给它输入,它给你输出,一问一答。

Claudian 是一个「Agent」,你给它目标,它自己想办法达成,会思考,会行动。

你可能会说:「等等,Copilot 不是也有 Vault QA 功能吗?也能针对整个笔记库回答问题啊。」

没错,但背后的实现方式,完全不同。

为什么读取整个 Vault,Token 却没爆炸?

如果你用过 Copilot 的 Vault QA,你会发现,它在回答问题之前,需要先对整个笔记库做「向量化」处理。

这个过程用的是 RAG(检索增强生成)技术:

1、把所有笔记内容做 embedding(嵌入),转成向量

2、你提问时,系统先做向量检索,找出「可能相关」的笔记

3、把这些笔记内容塞进 prompt,让 AI 生成答案

它的逻辑是:提前准备好答案库,等你来问。

而 Claudian 的方式完全不同。

不会把整个 Vault 一次性塞进上下文,而是用的「Agent 式文件系统访问」。

什么意思?

打个比方:

你去图书馆找一本书,RAG 的做法是,提前给图书馆所有书都做好索引卡片(向量),你提问时,系统在卡片库里找出最相关的几本,然后把这几本书全文递给你。

Claudian 的做法是,拿着你的问题去索引系统查,走到书架,但只翻开必要的那几页,而不是把整本书都递过来。

实际流程是这样的👇(简化版)

img

所以,Claudian 的 Token 消耗 = Agent的 推理过程 + 工具调用 + 实际读取的内容

你的笔记库有 1000 篇笔记?没关系,如果完成任务只需要读 5 篇,那最终送进上下文的就只有这 5 篇的内容。 

但要注意:如果任务复杂,Agent 的多轮思考和工具调用本身也会消耗 Token,只是相比把整个 Vault 塞进去,仍然高效得多。

那我直接用 Claude Code 不就行了?

看到这,可能有人会想:

「那这个 Claudian,不就是给 Claude Code 套了个 Obsidian 的壳吗?我直接在终端里用 Claude Code 不就完了?」

是的,没错。

从能力层面看,它们几乎一样,都可以实现多步推理、文件读写、搜索目录、执行命令、处理长任务。

本质上,Claudian 就是在 Obsidian 里运行 Claude Code Agent。

但这个「壳」,恰恰决定了它是不是一个完全不同的工具。

真正的差别在于:你站在什么位置使用,或者说,你用什么身份去使用。

在终端里用 Claude Code:

你的默认身份是:「我在操作一个项目目录」。

  • • 当前目录 = 项目文件夹
  • • 文件 = 代码或配置文件
  • • 目标 = 完成一个任务

它非常适合编程、自动化脚本、处理一次性任务。

在 Obsidian 里用 Claudian:

你的默认身份是:「我正在思考、写作、构建知识体系」。

  • • Vault = 你的长期知识资产
  • • 文件 = 思考过程,而不是任务输入
  • • 当前打开的笔记 = 你的注意力焦点

它更适合知识管理、深度研究、写作创作、长期复盘。

img

还有一个很容易被忽略的点:Claudian 自动提供的「隐形上下文」。

在 Claudian 里,Claude Code 默认就知道:

  • • 你当前打开的是哪篇笔记
  • • 你选中了哪段文字
  • • 这篇笔记在 Vault 中的相对位置

而在终端里,这些信息每一次都要你「显式说明」

所以,如果你本来就在用 Claude Code,是否需要再装 Claudian?

我觉得取决于你的实际使用场景:

  • • 如果你主要是写代码、跑自动化脚本、处理临时任务 → 直接用 Claude Code 就行
  • • 如果你主要是做知识管理、写作、研究、复盘、深度思考 → Claudian 更合适

工具没有绝对的好坏,只有适不适合你当下的工作场景。

另外 Claudian 还有非常多的功能,这篇文章篇幅有限,就不过多介绍了,感兴趣的可以去 Github 查看:

图片

写在最后

Claudian 并没有让 Claude Code 变得更强。

它只是把 Claude Code 放在了一个「你本来就在思考的位置」。

就像你不会在命令行里浏览网页(虽然可以用 curl),也不会在浏览器里编译代码(虽然也能做)。

不是做不到,而是场景不匹配

如果你已经在用 Obsidian 做知识管理,如果你希望 AI 能更深度地参与到你的思考过程中,那 Claudian 就值得试一试。

 

图片

以上,就是本文全部内容,如果觉得这篇文章对你有启发,点赞、比心、分享三连就是对我最大的支持,谢谢~

往期推荐阅读
•  Obsidian 从入门到进阶合集

• AI把我推成"知名"博主后,我发现了一条产业链

• AI写作的真相:你才是那个最重要的模型

• 善用 AI,实际上对人的要求只会越来越高 

• 用 Gemini 解锁 YouTube 新用法,信息获取效率提升 10 倍

• AI 是如何变强的?Jeff Dean 斯坦福分享解读 

• 别再纠结 AI 味,内容创作应该回归第一性原理

• 有了 NotebookLM 后,还需要 Obsidian 吗?

• 你越是会写作,就越能把 AI 用好

• 我试了 NotebookLM 学习法后,彻底抛弃传统学习方式

• NotebookLM 的这个更新,比 Gemini 3 Flash 更让我兴奋

• NotebookLM 再次升级,来自谷歌的年终礼物

• 我用 NotebookLM 解锁 PPT 的 5 种玩法,实现了 PPT 自由

• AI 设计的下半场,拼的不只是模型,还有工作流

• AI 时代,你的上下文才是最值钱的资产

• 2026 年,最需要掌握的一个AI技巧

没有评论:

发表评论

新SeaArt登顶全球AI创作社区,SeaVerse引领全模态创作新体验

中国团队打造的AI创作平台SeaArt,凭借全链路多模态创作能力与社区生态,两年半内全球访问量超Midjourney等平台,注册用户超5000万。其升级版SeaVerse通过多模态AI与Agent协作,实现"一句提示词生成宇宙"的极简交互,覆盖图片、视频、音频...