适合谁
- 希望在库内获得 AI 编码智能体聊天与行内编辑功能的 Obsidian 用户
- 已经在使用 Claude Code、Codex 等 CLI、希望获得库感知访问能力的开发者
- 希望获得范围限定在库内的智能体辅助文件读写、搜索和多步骤工作流的笔记用户
C
62FMRS · C
Claudian 是一个文档完善、持续维护(MIT 许可、有赞助支持)的 Obsidian 插件,可在库内承载多种 AI 编码智能体 CLI;它作为客户端使用 MCP 服务器,而非自身对外暴露 MCP 工具,因此不适用服务器端工具列表或 install_config。
Claudian 是一个开源的 Obsidian 插件(MIT 许可),将 Claude Code、Codex、Grok Build、OpenCode 和 Pi 等 AI 编码智能体作为协作者嵌入 Obsidian 库中。它把库变成智能体的工作目录,通过聊天侧边栏、行内文本编辑、斜杠命令和 @提及,支持文件读写、搜索、bash 执行和多步骤工作流。Claudian 本身并非 MCP 服务器,而是作为具备 MCP 能力的客户端,让 Claude Code 等执行环境可以通过 stdio、SSE 或 HTTP 在 Obsidian 内连接外部 MCP 服务器。
工具能力
暂未整理工具清单。
安装接入
推荐方式:在 Obsidian 中打开 设置 → 第三方插件 → 浏览,搜索“Claudian”并安装,然后启用插件;也可从社区插件页面直接安装。开发方式:将仓库克隆到库的 .obsidian/plugins 目录下,运行 npm install 和 npm run build,然后在 设置 → 第三方插件 中启用“Claudian”。
选型与风险
不适合谁
- 寻找可为 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 控制
常见排障
- 若 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 仅支持桌面端
使用场景
在 Obsidian 笔记中直接与 Claude Code、Codex、Grok Build、OpenCode 或 Pi 聊天协作
通过带有逐词级差异预览的行内编辑功能,让 AI 智能体直接修改笔记文本
在与智能体对话中用 @提及 库内文件、子智能体和 MCP 服务器
通过标签页或双栏会话管理器管理多个智能体聊天会话
支持客户端
暂未确认支持的客户端。