Claudian 是一个 Obsidian 插件,可将 Claude Code、Codex 等 AI 编程代理嵌入笔记库中,让整个 vault 成为代理的工作目录,支持文件读写、搜索、内联编辑和多轮对话等功能。
隐私方面做了明确约束:不会运行任何遥测数据收集,网络请求严格限制在你主动发起的工作、配置的 MCP 端点和必要的 SDK 调用范围内。
所有设置和会话数据存在笔记库本地的隐藏文件夹里。你输入的提示词、附加的文件和工具调用输出只会发给你配置的 API 端点。
能干什么
最基础的用法是侧边栏对话。点功能区图标或者用命令面板打开聊天侧边栏,AI 能直接读写、编辑和搜索你的笔记文件。支持多标签页,历史记录会保存,会话可以克隆、恢复和压缩。
内联编辑更直接。选中一段文字或者在光标位置用快捷键,AI 直接在笔记内部改,改完给你一个词汇级别的差异预览,方便你逐字核对。计划模式按 Shift+Tab 切换,AI 在正式动笔之前会先探索和设计方案,把计划展示给你,等你批准了再执行。
输入 / 或 $ 能调出快捷提示词模板或预设技能,输入 @ 能让 AI 定向处理特定对象,比如某个笔记文件、子代理、MCP 服务器或者外部目录的文件,输入 # 可以在聊天框里加更细粒度的自定义指令。MCP 方面,Claude 在插件内管理,Codex 用自己的 CLI 管理配置。
怎么装
推荐直接在 Obsidian 社区插件市场搜 Claudian 安装启用。也可以从 GitHub Releases 下载三个文件手动放进 .obsidian/plugins/claudian/ 目录,或者克隆仓库用 npm install 和 npm run build 自己编译。
要求 Obsidian v1.7.2 以上,支持 macOS、Linux 和 Windows。
使用时需要 Claude 的订阅或 API,或者用 Openrouter、Kimi 等兼容第三方。可选支持 Codex CLI、Opencode 和 Pi。
一个常见的坑是用了 Node 版本管理器时插件可能找不到 Claude CLI,可以在高级设置里手动指定路径,Windows 用户尽量直接用 claude.exe 或 cli-wrapper.cjs。
项目由开发者 YishenTu 创建,主要用 TypeScript 写,由贝壳找房及 MOMA 团队赞助维护,MIT 协议开源,目前 13k Star。
项目地址:https://github.com/YishenTu/claudian
夜雨聆风