Obsidian + Claude（十）

10.Obsidian + Claude

在 Obsidian 里集成 AI 编码助手，可以直接在笔记编辑器中完成写文档、整理知识、调用技能、AI 热点推送等任务，不用在笔记软件和终端间来回切换。Claudian 插件（即 Obsidian 版的 Claude Code）是实现这个集成的关键。

一、环境安装与配置

1. 安装 Obsidian

2. 全局安装 Claude Code CLI

npm install -g @anthropic-ai/claude-code

安装后执行一次 claude，按提示登录并完成 OAuth 授权（只需一次）。

  • 如果没有 Claude 账号，也可以用国内大模型替代。
  • Claude Code 全局安装后，才能被 Obsidian 中的 Claudian 插件调用。

3. 安装社区插件：Claudian

Claudian 是 Obsidian 的第三方插件，将 Claude Code CLI 直接嵌入 Obsidian 侧边栏，支持内联编辑、技能调用，无需在笔记本和终端之间频繁切换。

  • 下载插件文件：从 GitHub Release 获取 main.js​、manifest.json​、styles.css。

  • 创建插件目录：

    vault/.obsidian/plugins/claudian/

  • 复制文件：将三个文件放入上述目录。

  • 启用插件：Obsidian 设置 → 第三方插件 → 关闭安全模式 → 启用 Claudian。插件随后显示在左侧功能区。

4. 配置模型

  • 进入 设置 → Claudian。
  • 填写 API Key 等信息（Anthropic API 或兼容厂商）。插件界面还可以直接切换中文。
  • 配置完成后，侧边栏会出现 Claudian 机器人的聊天窗口，对话框支持 ​/​ ​（调用 Skills/斜杠命令）和 ​@​ （提及文件或目录）。

二、核心使用场景

1. 内联编辑

选中笔记中任意段落，按下快捷键调出 Claudian，直接输入修改指令（如“把这段改得更口语化”或“补充一个 Python 示例”），AI 会在原文基础上进行单词级别的差异预览和改写，不需要反复复制粘贴。

效果总结：Obsidian 仍是完全本地、完全离线可用的 Markdown 编辑器，而 Claude Code 扮演一个“协作伙伴”，数据始终保留在 Markdown 文件中，不会被任何第三方平台锁定。

2. 斜杠命令与技能（Skills）

在 Claudian 对话框输入 ​/​ ，可以调用预设的提示词模板或 Skill（技能）。一个 Skill 类似于一个可复用的“工作指令包”，包括“生成周报”“整理读书笔记”“批量导出会议纪要”等，一个指令就能让 AI 自动扫描指定文件夹、整理内容并汇总成一篇新笔记。

3. @ 提及文件 / MCP 服务器

  • ​ ​@文件名​：将某个笔记文件内容作为上下文传递给 AI，让它在回答问题或改写时充分参考相关笔记。
  • MCP（Model Context Protocol） ：通过标准协议连接外部工具（数据库、格式转换器、同步服务等），支持在 Claudian 对话中执行更复杂的批处理操作。

4. 规划模式（Shift+Tab 切换）

  • 开启规划模式后，AI 会先输出一个执行方案（比如“我计划分三步整理这些笔记：先扫描目录、再提取标题、最后生成汇总表”），用户确认无误后，才会真正执行写入/修改操作，避免大规模误修改。

5. 指令模式（#）

  • 在对话框中输入 #​ 后跟自定义指令（如 #每次回复必须使用中文），可以临时改变 AI 的回复风格或行为，不需要修改全局配置。

6. 多标签页与对话历史

  • Claudian 支持多聊天窗口、对话分叉、历史恢复等功能，适合同时处理不同项目的讨论或查询。

三、典型进阶用例

批量导出与批量整理

Claudian 插件最实用的高阶功能之一是自然语言驱动的批量操作：

场景 自然语言指令示例 AI 行为
批量导出项目文档 “请帮我将所有项目文件夹中的文档整理并导出” 自动扫描项目结构 → 提取关键信息 → 生成统一汇总文档
周报自动生成 “整理所有会议记录并生成周报” 提取会议待办、关键决策，格式化为结构化周报
学习笔记系统化 “批量整理学习笔记，自动生成知识图谱” 读取笔记 → 发现关联关系 → 输出可视化的知识图或分类手册
日志/日记分析 “分析我的日记中常出现的任务类型” 扫描特定文件夹的日记内容 → 生成统计分析或待办看板

关键点：无需编写脚本，用自然语言描述要求，AI 自动调用 文件读取、模式匹配（GLOB）、批量写入、内容搜索 等一系列底层工具来完成。

四、替代方案概览

方案 特点 安装复杂度 适用人群
Claudian 直接把 Claude Code 内置到 Obsidian 侧边栏，支持 /​ 命令、@ 提及、内联编辑、规划模式、Skills 等完整功能 中等（手动下载文件） 追求原生 Obsidian + Claude Code 深度融合的深度用户
Agent Client 与 Claudian 类似的侧边栏 AI Agent 插件，支持 Claude Code / Qwen Code / Codex，更强调“让 AI 作为思考催化剂”，可以自动分析笔记盲点、推荐阅读、整理卡片笔记等 中等 更关注“用 AI 推动知识发掘和跨领域联想”的知识工作者
obsidian-notes-mcp 通过 MCP 协议把整个 Vault 作为工具提供给 Claude Code，支持全量 CRUD、搜索、批量操作、周期性笔记等 18 种工具 一行命令（需先安装 Local REST API 插件） 希望从 Claude Code 终端 直接管理 Obsidian 笔记，且极度在意 token 消耗的开发型用户
Clausidian (CLI) 提供了 44+ MCP 工具 + /obsidian skill 的 CLI 工具，支持笔记创建、检索、反向链接查询、合并、归档等 55+ 子命令 轻量（npm install -g clausidian） 习惯用终端 + Claude Code 直接操作 Vault 的开发者

一句话总结：Claudian 将 Claude Code 的 AI 能力直接嵌入 Obsidian 侧边栏，实现了“笔记就是上下文、AI 就是协同编辑器”的体验。你可以用自然语言写文档、改笔记、调度批量任务，甚至构建自动化的知识工作流，所有数据仍然保留在本地 Markdown 文件中，完全离线安全可控。