什么是 Claudian？

Claudian 是一个将 Claude Code 集成到 Obsidian 的强大插件，让 AI 助手直接在你的笔记库中工作。

核心功能

1. 全自动文件管理（Agentic Mode）

不同于普通 AI 插件只能修改当前笔记，Claudian 允许 Claude 在整个笔记库中穿梭：

• 批量重组笔记 – “帮我把所有关于’建筑工程’的笔记整理到一个文件夹”
• 跨文件重构 – 同时读取 A 笔记、修改 B 笔记、在 C 笔记生成总结
• 自动打标签/分类 – 根据内容自动补全 YAML 属性或添加标签

2. 强大的上下文感知

精准理解你的”第二大脑”状态：

• @ 提及功能 – 输入 @ 直接引用笔记、文件夹、图片
• 选区操作 – 选中文字直接提问，支持一键替换（Diff 预览）

3. 执行终端命令

集成 Claude Code，可在 Obsidian 内部运行指令：

• 执行脚本 – 运行 Python/JS 脚本处理笔记（格式转换、数据统计）
• Git 集成 – 通过对话直接提交笔记到 GitHub
• 自定义技能 – 编写特定技能，如”搜索最新规范并更新笔记”

4. 接入 MCP 协议

支持 Model Context Protocol (MCP)，可调用外部工具：

• 连接 Google Calendar
• 搜索实时网页
• 读取本地数据库

前置要求

⚠️ 必须先安装 Claude Code CLI

验证 Claude Code 是否正常：

claude --version

如果未安装，请先参考 Claude Code 安装教程。

安装步骤

第 1 步：下载插件文件

访问 GitHub Release 页面： 👉 https://github.com/YishenTu/claudian/releases/latest

下载这 3 个文件：

• main.js
• manifest.json
• styles.css

第 2 步：创建插件文件夹

在 PowerShell 中执行：

mkdir -Force "G:\Obsidian Vault\Engineerli\.obsidian\plugins\claudian"

💡 将路径替换为你的 Obsidian 库路径

第 3 步：复制文件

手动复制或使用命令：

# 假设文件下载到了 Downloads 文件夹Copy-Item"$env:USERPROFILE\Downloads\main.js""G:\Obsidian Vault\Engineerli\.obsidian\plugins\claudian\"Copy-Item"$env:USERPROFILE\Downloads\manifest.json""G:\Obsidian Vault\Engineerli\.obsidian\plugins\claudian\"Copy-Item"$env:USERPROFILE\Downloads\styles.css""G:\Obsidian Vault\Engineerli\.obsidian\plugins\claudian\"

验证文件：

ls"G:\Obsidian Vault\Engineerli\.obsidian\plugins\claudian"

应该看到：

main.jsmanifest.jsonstyles.css

第 4 步：在 Obsidian 中启用

1. 打开 Obsidian
2. 点击左下角 ⚙️ 设置
3. 左侧菜单 → 第三方插件 (Community plugins)
4. 如果提示「安全模式」→ 点击 关闭安全模式
5. 点击 刷新 按钮
6. 在插件列表中找到 Claudian → 打开开关启用

⚠️ 如果看不到，完全退出 Obsidian 再重新打开

第 5 步：配置 Claude Code 路径

获取 Claude Code 路径：

where claude

会输出类似：

C:\Users\engin\AppData\Roaming\npm\claude.cmd

在 Obsidian 中配置：

1. 设置 → 左侧找到 Claudian
2. 找到 Client Path（或 Claude CLI Path）
3. 粘贴上面获取的路径
4. 保存

第 6 步：配置环境变量（关键！）

在 Claudian 设置页面找到 Environment 部分，添加：

ANTHROPIC_AUTH_TOKEN=testANTHROPIC_BASE_URL=http://127.0.0.1:3456NO_PROXY=127.0.0.1DISABLE_TELEMETRY=trueCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

💡 这些配置让 Claudian 走本地 Router，避免网络限制

使用指南

基本操作

在 Obsidian 侧边栏会出现 🤖 机器人图标，点击打开对话面板：

• 直接输入中文对话
• 能读取当前打开的笔记
• 能跨文件搜索和编辑

快捷方式

实用场景

场景 1：批量整理笔记

帮我把所有带 #工程 标签的笔记整理到 "02-Areas/工程应用" 文件夹

场景 2：跨文件总结

@项目A @项目B @项目C 帮我生成一份综合项目报告

场景 3：自动打标签

分析当前笔记内容，自动添加合适的标签和 YAML 属性

场景 4：Git 操作

帮我提交今天修改的所有笔记到 GitHub，commit 信息为"更新工程笔记"

完整文件结构

G:\Obsidian Vault\Engineerli\├── .obsidian/│   └── plugins/│       └── claudian/│           ├── main.js│           ├── manifest.json│           └── styles.css├── CLAUDE.md          ← AI 配置文件├── 你的笔记.md└── ...

常见问题

Q: 插件启用后没反应？A: 完全退出 Obsidian 再重新打开。确认 Claude Code 已正常安装。

Q: 提示找不到 Claude CLI？A: 检查 Client Path 是否正确。运行 where claude 重新获取路径。

Q: 无法连接到 Claude？A: 检查环境变量配置是否正确。确认本地 Router 正常运行。

Q: 如何更新插件？A: 下载最新版本的 3 个文件，覆盖原文件，重启 Obsidian。

Q: 插件会修改我的笔记吗？A: 所有修改都会先预览（Diff），需要你确认后才会应用。

注意事项

⚠️ 重要提醒

1. Claudian 依赖 Claude Code 正常运行
2. 先确认终端里 claude 命令能正常启动
3. 环境变量配置必须正确
4. 首次使用建议在测试笔记上试验

相关资源

• Claude Code 安装教程
• Claude Code + Git 日常操作
• Obsidian 插件推荐
• Claudian GitHub

整理完成: 2026-02-24原文来源: N8N 笔记