← 返回目录

Claudian

社区

非标准 Server

在 Obsidian 库中集成 Claude Code、Codex 等编码智能体

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 95 / 438
Stars: ★ 15.9k 非常热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 今天

62FMRS · C

Claudian 是一个文档完善、持续维护(MIT 许可、有赞助支持)的 Obsidian 插件,可在库内承载多种 AI 编码智能体 CLI;它作为客户端使用 MCP 服务器,而非自身对外暴露 MCP 工具,因此不适用服务器端工具列表或 install_config。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

14/20

文档质量

15/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: README 描述了聊天、内联编辑、斜杠命令、MCP 连接等功能,并给出了较细的目录结构,但未提供服务器清单(manifest 未缓存),也没有展示任何单元测试、集成测试或 CI 工作流的证据。声称的工具行为(读写文件、bash、多步工作流)无法从静态材料中验证是否与实现一致,错误处理和依赖的可控性也未见描述。按照静态校准规则,缺乏可执行证据只能给出较低分数。
安全与权限 13/20: 隐私说明部分较为透明,声明无遥测、仅在用户请求时联网,并列出数据流向(发送给 Anthropic/OpenAI/xAI 等提供商)。架构目录中出现 core/security(审批工具)以及 Plan Mode(先规划后执行并需批准),显示存在危险操作确认机制的设计意图。但该插件本质上赋予 AI 代理对整个 vault 的文件读写和 bash 执行能力,README 未详细说明默认权限范围、是否默认需要人工确认每次工具调用,也未说明外部 MCP 服务器接入的凭据/密钥管理方式。证据不足以判定其达到最小权限和完全披露,故不能打满分,但也没有证据表明存在红线级问题(如硬编码密钥、隐蔽外传、无确认的破坏性默认行为)。
维护活跃度 14/20: 仓库未被存档,采用 MIT 许可证,并有独立的 CONTRIBUTING.md 贡献指南和明确的 PR 规范(说明问题、方案、验证方式,且不接受新增 provider 的 PR),显示有清晰的维护边界和治理意识。GitHub Release 徽章和社区插件下载统计表明有持续发布节奏。赞助方(Ke Holdings/BEIKE)说明有资源支持长期维护。但 README 中未见变更日志、安全响应渠道或依赖更新策略的具体说明,77 个开放 issue 未附带响应时效的证据。
文档质量 15/20: README 内容层次较丰富:功能介绍、安装步骤(社区插件与源码两种方式)、运行环境要求、详细的故障排查(CLI 未找到、PATH 冲突、Windows 特殊情况)、隐私数据流说明及架构目录树。这些覆盖了安装、依赖排错和数据边界等实用信息。但缺少具体的工具参数/接口文档(如 MCP 工具的输入输出 schema)、版本/变更记录、以及成本假设的量化说明(仅泛泛提及需要订阅或 API key),存在隐藏假设(如假定用户已具备 Node/CLI 环境经验)。
安装易用性 12/20: 通过 Obsidian 社区插件市场安装步骤简单(搜索、安装、启用),源码安装路径也给出了具体命令。但真正“可用”依赖外部 CLI(Claude Code/Codex/Grok/OpenCode/Pi)预先安装并可被 GUI 应用发现,README 用大段故障排查(spawn ENOENT、nvm/fnm 环境冲突、Windows .cmd/.exe 区分、PATH 与 Node.js 路径不一致)佐证了这一过程并不稳定,需要手动干预。缺乏任何自动化验证(CI、示例配置测试)证明这些步骤在多平台上真实可重复,按静态校准规则也不能给出较高分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

希望在库内获得 AI 编码智能体聊天与行内编辑功能的 Obsidian 用户
已经在使用 Claude Code、Codex 等 CLI、希望获得库感知访问能力的开发者
希望获得范围限定在库内的智能体辅助文件读写、搜索和多步骤工作流的笔记用户

