跳转到内容
全部开发指南

Claude Code 能直接在 Obsidian 里用吗?Claudian 插件的安装、功能和使用前提

AIGoCode发布于 更新于

Claudian 把 Claude Code 放进 Obsidian 封面

用 Obsidian 管笔记的人,经常有这样的场景:想让 Claude Code 整理一批笔记、补全链接、改一段文字,就得切到终端,cd 到笔记库目录,再回来看结果。

Claudian(作者 YishenTu,MIT 协议)是一个 Obsidian 插件,做的就是把这一步省掉:它把编码 Agent 嵌进 Obsidian,笔记库本身就是 Agent 的工作目录,读写文件、搜索、执行命令和多步骤任务都可以在里面完成。

这篇按官方仓库当前的 README 整理:它支持哪些 Agent、使用前提、怎么安装、几个常用功能,以及数据会发到哪里。

它是什么,不是什么

Claudian 把 Agent 放进 Obsidian 笔记库

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 社区插件安装 Claudian 的步骤

官方推荐的方式是从 Obsidian 社区插件安装:

  1. 打开 Obsidian,进入“设置”,选“社区插件”,点“浏览”;
  2. 搜索 Claudian,点击安装;
  3. 安装后启用插件。

也可以直接打开社区插件页面。装好后,从侧边的 ribbon 图标或者命令面板打开 Claudian 的界面。

如果你想从源码构建(主要是开发者用),官方的步骤是:把仓库克隆到笔记库的 .obsidian/plugins 目录下,目录名用 realclaudian,进入目录后运行 npm install 和 npm run build,最后在 Obsidian 的社区插件里启用 Claudian。

几个常用功能

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 没有针对某个中转服务做说明,这一点不要想当然。

比较稳的顺序是:

  1. 先在终端里把 Agent 接好并跑通一次,可以对照接入 AIGoCode 前,Claude Code 和 Codex CLI 先检查这四项;
  2. 终端里没问题之后,再装 Claudian,从 Obsidian 里打开;
  3. 如果认证失败,README 提到的情形是“命令行订阅能用,但在插件里认证失败”,先看官方排错指南,再回头看AIGoCode 常见问题里对应的检查项;
  4. 想知道自己的分组里有哪些模型,到模型目录查看。

总结

Claudian 把“在终端里让 Agent 改笔记”这件事搬进了 Obsidian:笔记库是工作目录,@ 引用文件,Inline Edit 在笔记里直接改。上手的最短路径:确认 Obsidian 在 1.13.0 以上并且是桌面端,终端里先装好并跑通一个 Agent,再从社区插件安装 Claudian;第一次使用,建议先在一个不重要的测试笔记库里试,再放到真实的笔记库。

参考链接