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

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

解决的核心痛点

配置一次，到处复用。

你在终端装好 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 未上架 Obsidian 官方社区插件商店，需要通过以下方式安装。

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

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

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

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

各系统查找路径命令

Windows（PowerShell）：

 
    
    
       
       where.exe claude 
      
 复制返回的完整路径（例：C:UsersXXXAppDataLocalclaudeclaude.exe）

Mac / Linux：

 
    
    
       
       which claude

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

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

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

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

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

实际操作示例

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

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

为什么这个方法好用

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

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

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

问题原因

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

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

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

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

解决方法

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

 
     
    
        
        C:Program Files  
        odejs

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