首页 / 开源热榜 / Claudian / 使用教程

Claudian 中文教程：在 Obsidian 中接入现有 Agent

更新于 2026-09-23 · 约 8 分钟

Claudian 是桌面版 Obsidian 插件。它把 Claude Code、Codex、Grok、OpenCode、Pi 等现有 Agent 放进侧边栏，让 vault 直接成为工作目录。它提供的是 Obsidian 内的入口和编辑体验，模型、账号与权限仍由你选择的 Agent 和 provider 决定。

当前版本：最新 Release、manifest.json 与 package.json 均为 2.3.3。最低 Obsidian 版本已升到 1.13.0，只支持 macOS、Linux、Windows 桌面端。只有源码构建才要求 Node.js 24（>=24 <25）。

1. 安装前准备

先安装并登录至少一个受支持的 Agent CLI，并准备相应订阅或 API provider。给 vault 做备份，再确认 Agent 能访问哪些目录、命令和 MCP 服务。GUI 程序找不到 CLI 时，常见原因是 PATH 没包含 nvm、fnm 或 volta 的路径。

2. 从 Community Plugins 安装

  1. 打开 Obsidian → Settings → Community plugins → Browse。
  2. 搜索 Claudian，点击 Install。
  3. 启用插件，从 ribbon 或命令面板打开聊天侧栏。
  4. 先选一篇测试笔记，让 Agent 做小改动并检查逐词 diff。

源码安装用于开发和审计，当前要求 Node 24：

cd /path/to/vault/.obsidian/plugins
git clone https://github.com/YishenTu/claudian.git
cd claudian
npm install
npm run build

3. 明确数据去了哪里

官方隐私说明写明：输入、附件、图片和工具调用输出会发给所选 provider。Claude、Codex、Grok、OpenCode、Pi 的目标服务可能不同；MCP 端点也由各 Agent 的原生 CLI 配置决定。Claudian 声明没有遥测或无请求的后台活动，但这不等于内容不会发给你主动选择的模型服务。

权限边界：vault 中可能有日记、客户材料和密钥。启用 Agent 前应排除敏感目录，限制 shell 与外部目录访问，并保留可恢复备份。逐词 diff 能帮助审阅单次编辑，不能替代版本控制和最小权限。

4. 多设备和 Collab 的额外条件

主插件因 Claude Agent SDK 等依赖已超过 5 MB，Obsidian Sync 不会同步主插件文件；每台桌面设备都要分别安装和更新。实验性的 Collab Mode 需要 Git。LAN 模式把 Git 数据和协调记录留在项目成员设备与指定 Host 之间；Cloud 模式则使用自行部署的 Claudian Cloud Server。

与直接使用 Claude Code 对比

Claude Code 官方支持终端、IDE、桌面和网页，直接围绕代码库工作。Claudian 复用 Claude Code 等现有 harness，把工作目录换成 Obsidian vault，并补上笔记内联编辑、@mention 和会话面板。主要写代码时直接用 Claude Code 路径更短；以 Markdown 笔记为中心并需要在 Obsidian 内审阅改动时，Claudian 更贴合。

验证状态：本轮只核对官方 README、Community Plugin 页面、2.3.3 Release、manifest.json 与 package.json；没有安装 Obsidian 插件、连接 Agent/provider、读取 vault、执行 npm install 或构建源码。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

适合在 Obsidian 中让既有编码 Agent整理、搜索和改写 Markdown 笔记，或对 vault 中的研究资料执行有审阅环节的多步任务。涉及私密资料、不可逆批量编辑或不可信命令时，应先备份并收紧 Agent 权限。

采用建议

如果日常知识工作集中在 Obsidian，同时已经在用受支持的 Agent CLI，Claudian 值得在备份后的测试 vault 试用。启用前先确认 provider 数据政策、CLI 权限和可执行命令范围；多设备用户还要分别维护插件版本。

原教程未展开的系统信息

核心功能

  • 会话与协作

    支持多标签、会话管理、临时 side chat，以及需要 Git 的实验性 Collab 模式。

架构与数据流

Obsidian 插件把 vault 路径交给已安装的 Agent harness，并通过 CLI、SDK 或本地 HTTP/ACP 适配不同 provider；MCP 仍由各 Agent 自己的配置管理。模型输入、附件和工具输出会发往用户选择的 provider，Collab 数据按 LAN 或自托管 Cloud 模式流转。

常见问题

Claudian 2.3.3 支持手机或平板版 Obsidian 吗？

不支持。manifest.json 明确标记 isDesktopOnly，官方列出的系统是 macOS、Linux 和 Windows。

安装 Claudian 插件必须先装 Node.js 24 吗？

从 Community Plugins 安装不需要。Node >=24 <25 是从源码安装依赖和构建当前仓库时的要求。

Claudian 会把哪些内容发给模型服务？

官方隐私说明列出用户输入、附件、图片和工具调用输出；目标由所选 Agent 与 provider 配置决定。

为什么 Obsidian Sync 没有把 Claudian 同步到另一台电脑？

官方说明主插件已超过 5 MB，Obsidian Sync 不同步该文件；每台桌面设备都要单独安装和更新。

官方来源：Claudian 仓库与 README、Releases、2.3.3、manifest.json、package.json、Community Plugin 页面；对比来源：Claude Code 官方文档。