
用 Obsidian 管笔记的人,经常有这样的场景:想让 Claude Code 整理一批笔记、补全链接、改一段文字,就得切到终端,cd 到笔记库目录,再回来看结果。
Claudian(作者 YishenTu,MIT 协议)是一个 Obsidian 插件,做的就是把这一步省掉:它把编码 Agent 嵌进 Obsidian,笔记库本身就是 Agent 的工作目录,读写文件、搜索、执行命令和多步骤任务都可以在里面完成。
这篇按官方仓库当前的 README 整理:它支持哪些 Agent、使用前提、怎么安装、几个常用功能,以及数据会发到哪里。
它是什么,不是什么

Claudian 是插件,不是新的 Agent。它连接的是你已经装好的编码 Agent。README 目前列出的有 Claude Code、Codex、Grok Build、OpenCode V2、Pi 和 DeepSeek Harness,并说后续还会增加。官方的说法是,用起来和你熟悉的编码 Agent 一样:你和 Agent 对话,它在笔记库里读文件、写文件、编辑、搜索、运行命令。
所以问题的答案是:能,Claude Code 是支持的 Agent 之一。使用前提有四条:
- 至少安装上面列出的一种 Agent;
- 有兼容的订阅或 API 服务商;
- Obsidian 版本在 1.13.0 以上;
- 仅支持桌面端(macOS、Linux、Windows),手机和平板上用不了。
安装

官方推荐的方式是从 Obsidian 社区插件安装:
- 打开 Obsidian,进入“设置”,选“社区插件”,点“浏览”;
- 搜索 Claudian,点击安装;
- 安装后启用插件。
也可以直接打开社区插件页面。装好后,从侧边的 ribbon 图标或者命令面板打开 Claudian 的界面。
如果你想从源码构建(主要是开发者用),官方的步骤是:把仓库克隆到笔记库的 .obsidian/plugins 目录下,目录名用 realclaudian,进入目录后运行 npm install 和 npm run build,最后在 Obsidian 的社区插件里启用 Claudian。
几个常用功能

README 里列出的功能比较多,日常使用最先会碰到的是这几个:
| 功能 | 怎么用 |
|---|---|
| 斜杠命令和 Skill | 输入 / 或 $,调出可复用的提示词模板,或者用户级、笔记库级的 Skill |
| @ 引用 | 输入 @,引用笔记库里的文件、文件夹,以及其他 Claudian 会话 |
| Inline Edit | 选中文字,或者把光标放在要写的位置,按快捷键,直接在笔记里改,并带逐词的 diff 预览 |
| 侧边对话 | 输入 /side 或 /btw,开一个临时的对话,可以追问、也能用工具,主对话不受影响 |
| Zen Mode | 收起放 Claudian 的侧边栏,对话变成笔记底部的紧凑输入框,有一行活动预览,点一下展开完整对话 |
| Projects | 把朝同一目标的会话归成一组,成员共享项目的指示和一个由 Agent 持续更新的记忆文件 |
另外还有几项:
- 跨会话消息:让 Agent 读取、发消息、引导或中断其他 Claudian 会话,也可以在任何一种支持的 Agent 上新开会话;
- MCP 服务器:通过每个编码 Agent 自己命令行里的 MCP 配置来连外部工具,Claudian 不另做一套;
- 标签页和会话管理:可以用单栏的多标签模式,也可以在聊天旁边放一个常驻的会话管理器(双栏模式);
- Plugin API(实验性):让别的 Obsidian 插件向会话发提示词、停止会话、读取回复。
多人协作的功能(Collab)现在是一个独立的插件,不在 Claudian 本体里,见官方的 Claudian Collab 仓库。
数据会发到哪里
笔记里往往有私人内容,这一点值得先看清。README 的“隐私”一节写得比较明确:
- 会发送给 API 的内容:你的输入、附加的文件和图片,以及工具调用的输出。取决于你选的 Agent,数据会发到 Anthropic(Claude)、OpenAI(Codex)、xAI(Grok),或者你在 OpenCode、Pi、DeepSeek Harness 里配置的服务商,目的地可以通过服务商设置和环境变量调整;
- 没有遥测和主动的后台活动:Claudian 不发送遥测。界面上的轮询定时器只读本地 Obsidian 和编辑器的选区状态,网络活动限于你明确触发的服务商调用、配置好的 MCP 端点,以及 OpenCode、DeepSeek 和 Grok 会话使用的、只监听 127.0.0.1 的本地端口。
也就是说,插件本身不做额外上报,但你让 Agent 读哪些笔记,那些内容就会发给你选的服务商。涉及敏感笔记时,要先想清楚用的是哪个服务商,再决定让 Agent 看什么。
遇到问题
官方有一份单独的排错指南,覆盖三类常见问题:找不到对应的命令行工具或 Node.js、新发布的模型在列表里没有、命令行订阅能用但认证失败。功能请求和 bug 可以到 GitHub 仓库提 issue。
和 AIGoCode 一起用时要注意什么
Claudian 本身只是个入口,请求最终是通过你选的 Agent 发出的。所以能不能走 AIGoCode,取决于你选的 Agent 本身怎么接入,Claudian 的 README 没有针对某个中转服务做说明,这一点不要想当然。
比较稳的顺序是:
- 先在终端里把 Agent 接好并跑通一次,可以对照接入 AIGoCode 前,Claude Code 和 Codex CLI 先检查这四项;
- 终端里没问题之后,再装 Claudian,从 Obsidian 里打开;
- 如果认证失败,README 提到的情形是“命令行订阅能用,但在插件里认证失败”,先看官方排错指南,再回头看AIGoCode 常见问题里对应的检查项;
- 想知道自己的分组里有哪些模型,到模型目录查看。
总结
Claudian 把“在终端里让 Agent 改笔记”这件事搬进了 Obsidian:笔记库是工作目录,@ 引用文件,Inline Edit 在笔记里直接改。上手的最短路径:确认 Obsidian 在 1.13.0 以上并且是桌面端,终端里先装好并跑通一个 Agent,再从社区插件安装 Claudian;第一次使用,建议先在一个不重要的测试笔记库里试,再放到真实的笔记库。