5 步上手 Claudian 插件:在 Obsidian 里让 AI 直接改你的笔记

5 步上手 Claudian 插件:在 Obsidian 里让 AI 直接改你的笔记

【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian

Claudian 插件是一款 Obsidian 插件,把 Claude Code、Codex、Grok 等 AI 编码代理嵌进你的笔记库——vault 就是代理的工作目录,读文件、写文件、搜索、执行命令开箱即用。读完这篇,你能完成安装配置,并跑通对话、内联编辑和 @引用这几个日常动作。

三分钟装好 Claudian 并配好 CLI

从装好插件到能跑通第一条对话一共 5 步,全程只需要 Obsidian 设置页和终端。

1. 装插件:设置 → 社区插件 → 浏览,搜索 "Claudian" 点安装并启用。注意它仅支持桌面端(Obsidian 1.13.0 及以上)。
2. 装至少一个代理 CLI:Claude Code CLI、Codex CLI、Grok Build、OpenCode、Pi 任选其一,默认推荐 Claude Code CLI。关键设置项是 CLI 必须在终端 PATH 里能被找到。
3. 准备模型接入:用订阅,或 OpenRouter、Kimi、DeepSeek 这类 API 服务商,后续可在 provider 设置和环境变量里改去向。
4. 确认 CLI 检测:先把设置 → Advanced → Claude CLI path留空让 Claudian 自动检测;检测不到再用which claude找到绝对路径填进去。
5. 打开聊天侧边栏:点 ribbon 图标或从命令面板调用,输入框下方选 provider 和模型,这条路径就通了。

不想装社区版的话,也可以从源码装:把仓库 clone 到 vault 的.obsidian/plugins目录(git clone https://gitcode.com/GitHub_Trending/cl/claudian),执行npm install和npm run build再启用。

四步跑通第一次 AI 对话

打开侧边栏后,整段对话遵循"描述需求—看操作—确认结果"的节奏,下面 4 步走一遍。

1. 一句话描述需求,比如"读一下当前这篇笔记,把章节整理成三部分"。你会看到代理先 Read 目标文件,再逐步列出它的操作清单,每一步都有中文说明。
2. 逐条看它执行的操作:读文件打勾,编辑 Markdown 会标出变化量(类似 +18 −1)。你会看到它到底动了哪个文件、动了多少,而不是一个黑盒。
3. 确认或驳回变更:接受后写进笔记,拒绝就不算数。你会得到一个随时可以核对的结果,而不是"它说改好了"。
4. 同一会话追问,或开新 tab 聊新话题:单面板模式支持多 tab,双面板模式旁边还有一个持久会话管理器。你会得到按主题独立、随时可回看的历史。

想读源码的话,侧边栏聊天编排在 src/features/chat/,内联编辑在 src/features/inline-edit/,结构都很直白。

用好内联编辑、@引用和斜杠模板

这三个功能都围绕"少打字",是熟练之后最省时间的部分。

内联编辑:你在笔记里只想改一段话,不想切去侧边栏解释上下文。选中文字(或把光标放在要改的位置)按内联编辑快捷键,会弹出一个词级 diff 预览,逐词标出新增和删除。你接受就直接写入,拒绝就还原,改动全程可见。

@mention 引用:代理缺上下文时,在输入框打@选择 vault 里的文件或文件夹,一步把相关材料挂上,不用复制粘贴内容。它读完后可以基于这些材料做跨文件搜索、批量重命名这类操作,结果会直接落在对应笔记里。

/ 与 $ 模板:同类指令重复到第三次,就该存成斜杠命令或 Skill(支持用户级和 vault 级两个作用域)。以后打/或$调出,一句话模板变成一次击键;/instruction还能把精炼后的自定义指令附加到当前输入里。

确认数据会发到哪里

装之前先看清楚数据流向:你的输入、附件文件、图片和工具调用输出会发给你选定的服务商(Anthropic、OpenAI、xAI 等),具体去向可以在 provider 设置里改。Claudian 本身不跑遥测,除显式请求外没有后台网络活动;实验性的 Collab 模式也只在局域网的受邀设备之间走数据。

避开三个最常见的报错

报错大多出在 CLI 这一层,三个高频问题按出现频率排。

找不到 CLI(ENOENT):Obsidian 这类 GUI 应用不继承 shell 的 PATH,用 nvm、fnm、volta 管 Node 时尤其容易挂。先把 CLI 路径设置留空让自动检测跑一次;不行就用which claude取绝对路径填进设置 → Advanced → Claude CLI path。

npm 装的 CLI 和 Node.js 不在同一环境:npm 全局装的 provider CLI,可执行文件和 Node.js 分属不同目录时,Obsidian 可能找到了 CLI 却拉不起它。装原生二进制(官方推荐),或在设置 → Environment里补上 Node 路径。

Collab 模式没装 Git:实验性的 Collab 模式靠 Git 在局域网同步项目数据,缺了它整个流程起不来。先装好 Git,设置里的 Collab 页也有依赖说明。

不用做任何额外配置了:打开侧边栏,选中笔记里的一句话,按内联编辑快捷键,看看第一版 diff 长什么样。

【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian