Claudian 实操笔记：3 条路径装好插件，在 Obsidian 里接入 Claude Code

Claudian 实操笔记：3 条路径装好插件，在 Obsidian 里接入 Claude Code

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

Claudian 插件把 Claude Code、Codex 等编码助手嵌进 Obsidian，知识库直接变成 AI 的工作目录。本文讲清装前检查、三条安装路径和两个高频报错的修法，读完就能在自己库里跑起来。

30 秒速览

• 装前确认 Obsidian 版本 ≥ 1.13.0，且终端里能找到至少一个 Agent CLI（claude、codex等）。
• 三条安装路径：社区市场一键装、从 Release 手动放文件、从源码npm run build。
• 装完用聊天侧边栏界面验证插件是否真正可用，而不是只看启用开关。
• 两个最高频报错spawn claude ENOENT和 npm 装 CLI 找不到 Node，按步骤改 PATH 即可。

装之前先确认这几样

依赖项	最低版本	验证命令	是否必须
Obsidian	1.13.0	设置 → 关于 → 查看版本	必须
Claude Code CLI（或 Codex 等任一 Agent CLI）	有可用版本	which claude	必须
Node.js	24	node -v	仅源码构建
桌面系统	macOS / Linux / Windows	—	必须
Git	任意	git --version	仅 Collab 模式

两个容易踩的坑：Claudian 只支持桌面版 Obsidian，移动端上不了线。GUI 程序读的是系统 PATH，不是你终端里 shell 配置过的 PATH——用 nvm、fnm、volta 管理 Node 的人，八成会踩到后文的spawn claude ENOENT。

选一条 Claudian 安装路径

三条路都通向同一个结果，区别只在你愿意花多少时间：只想立刻用上就选 A，社区市场里搜不到时退回 B，想改代码或追最新版再折腾 C。

从 Obsidian 社区市场装

1. 打开 Obsidian，进入 设置 → 第三方插件（Community plugins）。
2. 关掉安全模式（如果还开着），点 浏览（Browse）。
3. 搜索框输入Claudian，在结果里点 安装。
4. 回到插件列表，打开 Claudian 的启用开关。

从 Release 手动放文件

1. 打开项目的 Release 页面，下载最新版附带的main.js、manifest.json、styles.css三个文件。
2. 在知识库下找到插件目录.obsidian/plugins/，新建子目录claudian。
3. 把三个文件复制进.obsidian/plugins/claudian/。
4. 重启 Obsidian，进 设置 → 第三方插件 列表，启用 Claudian。

从源码构建

1. 克隆仓库进插件目录（需要 Node 24 环境）：

   cd /你的知识库路径/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian

2. 安装依赖并做生产构建：

   npm install npm run build

3. 重启 Obsidian，在 设置 → 第三方插件 里启用 Claudian。

验证安装后的 Claudian 界面

这是装完并启用后的实际画面，对应上面任一安装路径的最后一步。左侧是笔记编辑区，右侧就是 Claudian 的聊天侧边栏。底部输入框用来对话，/、$、@都在这里触发命令与提及。顶部标签栏管理多个会话，双栏模式下旁边还挂一个持久会话管理器。左侧边栏的 Claudian 图标随时能把面板唤出来。插件没有独立配置文件，所有配置都在 Obsidian 设置页里，包括Claude CLI 路径与环境变量。

速查 Claudian 高频报错

spawn claude ENOENT

原因一句话：Obsidian 是 GUI 程序，读不到你终端 shell 里配过的 PATH，所以找不到claude可执行文件。用 nvm、fnm、volta 的人尤其高发。

1. 先把设置里的Claude CLI 路径留空，让插件走自动检测。

2. 自动检测失败，去终端查真实路径：

   which claude

   Windows 用where.exe claude。

3. 把查到的绝对路径填进 设置 → 高级 → Claude CLI 路径，重启 Obsidian。

npm 装的 CLI 跑不起来

现象：CLI 装好了，插件一调用就报找不到 Node。原因是 npm 全局装的claude和node不在同一目录，Obsidian 顺着claude的位置找不到 Node。

1. 对比两个路径：

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

2. 如果不一样，推荐直接装原生二进制版本，一步到位。

3. 替代方案：在 设置 → 环境 → 自定义变量 里加PATH=/path/to/node/bin，把 Node 目录指给插件。

Windows 下选错可执行文件

现象：填了路径还是报错。原因：填成了.cmd或.ps1包装脚本，GUI 程序调不动。改成原生安装的claude.exe，或 npm 安装对应的cli-wrapper.cjs；cli.js只是老版本的遗留回退，不要选它。

接下来可以玩什么

• 选中一段文字按内联编辑热键，AI 直接在笔记里改写并给你逐词 diff——改字不丢格式。
• 复杂任务先按Shift+Tab切 Plan 模式，AI 先探索设计、给出方案，你批准了才动手。
• 输入/或$存一个常用提示词当技能，以后一句话触发整段工作流。
• 想读实现，聊天渲染逻辑在src/features/chat/，各提供商适配器在src/providers/下，结构很直白。

到这里，从装前检查、三条安装路径到两个高频报错，整条链路都过了一遍。下一步建议现在就打开 Obsidian，在侧边栏输入框敲一个/触发任意命令，验证从对话到 Agent 执行的整条链路都通了。

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