Claudian 安装指南:把 Claude Code 嵌进 Obsidian 侧边栏的 3 条路径
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
你在 Obsidian 里写完一段内容,想让 Claude Code 顺手改个东西,可终端在另一个窗口,来回复制粘贴很麻烦。Claudian就是为省掉这种窗口切换而做的:它把 Claude Code、Codex 这类 AI 编码助手直接嵌进 Obsidian 侧边栏,知识库变成 AI 的工作区——文件读写、检索、执行命令、跑多步任务都能就地完成。
🧰 装上 Claudian 之后你能拿到什么
功能不逐条罗列了,最值得先上手的是这三件事:
- 在编辑器里直接改笔记:Inline Edit对选中的文字或光标位置用热键触发,AI 就地修改内容,落笔前你能先看到单词级别的差异预览。
- 对话本身可管理:侧边栏支持多个聊天选项卡、完整的历史记录,还能对对话做分叉和恢复,另有一个紧凑视图来收拢长线程。
- 上下文工具箱开箱即用:输入
@可以提及你希望 AI 处理的任何内容——知识库文件、子代理、MCP 服务器,甚至外部目录里的文件;输入/或$调用可复用的提示模板(Slash Commands & Skills),个人和知识库级别都支持;输入#添加一条精炼的自定义指令(Instruction Mode);按Shift+Tab进入Plan Mode,AI 会先探索项目、给出计划,经你批准后才动手执行。再配合 MCP 服务器,还能通过 stdio、SSE、HTTP 三种方式把外部工具接进工作流。
📋 安装前确认一下环境
- Obsidian 版本 v1.7.2 及以上,且为桌面端(macOS、Linux、Windows)
- 已安装Claude Code CLI(推荐原生安装),并有可用的 Claude 订阅/API 或兼容提供商
- 可选提供商:Codex CLI、Opencode
如何安装 Claudian
推荐:从 Obsidian 社区插件商店安装
- 打开 Obsidian,进入 设置 → 社区插件
- 点击 浏览,搜索 “Claudian”
- 点击 安装
- 返回插件列表,启用 “Claudian”
备选:下载 Release 文件或源码构建
方式 A,手动获取 Release 三件套:
- 从项目最新 Release 下载
main.js、manifest.json、styles.css三个文件 - 在知识库的
.obsidian/plugins/目录下新建claudian文件夹 - 把三个文件复制进该文件夹
- 在 设置 → 社区插件 中启用 “Claudian”
方式 B,从源码构建(想先体验开发版时选它):
cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build首次启动:如何打开侧边栏
打开方式有两种:点击左侧功能区里的 Claudian 图标,或从命令面板调用对应命令。打开后右侧出现对话区,可以直接开始第一轮对话:
⚠️ 报 spawn claude ENOENT / Claude CLI not found 怎么办
症状:提示spawn claude ENOENT或Claude CLI not found。
原因:Claudian 没能自动检测到 Claude Code CLI。如果你在用 nvm、fnm、volta 这类版本管理器切换 Node 环境,最容易碰到这个问题。
处理:
- 先保持设置里对应项为空,让插件自动检测
- 仍失败时,找到 CLI 的实际路径,手动填入 设置 → 高级 → 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只是旧版 Claude Code npm 包的遗留回退。
替代思路:在 设置 → 环境 → 自定义变量 里,把 Node.js 的 bin 目录加入 PATH。
CLI 和 Node.js 不在同一目录
症状:用 npm 装过 CLI,却仍提示找不到。
排查:分别运行下面两条命令,对比结果
dirname $(which claude) dirname $(which node)原因:两者路径对不上时,Obsidian 这类 GUI 应用会因环境不同而定位不到 Node.js。
处理:
- 改用原生二进制安装(推荐)
- 或在 设置 → 环境 中补上 Node.js 路径,例如
PATH=/path/to/node/bin
上手建议
Claudian 可以简单理解为“给 Claude Code 在知识库里安了个常驻工位”。第一次跑,建议先装社区版、把一轮对话聊通,再决定要不要玩源码构建;遇到 CLI 检测问题时,先用which claude(Windows 用where.exe claude)确认真实路径再填设置。
想深入看实现的话,相关源码在这里:聊天功能源码、内联编辑源码、设置页源码。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考