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插件，装好之后，Claude Code、Codex、Grok Build、OpenCode、Pi这些编码智能体会出现在你的知识库侧边栏里——你的vault直接变成AI的工作目录，文件读写、全文搜索、bash命令、多步骤工作流全部开箱即用。写笔记时可以顺手让它改代码、整理文件，不用来回切窗口。

开装前30秒检查清单

安装前先过一遍这四项，后面遇到的多数"装不上"问题其实都出在这里：

检查项	要求
至少一个编码智能体CLI	Claude Code、Codex、Grok Build、OpenCode、Pi，装任何一个即可
模型渠道	Claude订阅/API，或兼容提供商（OpenRouter、Kimi、GLM、DeepSeek等）
Obsidian版本	v1.13.0及以上（`manifest.json`中`minAppVersion`为1.13.0）
运行平台	仅桌面版（macOS、Linux、Windows），移动端不可用

⚠️ 注意：如果你打算用Collab协作模式（与队友共享项目），还需要在系统里安装Git。

Claudian安装：社区插件三步走

推荐路线：从Obsidian社区插件安装

打开Obsidian → 设置 → 社区插件 → 浏览
搜索"Claudian"，点击安装
回到社区插件列表，启用"Claudian"

备选路线：从源代码安装（适合开发或体验最新版）

cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build

构建完成后，照常到设置 → 社区插件中启用即可。源码安装需要本地有Node.js环境（项目开发环境为Node 24），如果你只是普通用户，走社区插件路线就够了，省掉整个构建环节。

装完后的第一屏：怎么确认它活了

启用后，点窗口左侧边栏的图标，或在命令面板里搜Claudian，会弹出一个聊天侧边栏。发一句"列出这个vault里的Markdown文件"，如果它能返回文件清单，说明集成成功。

接下来这几个入口可以立刻上手，都是日常高频操作：

Inline Edit：选中一段文字或把光标停在某处，按热键，直接在笔记里改写，保存前给你单词级别的差异预览
斜杠命令与技能：输入/或$，调出用户级和vault级的可复用提示词模板
@mention：输入@可以引用vault文件、文件夹和协作成员的变更；输入#引用协作工单
指令模式：从聊天输入框添加精炼过的自定义指令，约束AI的行为
MCP服务器：通过各智能体CLI原生的MCP配置接入外部工具
多标签与会话管理：单面板模式开多个聊天标签；双面板模式则用聊天旁的常驻会话管理器

装不上？先看这里

看到spawn claude ENOENT或Claude CLI not found别慌，这两个报错都指向同一件事：Obsidian作为GUI应用，找不到你的CLI。最常见的原因是你在用Node版本管理器（nvm、fnm、volta），而GUI进程继承不到那个环境的PATH。

解法一：手动指定CLI路径

先把CLI路径设置留空，让Claudian自动检测；自动检测失败时，用下面的命令找到真实路径，填进设置 → 高级 → Claude CLI路径：

平台	命令	示例路径
macOS / Linux	`which claude`	`/Users/you/.volta/bin/claude`
Windows（原生）	`where.exe claude`	`C:\Users\you\AppData\Local\Claude\claude.exe`
Windows（npm）	`npm root -g`	`{root}\@anthropic-ai\claude-code\cli-wrapper.cjs`

⚠️ 注意：Windows上避免使用.cmd和.ps1包装器——原生安装用claude.exe，包管理器安装用cli-wrapper.cjs；cli.js只是旧版npm包的遗留回退，别填它。

解法二：CLI和Node.js不在同一目录

npm安装的CLI尤其容易踩这个坑，确认两者是否同源：

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

如果路径不一致，Obsidian这类GUI应用会找不到Node.js。两条出路：改装原生二进制（推荐），或者在设置 → 环境 → 自定义变量里加上PATH=/path/to/node/bin，把Node的bin目录喂给它。

想再深一点

代码全部开源，想看实现可以从三处入手：侧边栏聊天在 src/features/chat/，设置界面在 src/features/settings/，Claude适配层在 src/providers/claude/，看完这条"CLI → 智能体 → 侧边栏"的链路就通了。下一步：随便打开一篇笔记，选中一句话，按内联编辑热键，让Claude Code改掉你的第一段落。

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

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

企业官网建设流程全解析