Claudian 插件安装教程：3 步把 Claude Code 接进 Obsidian-迪斯科星球

Claudian 插件安装教程：3 步把 Claude Code 接进 Obsidian

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

Claudian 是一个 Obsidian AI 插件，它把 Claude Code、Codex、Grok、OpenCode、Pi 这类编码助手接进你的笔记库：读文件、改笔记、跑搜索和多步任务，全部发生在笔记旁边。它的安装成本不高，适合两类人：手里已经有这些助手订阅、想顺手用在笔记上的人；以及不想在代码编辑器和笔记之间来回切窗口的人。

装前 30 秒自检

4 项硬条件，缺一项都跑不起来，花 30 秒对照一下：

检查项	最低标准	何时需要
AI 编码助手 CLI	Claude Code、Codex、Grok Build、OpenCode、Pi 至少装 1 个	必装，装 1 个就能用，其余随意
Obsidian 版本	桌面端 v1.13.0 及以上（macOS / Linux / Windows）	必装；移动端不支持
提供商账号	对应助手的订阅或 API Key	必装，没有授权就调不了模型
Git	任意可用版本	只开协作（Collab）模式时才需要

如果你用 nvm、fnm、volta 这类 Node 版本管理器装过 CLI，先记住这一点，后面对报错会用到。

3 步装完

打开 Obsidian，进入设置 → 社区插件。
点「浏览」，在搜索框输入 Claudian，点「安装」。
装完回到插件列表，把 Claudian「启用」。

侧边栏出现 Claudian 图标即代表装好，建议重启一次 Obsidian 再使用。市场里搜不到时，用这两种备选：

手动装：把发布版的main.js、manifest.json、styles.css放进库的.obsidian/plugins/claudian/目录，重启 Obsidian。
源码装：进入库的.obsidian/plugins目录，执行git clone https://gitcode.com/GitHub_Trending/cl/claudian，再依次跑npm install和npm run build。

第一次打开它

点侧边栏图标，界面分成左右两半：左边是你的笔记正文，右边是 Claudian 对话面板。面板顶部滚动记录 AI 做过哪些文件操作（读、写）以及每次改动的行数，中间是对话流，底部输入框下方可以切换模型和思考档位。随便问一句，确认它读写了库里的文件，就算接通了。

挑三件事试试手

改一段原文。在笔记里选中一段文字，用热键触发内联编辑，AI 直接在原文位置改写。改动以单词级差异标出来，按回车接受，按 Esc 拒绝。

发一条模板。输入框里敲/或$，会列出你保存过的提示模板和技能。把一条重复性工作流存成模板后，以后一个字符就能发出去。

点名一个文件。输入框里敲@可以引用库里的文件或文件夹，直接喂给对话；在协作模式里敲#还能引用协作票据。

报错速查

报错信号	先查什么	去哪改
`spawn claude ENOENT`或`Claude CLI not found`	终端跑`which claude`（Windows 用`where.exe claude`）确认 CLI 是否真的可找到；nvm、fnm 用户尤其留意	设置 → 高级 → Claude CLI 路径，把实际路径填进去；路径先留空让插件自动检测
CLI 装好了，插件还是连不上	分别执行`dirname $(which claude)`和`dirname $(which node)`，两个目录不一致说明桌面程序找不到 Node	设置 → 环境，把 Node 所在目录加进自定义变量；或改用原生二进制安装版
Codex、OpenCode、Pi 等提供商反应异常	确认对应 CLI 已在终端直接跑通、版本正常	按上面两条核对路径，再对照该提供商自己的文档检查安装

装完之后的下一步

源码分四块，各管一段：providers/ 放各家 AI 的适配器，features/chat/ 是聊天侧边栏，core/是不依赖具体提供商的运行时，features/inline-edit/管内联编辑。装好之后，挑一个真实任务完整跑一遍（比如让它整理一篇笔记的章节），再把一条你高频使用的指令存成模板，插件就算真正上手了。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析