企业官网建设流程全解析

5 分钟把 Claude Code 装进 Obsidian：Claudian 插件安装教程与排错指南

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

Claudian 是一个 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 CLI

Claudian 自身不带模型能力，它驱动的是你机器上已装好的 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 的设置页再决定，不影响安装。

安装实操：两种方式选一种

方式一：从社区插件市场装（推荐）

1. Obsidian → 设置 → 社区插件 → 浏览
2. 搜索 "Claudian"，点 Install
3. 回到插件列表，把 "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。处理顺序固定：

1. 先把 CLI 路径设置留空，让 Claudian 走自动检测；自动检测失败再手动填。
2. 还是不行，就查出可执行文件的真实路径，填到 设置 → Advanced → Claude CLI path。各平台查法：

Windows 专属坑：别指向.cmd或.ps1包装脚本。原生安装用claude.exe，包管理器安装用cli-wrapper.cjs，cli.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