Claudian 安装教程:把 Claude Code 接进 Obsidian,从 0 到侧边栏对话

在很多人看来使用CLI还是有一定难度的，或者在编辑文案内容的时候很不方便，需要来回切换文章和CLI命令行，我这篇要做的事很直接：Obsidian 左边多一个机器人图标，点开之后在侧边栏发一句话，Claude 直接把内容写进笔记。不切屏，不开终端让AI模型和Obsidian融为一体。

我自己也是Obsidian 高强度的使用者。但是在文学创作的时候Claude code和Obsidian来回切换让我痛苦不堪，最后我找到了这个Claudian 可以完美的解决我的问题，这里我也把我自己的踩坑和安装总结成了这篇文章。

Obsidian的安装

第一步：下载Obsidian

下载地址：https://obsidian.md/download

第二步：创建仓库

因为Claudian 还没进官方插件市场，所以我们需要通过 BRAT 装。BRAT 是 Obsidian 社区专门装 beta 插件的工具，非常的安全和高效。

第一步：先开 Obsidian 第三方插件：设置 → 第三方插件 → 关掉安全模式

第二步：搜索BRAT插件（启用插件）

然后用 BRAT 拉 Claudian：左侧列表进 BRAT → Add beta plugin → 粘这个地址：

https://github.com/YishenTu/claudian

等它装完。回设置页，左侧多出 Claudian，点进去：

这一步之后，分成两条路：订阅路径和反代。

订阅路径：不用再改。第一次发消息时 Claude Code 可能弹一个登录链接，跟着走，跟claude code都是一样的使用方式，如果你一个登入授权过就不需要管了。

反代/中转路径：在 Claudian 设置里找到"自定义环境变量"这一块（字样以你装的版本为准），追加两条：

ANTHROPIC_API_KEY=你中转站的 key ANTHROPIC_BASE_URL=你中转站的地址

ANTHROPIC_BASE_URL 是接口根路径，不是登录页地址，别粘错。中转站控制台的"API 接入"那栏一般能找到。

如果是使用nvm安装的node环境的需要注意CLI命令的路径，默认使用的是用户的命令行窗口，但是如果你有多个node环境可以会导致出现错误。

关掉设置页，看 Obsidian 左边功能区那一竖排图标——应该多出一个机器人。

没看到的话：

点机器人图标，右边弹侧边栏。输入框里发一句最轻的：

你是谁

几秒内应该开始流式输出回复。看到回复就算跑通。

跑不通的三种画面：

现象：侧边栏一发消息就弹红字 Claude CLI not found。

定位：

现象：路径填得一字不差还是找不到 claude。用 nvm、volta、fnm 的人最容易踩，claude 和 node 可能不在同一个目录，Claudian 启动子进程时 PATH 里只有其中一个。

先对比：

dirname $(which claude) dirname $(which node)

两条一样就不是这个问题。不一样就是。

两种解法：

A. Claudian 设置里把 Node 目录也加进 PATH

高级 → 环境变量 → 找到 PATH，把 dirname $(which node) 的目录用冒号追加进去，原内容不动。重启 Obsidian。

B. 装 Claude Code 原生二进制，绕开版本管理器

去 Anthropic 官方下载对应系统的原生二进制，装完 which claude 会指向系统级目录（比如 /usr/local/bin/claude），和 Node 无关。Claudian 里重填新路径。

Claudian 其实也同时支持 Codex 作为后端，但官方仓库写着还是 beta状态，跨平台还在验证阶段不稳定。我自己测试过能跑没问题，但是还是有优化的空间。

但是大体的思路都是一样的：装好 Codex CLI，Claudian 里把 provider 切成 Codex，CLI 路径换成 Codex 的可执行文件。报错排查套路基本一致。等 Claudian 把 beta 摘掉我再回来补一篇专门讲 Codex 的。

三条路，我的排序很明确：

到这里，Claudian 装完、侧边栏能对话，安装这件事就算结束了。但装上只是把路打通——斜杠命令怎么用、@提及笔记怎么喂上下文、计划模式怎么拆任务，这些才决定它到底是个聊天框还是你的写作搭档。下一篇再讲。