Claudian 避坑指南：把 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 等 AI 编码代理嵌入知识库，vault 即代理工作目录。装不上、报 spawn claude ENOENT、CLI 找不到，照手册排查即可跑通。
安装路径怎么选：市场、手动、源码三条路
先确认前置条件，三个缺一不可：
- Obsidian v1.13.0 及以上，仅支持桌面端（macOS / Linux / Windows）
- 已装至少一个代理 CLI：Claude Code CLI、Codex CLI、Grok Build、OpenCode 或 Pi
- 有对应订阅或 API 提供方（Anthropic、OpenAI，或 OpenRouter、Kimi 等）
方式一：社区插件市场（日常使用首选）
- 想直接可用：打开 设置 → 社区插件 → 浏览
- 市场里能搜到：输入 "Claudian"，点 Install
- 装完没反应：在列表里启用 "Claudian"
方式二：手动下载安装（市场搜不到或需要指定版本）
- 市场安装失败：从最新 release 页下载
main.js、manifest.json、styles.css三个文件 - vault 里没有插件目录：在
/path/to/vault/.obsidian/plugins/下建claudian文件夹 - 文件就位：把三个文件拷进去，在 Obsidian 设置 → 社区插件中启用 "Claudian"
方式三：源码构建（参与开发或改插件代码）
- 开发场景：克隆到插件目录
cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian- 首次构建：装依赖并打包，开发调试可改用
npm run dev监听模式
npm install npm run build- 构建成功：在 Obsidian 中启用 "Claudian"，提交代码前读 CONTRIBUTING.md
报错速查：spawn claude ENOENT 与 CLI 找不到路径
安装失败怎么办
症状：市场搜不到 "Claudian"，或安装按钮不可用。
原因：Obsidian 版本低于 v1.13.0，或连不上社区插件库。
解法：
- 先把 Obsidian 升到 v1.13.0+，重启
- 版本没问题就是网络原因，直接改用上面的手动下载方式
报 spawn claude ENOENT 或 Claude CLI not found
症状：侧边栏发起对话时报spawn claude ENOENT或Claude CLI not found。
原因：Claudian 自动检测不到 CLI。用 nvm、fnm、volta 这类 Node 版本管理器时最常见——GUI 应用读不到终端里配的 PATH。
解法：
- 先把 CLI 路径设置留空，让 Claudian 自动检测
- 仍找不到，用下表命令定位可执行文件，填进 设置 → 高级 → Claude CLI 路径
| 平台 | 命令 | 示例路径 |
|---|---|---|
| macOS / Linux | which claude | /Users/you/.volta/bin/claude |
| Windows（native） | 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 包的遗留回退。
替代方案：在 设置 → 环境 → 自定义变量 中，把 Node.js 的 bin 目录加进 PATH。
npm 装的 CLI 和 Node.js 不在同一目录
症状：终端里claude正常，Obsidian 里报找不到 Node.js。
原因：Obsidian 是 GUI 应用，继承不了终端的 shell 环境，两个可执行文件目录不一致时 Node 就找不到。
检查两条命令的输出：
dirname $(which claude) dirname $(which node)路径不同，二选一：
- 装原生二进制（推荐）
- 在 设置 → 环境 里补上 Node.js 路径：
PATH=/path/to/node/bin
功能速览：内联编辑、计划模式等高频操作的触发方式
- 内联编辑：选中文字或光标处 + 热键，直接在笔记里改，附词级差异预览
- 斜杠命令与技能：输入
/或$，调用用户级和知识库级的可复用提示模板与 Skills - @提及：输入
@，把知识库文件、子代理、MCP 服务器或外部目录文件指定给代理处理 - 计划模式：
Shift+Tab一键切换，代理先探索设计、提交计划供你批准再动手 - 指令模式：
/instruction，从聊天输入中追加自定义指令 - MCP 服务器：走各代理 CLI 原生 MCP 配置（stdio / SSE / HTTP）接外部工具
- 多标签与会话：单面板多标签，或双栏模式下聊天旁的常驻会话管理器，支持历史、分支、恢复、压缩
Codex、Grok、Opencode、Pi 等提供商也已支持，个别功能还在各平台验证中，遇到缺失直接提 issue。
数据去了哪：API、本地存储与遥测结论
- 发到 API 的：你的输入、附加文件、图像、工具调用输出；默认去向 Anthropic（Claude）或 OpenAI（Codex），可通过提供商设置与环境变量改配
- 本地存储：Claudian 设置与会话元数据在
vault/.claudian/；Claude 提供商文件在vault/.claude/；成绩单在~/.claude/projects/（Claude）与~/.codex/sessions/（Codex） - 环境变量：提供商子进程继承 Obsidian 进程环境 + 你在 Claudian 里配置的变量，CLI 鉴权、代理、证书、PATH 解析都靠它
- 设备特定路径：各设备的 CLI 路径用浏览器本地存储里的不透明本地密钥保存，不用系统主机名
- Collab 模式：显式托管或同步项目时，项目 Git 数据与协调元数据只在受邀队友设备的局域网内直传，不发往任何云端
- 遥测：无遥测信标，无后台活动。UI 轮询只读本地编辑器状态；网络活动限于显式的提供商调用、已配置的 MCP 端点和你主动发起的 Collab 任务
装好并排掉报错后，文件读写、bash 和多步工作流开箱即用，换个提供商只需在设置里切换。环境要求与更多配置见 README，功能请求或 bug 到仓库 issue 区反馈。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
