Claudian 安装指南 · Windows & Mac

✦

插件简介

Claudian 是什么？

Claudian 将 Claude Code CLI 的完整 Agent 能力嵌入 Obsidian，让你的 Vault 成为 Claude 的工作目录。它可以读写文件、执行 Bash 命令、多步骤工作流，甚至支持 MCP 服务器和自定义 Agent。

📂

文件读写

在 Vault 内自由读写、搜索文件

💻

Bash 执行

执行终端命令，完整 CLI 能力

🔗

MCP 支持

连接外部工具与数据源

✏️

内联编辑

选中文字，直接在笔记中 AI 编辑

⚙

前提条件

安装前请确认以下环境

🤖

Claude Code CLI

必须提前安装，推荐 Native Install

🟣

Obsidian v1.8.9+

Desktop 版本，移动端不支持

🔑

Claude 订阅

Pro/API Key 或兼容 Anthropic 格式的第三方服务

💻

操作系统

Windows · macOS · Linux（仅桌面端）

↓

安装步骤

从 GitHub Release 安装（推荐）

01

下载 Release 文件

前往 GitHub Releases 最新版本，下载以下三个文件：

main.js
manifest.json
styles.css

02

创建插件文件夹

在你的 Vault 目录下，创建如下路径的文件夹，并将三个文件放入：

你的Vault路径/.obsidian/plugins/claudian/
├── main.js
├── manifest.json
└── styles.css

03

在 Obsidian 中启用插件

打开 Obsidian → 设置 → 第三方插件 → 关闭「安全模式」→ 在列表中找到 Claudian → 开启

⚠

首次使用需要关闭「安全模式」才能加载第三方插件。

04

配置 Claude CLI 路径

进入 Claudian 插件设置 → Advanced → Claude CLI path，填入 CLI 的绝对路径（见下方平台说明）。

💡

BRAT 自动更新：如果希望自动跟进新版本，可从社区插件安装 BRAT，添加仓库地址 YishenTu/claudian，BRAT 会自动管理更新。

🪟

Windows 平台配置

特别注意事项

1

确认 Claude CLI 路径

在 PowerShell 或命令提示符中执行：

PowerShell

where.exe claude

将输出的路径填入 Claudian 插件设置 → Advanced → Claude CLI path。

2

使用 .exe，避免 .cmd

Windows 上 Obsidian 作为 GUI 程序无法正常调用 .cmd 包装脚本，必须指定 claude.exe。

# ✅ 正确（Native 安装）
C:\Users\你的用户名\AppData\Local\Claude\claude.exe

# ✅ 正确（npm 安装，使用 cli.js）
C:\Users\你的用户名\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\cli.js

# ❌ 避免使用
claude.cmd

3

PowerShell 执行策略

若遇到脚本执行被阻止，以管理员身份运行 PowerShell 并执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

🍎

macOS 平台配置

特别注意事项

1

确认 Claude CLI 路径

在终端执行：

Terminal

which claude

将输出路径填入 Claudian 插件设置 → Advanced → Claude CLI path。

2

创建插件文件夹（终端方式）

Terminal

mkdir -p "/path/to/vault/.obsidian/plugins/claudian"
cp main.js manifest.json styles.css "/path/to/vault/.obsidian/plugins/claudian/"

3

Node 版本管理器用户注意

使用 nvm、fnm、volta 等工具安装 Claude Code 时，Obsidian 作为 GUI 应用可能无法读取 shell 环境变量，导致找不到 Node.js。

⚠

在插件设置 → Environment → Custom variables 中手动添加 Node.js 的 bin 路径：

PATH=/path/to/node/bin:$PATH

检查 claude 与 node 是否在同一目录：

dirname $(which claude)
dirname $(which node)

🔧

常见问题

Troubleshooting

⚠ spawn claude ENOENT / Claude CLI not found

插件无法自动检测到 Claude 安装位置。常见于使用 Node 版本管理器（nvm/fnm/volta）的情况。

解决方法：在 Claudian 插件设置 → Advanced → Claude CLI path 中填写完整路径。

平台	命令	示例路径
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.js

⚠ npm CLI 与 Node.js 不在同一目录

GUI 应用（Obsidian）可能找不到 Node.js。推荐使用 Native 安装方式，或在插件 Environment 设置中手动添加 Node.js bin 目录路径。

⚠ 插件列表中没有出现 Claudian

请确认：① 安全模式已关闭；② 三个文件（main.js、manifest.json、styles.css）均已正确放入 .obsidian/plugins/claudian/ 文件夹；③ 重启 Obsidian 后再尝试。