前言

如果你和我一样，日常用 Obsidian 管理知识库，又习惯了 Claude Code 那种「Agent 直接操作文件」的爽感，那你大概率想过一个问题：

能不能把 Claude Code 塞进 Obsidian，让 AI 直接在我的笔记库里干活？

最近 GitHub 上一个叫 Claudian 的项目做到了这件事。12,300+ Star，619 次提交，38 个 Release——社区热情相当高。

一句话概括：Claudian 是一个 Obsidian 插件，它将 AI 编码代理（Claude Code、Codex 等）嵌入你的知识库，让你的笔记直接变成 AI 的工作目录。

Claudian 是什么？

一个将 AI 编码代理嵌入 Obsidian 知识库的插件。你的知识库成为代理的工作目录——文件读写、搜索、bash 和多步骤工作流全部开箱即用。

通俗讲：Claudian 在 Obsidian 侧边栏里跑了一个完整的 AI Agent。这个 Agent 能：

  • 读取和编辑你的笔记（带 diff 预览）
  • 搜索整个知识库
  • 执行 bash 命令
  • 调用 MCP 工具
  • 分步骤完成复杂任务（计划 → 审核 → 执行）

本质上，它把一个终端里的 Claude Code 搬到了 Obsidian 的 UI 层，并且深度集成了 Obsidian 的知识库体系。

核心功能拆解

1. 聊天侧边栏（Chat Sidebar）

最直观的功能。打开侧边栏，和 AI 对话，它会直接操作你的知识库：

用户：「帮我把所有关于『密集成交区』的笔记整理到一个新文件夹，并生成索引。」
Agent：扫描知识库 → 找到相关笔记 → 移动文件 → 创建索引页 → 完成

对话支持多标签页，可以同时进行多个任务互不干扰。

2. 内联编辑（Inline Edit）

选中一段文字，快捷键触发，AI 直接在当前笔记中编辑。最亮眼的是词级 diff 预览——你可以逐词对比 AI 改了什么再决定接受。

原文：Claudian 是一个非常强大的 Obsidian 插件
AI 改：Claudian 是一个极为强大的 Obsidian 插件
      ^旧 | ^新 （diff 高亮对比）

3. 斜杠命令与技能（Slash Commands & Skills）

输入 / 触发可复用的提示模板。支持用户级别和知识库级别的自定义技能，相当于给 AI 预设了一组「快捷键」。

比如你可以建一个 /daily-note 技能，一键让 AI 帮你生成每日复盘报告。

4. @提及（@Mention）

输入 @ 可以提及以下内容让 Agent 处理：

提及类型 用途
@文件名 指定某个笔记文件
@子代理名 调用已配置的子代理
@MCP服务器 调用外部 MCP 工具
@外部目录 引用知识库外的文件

这个设计很巧妙——把「上下文」显式化，让 AI 知道你要处理什么。

5. 计划模式（Plan Mode）

Shift+Tab 切换。Agent 先探索和设计方案，提交给你审批后再执行。不会像无头苍蝇一样乱改你的笔记。

6. MCP 服务器支持

支持 stdio、SSE、HTTP 三种协议连接外部 MCP 工具。这意味着 Claudian 的 AI 可以调用你已有的 MCP 生态——数据库查询、API 调用、外部搜索等等。

支持的 AI 后端

Claudian 的设计很灵活，不绑定单一 AI 提供者：

提供者 说明
Claude Code 主力，需要 Claude Code CLI
Codex CLI OpenAI 的开源编码代理
Opencode 来自 opencode.ai 的代理
Pi 来自 earendil-works 的开源代理

对于已经装了 Claude Code CLI 的用户，开箱即用。Codex 用户也能无缝接入。

技术架构一览

项目完全用 TypeScript 构建（97.5%），代码结构清晰：

src/
├── core/           # 提供者无关的运行时、注册表、类型契约
├── providers/      # Claude、Codex、Opencode、Pi 适配器
├── features/       # 聊天、内联编辑、设置 UI
├── shared/         # 可复用 UI 组件
├── i18n/           # 10 种语言国际化
└── style/          # 模块化 CSS

架构设计值得学习：core 层定义统一接口，providers 层各自实现适配。新增一个 AI 后端，只需在 providers 下加一个适配器即可。

安装方式

方式一：Obsidian 社区插件（推荐）

  1. Obsidian → 设置 → 社区插件 → 浏览
  2. 搜索 Claudian → 安装 → 启用
  3. 确保系统已安装 Claude Code CLI

方式二：手动安装

# 进入知识库插件目录
cd <你的知识库>/.obsidian/plugins/

# 下载最新 release
# main.js + manifest.json + styles.css

# 放入 claudian/ 文件夹，启用插件

前置条件

  • Obsidian v1.7.2+
  • Claude Code CLI（或其他支持的 AI 后端）
  • Claude 订阅或兼容 API（Openrouter、Kimi 等也可）

Claudian 能干什么？几个实际场景

场景一：知识库整理

「把过去三个月的所有日记按周归档，每周一个文件夹，文件名统一为 YYYY-MM-DD-主题.md」

Agent 扫描日记 → 按周分组 → 创建文件夹 → 移动文件 → 重命名。手动做要半小时，AI 一分钟搞定。

场景二：跨笔记研究

「找出我所有笔记中关于『量化交易』的内容，汇总成一篇文章，标注来源笔记名称。」

Agent 搜索全库 → 提取相关段落 → 汇总排版 → 生成文件。比手动搜索+复制粘贴高效太多。

场景三：代码项目辅助

如果你在 Obsidian 里放代码片段或项目文档：

「这个项目里所有 API 接口整理成一个接口文档，包含路径、方法、参数说明。」

Agent 扫描代码 → 识别接口 → 生成文档。把你的笔记库当项目用。

隐私与数据

Claudian 的隐私设计比较透明：

  • 发送到 API 的数据：用户输入 + 附加文件 + 图片 + 工具调用输出
  • 本地存储：vault/.claudian/、vault/.claude/、~/.claude/projects/
  • 没有遥测信标，不跑后台网络请求（除了 AI 提供者和 MCP 端点）

数据流向清晰，可控性较好。

我的评价

亮点：

  1. 深度集成 Obsidian——不是简单的 API 对话窗口，而是真正让 Agent 操作知识库
  2. 多后端支持——不锁死 Claude，Codex/Pi/Opencode 都能用
  3. 计划模式 + Diff 预览——给了用户足够的控制权和安全感
  4. 开源、MIT 协议——随便用、随便改
  5. 代码架构清晰——如果自己想做类似插件，参考价值很高

需要注意的点：

  1. 需要 Claude Code CLI 或等效后端，有一定门槛
  2. 仅限桌面端，移动端不支持
  3. API 调用会产生费用（取决于使用的 AI 提供者）
  4. 项目迭代快，功能还不算完全稳定

总结

Claudian 解决了一个真实痛点：AI 编码代理和知识管理的融合。

过去我们用 Obsidian 记笔记，用 Claude Code 写代码——两个世界，泾渭分明。Claudian 把它们打通了。你的笔记库存不再是静态文档，而变成了 AI 可以直接操作的工作空间。

对于重度 Obsidian 用户 + AI 使用者来说，这个插件值得一试。

GitHub: https://github.com/YishenTu/claudian
Star: 12,300+ | License: MIT | Language: TypeScript

封面图：/img/claudian.jpg