5 分钟把 Claude Code 装进 ObsidianClaudian 插件安装教程与排错指南【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudianClaudian 是一个 Obsidian 插件把 Claude Code、Codex 这类编码 Agent 直接嵌进你的知识库启用后你的 vault 就是它的工作目录文件读写、搜索、bash 命令和多步工作流都能做。这篇文章按场景→环境检查→安装→验证→排错的顺序走完覆盖两种安装方式和最常见的两个报错。先想清楚你要用它干什么Claudian 的主入口是聊天侧边栏点 Obsidian 左侧图标栏ribbon里的图标或者打开命令面板搜对应命令就能调出来。核心能力基本都围绕这个面板和编辑器本体Inline Edit内联编辑选中文本或把光标停住后按热键直接在当前笔记里改字带单词级 diff 预览改前改后一目了然。Slash Commands Skills输入框敲/或$调出用户级、vault 级两种作用域的可复用提示模板。mention敲引用 vault 里的文件和文件夹配合 Collab Mode 还能引用成员变更敲#引用工单ticket。Instruction Mode用/instruction给消息附加一条精炼的自定义指令约束 AI 的作答方式。MCP Servers外部工具走各 Agent CLI 原生的 MCP 配置接入插件本身不重复造轮子。多 Tab 与会话管理单栏模式开多个聊天 tab双栏模式则在聊天旁挂一个常驻会话管理器。Collab Mode实验性和其他 Claudian 用户在局域网内协作共享项目前提是装了 Git。你的主要用途如果是让 AI 读写我的笔记侧边栏聊天就够想原地改选中文字就看 inline edit。先定下主场景后面装哪个 provider 会顺理成章。装之前的环境检查3 个必查项Obsidian ≥ 1.13.0且是桌面端Claudian 只支持 macOS、Linux、Windows 桌面版Obsidian 最低 1.13.0。在 Obsidian 左下角的关于里能看到当前版本号版本不够就先升级再装插件。至少装好一个 Agent CLIClaudian 自身不带模型能力它驱动的是你机器上已装好的 CLI。下面至少有一个Claude Code CLI、Codex CLI、Grok Build、OpenCode、Pi。以 Claude Code 为例在终端跑which claude终端能打出绝对路径说明 CLI 在 PATH 里Claudian 才有机会自动检测到。Windows 上换成where.exe claude。一个容易踩的坑如果你用 nvm、fnm、volta 这类 Node 版本管理器装 CLI终端里看得到它但 Obsidian 这种 GUI 应用往往读不到同一份 PATH——这正是下文排错部分那个报错的头号来源。提供商账号或 API 已就绪需要 Claude 订阅/API或者 OpenRouter、Kimi、GLM、DeepSeek 这类兼容提供商。具体用哪家、怎么配进 Claudian 的设置页再决定不影响安装。安装实操两种方式选一种方式一从社区插件市场装推荐Obsidian → 设置 → 社区插件 → 浏览搜索 Claudian点 Install回到插件列表把 Claudian 启用验证点启用后左侧图标栏多出一个新图标点它或命令面板能打开聊天侧边栏就算装好了。方式二从源码构建想改代码、追新版的人看这里构建需要 Node.js 24项目的 engines 固定为24 25。先把仓库克隆进 vault 的插件目录cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian.git cd claudian安装依赖并打生产包npm install npm run build验证点构建成功后仓库根目录会生成main.js、manifest.json、styles.css三个文件Obsidian 会直接从该目录加载插件不需要额外拷贝。日常开发用npm run dev进入 watch 模式想让构建产物自动同步到指定 vault设置OBSIDIAN_VAULT环境变量或写进.env.local构建脚本会把三个文件复制到那个 vault 的.obsidian/plugins/claudian/。装完第一件事发一条能验证文件读写的消息别只发你好。发一条能验证核心能力的比如列出这个 vault 里的 md 文件并读取最近修改的那篇内容。Agent 真的把文件读出来并回答内容说明 CLI 检测和 provider 链路都没问题答不上来往下看。随后可以快速摸一遍其他入口输入框敲/看命令列表、选中一段文字触发 inline edit 看 diff 预览、用引用一个文件确认交互都通。报错指南两种最常见的装不上 / 用不了spawn claude ENOENT或Claude CLI not found根因几乎都是同一个Obsidian 找不到 CLI。处理顺序固定先把 CLI 路径设置留空让 Claudian 走自动检测自动检测失败再手动填。还是不行就查出可执行文件的真实路径填到 设置 → Advanced → Claude CLI path。各平台查法平台命令示例路径macOS / Linuxwhich claude/Users/you/.volta/bin/claudeWindows原生安装where.exe claudeC:\Users\you\AppData\Local\Claude\claude.exeWindowsnpm 安装npm root -g{root}\anthropic-ai\claude-code\cli-wrapper.cjsWindows 专属坑别指向.cmd或.ps1包装脚本。原生安装用claude.exe包管理器安装用cli-wrapper.cjscli.js只是旧版 npm 包的遗留回退。 3. 另一条路把 Node 的 bin 目录加进 PATH位置在 设置 → Environment → Custom variables。npm 装的 CLI 和 Node.js 不在同一个环境用 npm 装 CLI 的话确认claude和node是否在同一个目录dirname $(which claude) dirname $(which node)两条路径不一致时GUI 应用大概率找不到 Node.js。两个解法换原生二进制推荐或者在 设置 → Environment 里补一条PATH/path/to/node/bin。想读源码的话从这两个目录切入上手之后想深入看实现入口很清晰src/core/ 是 provider 无关的运行时、注册表和类型契约含 providers 注册、prompt、存储各家 provider 的适配层在 src/providers/ 下按 claude、codex、grok、opencode、pi 分目录。聊天侧边栏 UI 在 src/features/chat/内联编辑在 src/features/inline-edit/设置外壳在 src/features/settings/插件入口是 src/main.ts。【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考