Claudian 插件安装与 Claude Code 配置指南

Claudian 插件安装 & Obsidian 中 Claude Code 配置指南

零、为什么要用 Claudian + CLI 模式？

解决的核心痛点

配置一次，到处复用。

你在终端装好 Claude Code CLI 后，Obsidian 这边只需要填个路径就能直接用，不需要重复配置 API Key、不需要额外付费、不需要重新授权。两套工具共用同一个 Claude 实例，一套授权管到底。

为什么推荐 CLI 模式而不是 API Key 模式

	CLI 模式（推荐）	API Key 模式
账号授权	登录一次，长期有效	每次需要填入 API Key
费用	订阅制，不额外按 token 计费	按 token 消耗扣费
配置成本	填一个路径即可	要管理 Key、额度、计费
权限控制	本地文件系统直连，可读写	受 API 权限和额度限制

在 Obsidian 里用 Claude Code 的三个便利点

不切环境，笔记即工作区
直接在 Obsidian 里对当前笔记提问、让 AI 帮你整理、改写、补充，不需要切到终端再切回来。你的知识库就是 Claude 的工作目录。
引用笔记、链接上下文
Claude 可以直接读取你的整个 Obsidian vault，跨笔记查找信息、建立关联。比如你问"我上周关于 DDD 的记录在哪"，它能直接搜到并给你答案。
沉淀 AI 协作记录到笔记
每次和 Claude 的对话可以直接留在笔记中，形成你的"AI 协作日志"。后续回溯不需要翻聊天记录，笔记本身就是完整的上下文。

适用人群

已经在用 Obsidian 做知识管理的人
已经订阅了 Claude Code 的人
想在不离开笔记环境的前提下调用 AI 能力

一、Claudian 插件安装

结论

Claudian 未上架 Obsidian 官方社区插件商店，需要通过以下方式安装。

方案 1：BRAT 自动安装（首选，最简单）

打开 Obsidian → 设置 → 第三方插件（社区插件）
关闭安全模式
浏览插件，搜索 BRAT → 安装、启用
打开 BRAT 设置 → 点击 Add Beta Plugin
仓库地址粘贴：yishentu/claudian
点 Add Plugin，等待自动下载安装完成
回到第三方插件列表，找到 Claudian ，直接开启即可

二、Claudian 核心配置（Claude Code CLI 模式）

打开 Claudian 插件设置 → 找到 Advanced（高级）

只需填一项：Claude CLI Path（claude 可执行文件路径）

各系统查找路径命令

Windows（PowerShell）：

csharp 复制代码

where.exe claude

复制返回的完整路径（例：C:\Users\XXX\AppData\Local\claude\claude.exe）

Mac / Linux：

bash 复制代码

which claude

重点：不需要填任何 Anthropic API Key！

因为你用的是本地 Claude Code CLI 自带的账号授权，不是 API 调用模式。

三、Obsidian 中 Claude 插件报错排查

经验：把报错信息直接粘贴给 Claude CLI 终端

遇到报错不要猜，直接把完整报错信息粘贴到 Claude Code 终端里让 AI 分析。

Claude Code 的优势是它能直接读你的文件系统、执行命令、定位真实路径，比搜索引擎更高效。

实际操作示例

复制 Obsidian 中的完整报错信息
打开终端，运行 claude 进入 Claude Code 交互模式
把报错粘贴进去，补充一句背景，例如：

"Obsidian 的 Claude 插件报这个错，帮我排查一下"
Claude Code 会：
- 自动运行 where claude 等命令定位真实路径
- 对比插件期望的路径和实际安装路径的差异
- 给出精确的配置修改建议

为什么这个方法好用

方式	耗时	准确度
搜索引擎查报错	5~15 分钟，需要自己判断哪个方案适用	中等
问 Claude CLI	1~3 分钟，直接结合你的环境给出答案	高

心法：遇到环境相关报错，先问 AI 终端，再查文档。

vbnet 复制代码

Error: Claude Code native binary not found at C:\Program Files\nodejs\claude.
Please ensure Claude Code is installed via native installer or specify a valid
path with options.pathToClaudeCodeExecutable.

问题原因

插件默认找的路径 C:\Program Files\nodejs\claude 是一个 shell 脚本 （不是 .exe），而插件需要的是原生二进制文件。

通过 where claude 确认实际安装位置：

makefile 复制代码

C:\Program Files\nodejs\claude          ← shell 脚本（不是插件要找的）
C:\Program Files\nodejs\claude.cmd      ← cmd 批处理文件

真正的 .exe 在 npm 全局安装目录下的 bin 文件夹中。

解决方法

在 Obsidian 的 Claude 插件设置里，把 options.pathToClaudeCodeExecutable 设为：

java 复制代码

C:\Program Files\nodejs\node_modules@anthropic-ai\claude-code\bin\claude.exe

四、常见检查清单

检查项	说明
Claude Code 已安装	终端运行 `claude --version` 确认
插件路径指向 `.exe`	不要指向 `.cmd` 或 shell 脚本
不需要 API Key	CLI 模式使用本地账号授权
代理配置（如需）	按文档配置代理确保网络通畅