不适合谁

寻找可为 MCP 客户端添加工具/资源的独立 MCP 服务器的用户——Claudian 是客户端/宿主,而非 MCP 服务器
Obsidian 移动端用户——该插件仅支持桌面端(macOS、Linux、Windows)
未安装任何受支持 CLI 执行环境(Claude Code、Codex、Grok Build、OpenCode 或 Pi)且没有可用 API/订阅提供商的用户

所需权限

对 Obsidian 库内文件的读/写/编辑权限(库即为智能体的工作目录)
通过底层 CLI 执行环境执行 Bash/Shell 命令的权限
访问所选 AI 提供商(Anthropic、OpenAI、xAI 或 OpenCode/Pi 的提供商)以及任何已配置 MCP 服务器端点的网络权限

风险与副作用

对库拥有较广的文件读写和 bash 执行权限,意味着行为异常或提示不当的智能体可能修改或删除笔记
输入内容、附加文件、图片和工具调用输出会发送给所选的第三方 API 提供商,敏感库内容可能因此离开本地设备
在插件内配置的 MCP 服务器属于额外的第三方端点,其可信度不受 Claudian 控制

安装接入

准备工作

运行环境：Node.js · 预编译二进制

推荐方式:在 Obsidian 中打开设置 → 第三方插件 → 浏览,搜索“Claudian”并安装,然后启用插件;也可从社区插件页面直接安装。开发方式:将仓库克隆到库的 .obsidian/plugins 目录下,运行 npm install 和 npm run build,然后在设置 → 第三方插件中启用“Claudian”。

验证是否装好

在 Obsidian 中安装并启用插件后，点击侧边栏图标或通过命令面板打开 Claudian 聊天面板；若能正常加载并选择 Claude Code/Codex 等 harness 且能对话并读写库内文件，即说明安装成功。

常见排障

若 CLI 未被自动检测到,先将 CLI 路径设置留空,再通过 which claude(macOS/Linux)或 where.exe claude(Windows)获取路径后手动填入设置 → 高级 → CLI 路径
在 Windows 上避免使用 .cmd/.ps1 包装脚本——原生安装使用 .exe,npm 安装使用 cli-wrapper.cjs
若 npm 安装的 CLI 与 Node.js 不在同一目录,Obsidian 等 GUI 应用可能找不到 Node——可在设置 → 环境中将 Node bin 目录加入 PATH,或改为安装原生二进制文件
确认 Obsidian 版本不低于 1.7.2 且运行在桌面端(macOS、Linux、Windows),因为 Claudian 仅支持桌面端

试试这样问

连接成功后，可以直接对 AI 助手这样说：

总结我这个笔记库中所有关于项目规划的笔记
把当前笔记里选中的段落改写得更简洁，并展示差异预览
在库中搜索所有提到季度目标的文件并列出它们的路径
为我整理一份本库中未完成任务清单

使用场景

在 Obsidian 笔记中直接与 Claude Code、Codex、Grok Build、OpenCode 或 Pi 聊天协作

通过带有逐词级差异预览的行内编辑功能,让 AI 智能体直接修改笔记文本

在与智能体对话中用 @提及库内文件、子智能体和 MCP 服务器

通过标签页或双栏会话管理器管理多个智能体聊天会话

详细介绍

Claudian 是一个开源的 Obsidian 插件(MIT 许可),将 Claude Code、Codex、Grok Build、OpenCode 和 Pi 等 AI 编码智能体作为协作者嵌入 Obsidian 库中。它把库变成智能体的工作目录,通过聊天侧边栏、行内文本编辑、斜杠命令和 @提及,支持文件读写、搜索、bash 执行和多步骤工作流。Claudian 本身并非 MCP 服务器,而是作为具备 MCP 能力的客户端,让 Claude Code 等执行环境可以通过 stdio、SSE 或 HTTP 在 Obsidian 内连接外部 MCP 服务器。