Claudian | 一文跑通 ClaudianObsidian AI 助手安装避坑与功能全解【免费下载链接】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 等 AI 编码助手直接嵌入你的知识库——你的 vault 即助手的工作目录文件读写、搜索、bash 命令与多步骤工作流开箱即用。本文面向刚接触 Claudian 的 Obsidian 用户覆盖环境自检、三条安装路径、常见报错修复与数据隐私边界目标是让你少走弯路、一次装对。安装环境自检动手前先过一遍清单 在开始安装前逐项确认以下条件可以避免安装后出现大部分报错。Obsidian 版本 ≥ 1.13.0版本过低时社区插件无法加载 Claudian见 manifest.json 中的minAppVersion声明。仅支持桌面端macOS、Linux、Windows 可用移动端不在支持范围。至少安装一个 AI 助手运行时harnessClaude Code CLI、Codex CLI、Grok Build、OpenCode 或 Pi 任选其一。可用的订阅或 API 密钥例如 Anthropic、OpenAI 或 OpenRouter、Kimi、GLM、DeepSeek 等兼容提供商。Git 已安装仅 Collab 协作模式需要不参与协作可跳过。源码开发场景需要 Node.jspackage.json中声明的版本要求为24 25。常见误区以为装好插件就能用。Claudian 本身不含模型能力它负责调用你本机已装好的 CLI 和订阅缺少 CLI 或密钥时插件无法发起对话。三条安装路径社区插件、手动放置与源码构建方式一Obsidian 社区插件市场推荐打开 Obsidian → 设置 → 社区插件 → 浏览Browse。搜索 Claudian点击 安装Install。在已安装列表中启用Enable插件。验证左侧边栏出现 Claudian 图标点击打开聊天面板即为成功。方式二手动放置三个文件到插件目录适合无法访问插件市场、或需要固定版本的用户。从 Claudian 的发布页面下载main.js、manifest.json、styles.css三个文件。在你的知识库下定位插件目录/path/to/vault/.obsidian/plugins/。新建子文件夹claudian把三个文件全部放入claudian/中。重启 Obsidian设置 → 社区插件 → 启用 Claudian。方式三源码克隆构建开发向把仓库克隆进插件目录并进入仓库cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian npm install npm run build在 Obsidian 中启用插件设置 → 社区插件 → 启用 Claudian。开发阶段可用npm run dev开启监听模式改动后自动重新构建。首次运行排障CLI 找不到的最快修复 首次运行只走一条最小路径打开聊天面板 → 输入一句话 → 让助手只读一个 vault 内文件。能正常返回说明环境就绪。现象一spawn claude ENOENT或Claude CLI not found原因Obsidian 这类 GUI 应用继承的 PATH 与你终端不同自动检测找不到 CLI。使用 nvm、fnm、volta 等 Node 版本管理器时尤其常见。解决步骤先把设置中的 CLI 路径留空让 Claudian 尝试自动检测。检测失败时在终端定位可执行文件并在 设置 → 高级 → Claude CLI 路径 中手动填写。备选方案在 设置 → 环境 → 自定义变量 中把 Node.js 的 bin 目录加入 PATH。验证重启 Obsidian重新发起一次对话不再出现该报错即修复成功。各平台定位命令对照平台命令示例路径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.cjs注意Windows 上不要填.cmd或.ps1包装器。原生安装填claude.exe包管理器安装填cli-wrapper.cjscli.js仅作为旧版 npm 包的遗留回退。现象二终端能用Obsidian 里找不到 Node原因npm 安装的 CLI 与 Node.js 不在同一环境GUI 应用解析不到 Node。用下面两条命令对比即可确认dirname $(which claude) dirname $(which node)解决步骤优先改为安装原生二进制推荐。或在 设置 → 环境 中追加PATH/path/to/node/bin。验证两个路径指向同一环境目录或设置中已显式声明 Node 路径后Obsidian 内发起对话正常。七大核心功能速览 首次跑通后按下面的高频用法逐项体验即可。内联编辑选中文字或把光标放到任意位置按热键直接在笔记中改写并附带词级差异预览。斜杠命令与技能输入/或$调用用户级和 vault 级的可复用提示模板。 提及输入引用 vault 文件、文件夹与协作成员变更#引用协作工单。指令模式/instruction从聊天输入中追加精炼后的自定义指令。MCP 服务器通过各助手原生 CLI 管理的 MCP 配置接入外部工具。多标签与会话管理单面板模式支持多标签双面板模式提供常驻会话管理器。协作模式实验性与其他 Claudian 用户在共享项目上协同相关实现见 src/app/collab/。数据与隐私什么上传、什么留在本地Claudian 没有遥测信标网络活动只发生在你显式发起的运行时工作、已配置的 MCP 端点和回答请求所必需的 SDK/CLI 调用中。类别具体内容上传到 API你的输入、附加文件、图像与工具调用输出默认目的地为 AnthropicClaude或 OpenAICodexGrok 走 xAI也可通过提供商设置与环境变量改向本地留存Claudian 设置与会话元数据在vault/.claudian/Claude 提供商文件在vault/.claude/成绩单在~/.claude/projects/Claude与~/.codex/sessions/Codex环境继承提供商子进程继承 Obsidian 进程环境与你在 Claudian 中配置的变量用于 CLI 认证、代理、证书与 PATH 解析补充两点每台设备的 CLI 路径使用存于浏览器本地存储的不透明本地密钥而非系统主机名协作模式下项目 Git 数据与认证协调元数据只在受邀成员的设备间走局域网不经过任何云端中转。常见报错速查表⚠️ 遇到下列报错时按表处理即可覆盖绝大多数场景。报错信息可能原因解决方法spawn claude ENOENT/Claude CLI not foundGUI 应用 PATH 与终端不一致或 CLI 未安装先留空自动检测失败则在 设置 → 高级 手动填 CLI 路径或在 设置 → 环境 中补 PATHWindows 上填了.cmd/.ps1路径仍报错包装器不被 GUI 应用直接执行改用claude.exe或cli-wrapper.cjs的真实路径终端正常、Obsidian 内报找不到 Nodenpm CLI 与 Node.js 目录不一致安装原生二进制或在 设置 → 环境 中设置PATH/path/to/node/bin启用插件后聊天面板无任何响应未安装任何 harness CLI 或缺少 API 密钥安装 Claude Code、Codex 等 CLI 之一并配置对应订阅或密钥后续支持完整的提供商安装与配置说明以仓库根目录的 README.md 为准贡献规范见 CONTRIBUTING.md。遇到本文未覆盖的问题或有功能建议直接向项目提交 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），仅供参考