首页 / AI Trending / YishenTu/claudian

claudian 是什么？

Claudian 是桌面版 Obsidian 的开源插件，把 Claude Code、Codex、Grok、OpenCode、Pi 等现有编码 Agent 放进 vault 侧边栏。vault 作为工作目录，Agent 可在用户授权下读写笔记、搜索文件、运行命令和执行多步任务。

⭐ 13,682 Stars 🍴 864 Forks TypeScript MIT 作者: YishenTu
来源：github.com/YishenTu/claudian 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

2.3.x 已加入临时 side chat、持续改进多 provider 会话与 Collab；旧稿所写的 Obsidian 1.7.2 已不适用。

来源：github.com/YishenTu/claudian；https://github.com/YishenTu/claudian/rel…

核心功能

多 Agent 侧边栏

在 Obsidian 内调用 Claude Code、Codex、Grok、OpenCode 或 Pi，并保留各 CLI 的 MCP 配置。

来源：github.com/YishenTu/claudian
笔记内联编辑

选中文本后可由 Agent 修改，并显示逐词 diff 供用户检查。

来源：github.com/YishenTu/claudian
会话与协作

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

来源：github.com/YishenTu/claudian

技术架构

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

来源：github.com/YishenTu/claudian；https://github.com/YishenTu/claudian/blo…

项目知识图谱

知识图谱：项目核心节点（中心）+ 核心功能（内环六边形）+ 关键技术依赖（外环 chip） @anthropic-ai/claude-agent-sdk@anthropic-ai/… @modelcontextprotocol/sdk@modelcontextp… CodeMirror sql.js ws 多 Agent 侧边栏 笔记内联编辑 会话与协作 claudian 项目本体 核心功能 关键依赖

技术栈

语言TypeScript框架Obsidian desktop plugin
关键依赖
@anthropic-ai/claude-agent-sdk@modelcontextprotocol/sdkCodeMirrorsql.jsws
基础设施 / 部署
Obsidian 1.13.0+ 桌面版；至少一个受支持 Agent CLI 与兼容订阅或 API provider；源码构建使用 Node >=24 <25
来源：github.com/YishenTu/claudian；https://github.com/YishenTu/claudian/blo…

快速上手

先安装并登录至少一个受支持的 Agent CLI，再在 Obsidian 的 Settings → Community plugins → Browse 搜索 Claudian，安装并启用。确认 vault 已备份，先在测试笔记上限制命令与外部目录权限。只有从源码构建时才需要 Node 24：进入 vault 插件目录克隆仓库，运行 npm install 与 npm run build。
来源：github.com/YishenTu/claudian；https://community.obsidian.md/plugins

使用场景

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

来源：github.com/YishenTu/claudian

优势与局限

优势

  • 把多种现有 Agent 接进同一 Obsidian 界面
  • 内联编辑带逐词 diff
  • 官方 README 明确列出数据流向且声明无遥测

局限

  • 只支持桌面版 Obsidian 1.13.0+
  • 必须另有受支持 Agent CLI 和可用 provider
  • 输入、附件及工具输出会发往所选 provider
  • 主插件超过 5 MB，Obsidian Sync 不能同步，需在每台设备分别安装更新
  • 本轮没有安装或运行插件
来源：github.com/YishenTu/claudian；https://github.com/YishenTu/claudian/blo…

最新版本

最新 GitHub Release 和 main 分支 manifest 均为 2.3.3，发布于 2026-09-22。当前最低 Obsidian 版本是 1.13.0；源码构建的 Node engines 是 >=24 <25。

来源：github.com/YishenTu/claudian/releases/tag/2.3.3；https://github.com/Yi…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对 YishenTu/claudian 官方 README、manifest.json、package.json、Community Plugin 页面与 Releases  |  limitations: 未安装 Obsidian 插件、未连接任何 Agent/provider、未读取 vault、未运行 npm install 或构建  |  observed_output: manifest 与 package.json 均为 2.3.3，minAppVersion 是 1.13.0 且 isDesktopOnly 为 true；源码构建 engines 为 Node >=24 <25

来源：github.com/YishenTu/claudian/blob/main/manifest.json；https://github.c…

同类项目对比

Claude Code 官方提供终端、IDE、桌面和网页入口，直接面向代码库；Claudian 不重新实现 Agent，而是把 Claude Code 等 harness 接进 Obsidian，让 vault 成为工作目录并增加笔记内联编辑、@mention 和会话面板。主要在终端写代码可直接用 Claude Code；需要围绕 Obsidian 笔记工作时 Claudian 更顺手。

来源：code.claude.com/docs/en/overview；https://github.com/YishenTu/claudian

总结评价

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

来源：github.com/YishenTu/claudian

常见问题

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 不同步该文件；每台桌面设备都要单独安装和更新。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新，请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料：README、GitHub API、依赖文件