Claudian 快速上手:3 分钟把 Claude Code 装进你的 Obsidian 笔记库
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
让 AI 帮你写东西,最烦的往往是交接环节:从终端里复制答案,贴进笔记,再手动整理格式。Claudian 是一个把 Claude Code、Codex 等编程智能体直接嵌进 Obsidian 笔记库的插件,它把这一步交接省掉了——AI 直接读你的笔记、把结果写回笔记,全程在侧边栏和编辑器内可见。
为什么不再单独开终端
这一节你要带走的是一个关键点:Claudian 省时间,不是让 AI 更聪明,而是让"交接"这一步消失。在终端里,AI 不知道你笔记放在哪,得手动复制文字、指定路径;装好 Claudian 后,整个库的根目录就是它的工作文件夹,读、写、搜索、跑命令都发生在库里面。
可以把它理解成一位读遍了你所有文档的合作者:你只是把办公室门打开,它查资料、改文稿,每处改动都留下可逐词检查的差异记录。
开箱即得
- 读写库内任意笔记、新建文件
- 全库文本搜索,几百篇笔记里定位一句话
- 执行 bash 命令、跑多步长任务
- 各智能体(Claude Code、Codex、Grok 等)配置与历史互相独立
边界在哪
- 只做文件级操作,不替你解读笔记含义
- 仅限桌面端(macOS / Linux / Windows),移动端不可用
Claudian 插件安装教程:两条路线、三个前置条件
读完这一节,插件就在你库里装好并启用了,你还能记住安装前必须备齐的 3 个条件。
3 个前置条件,缺一个插件都跑不起来:
- 装好至少一个智能体 CLI:Claude Code、Codex、Grok、OpenCode、Pi,五选一
- 有该智能体对应的订阅或 API 额度
- Obsidian 版本不低于 1.13.0
路线一:社区插件市场(3 次点击)
- 设置 → 社区插件 → 浏览
- 搜索 "Claudian",点击安装
- 回到插件列表里启用它
路线二:源码构建(3 条命令)
想尝鲜最新版,自己克隆构建,一共 3 行:
git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian && npm install && npm run build构建完成后,把产物放进你库的.obsidian/plugins/claudian/目录,重启 Obsidian 即可。
注意:插件主文件已超过 5MB,超出 Obsidian Sync 的同步限制,Sync 不会帮你传。多台电脑用 Sync 的,每台分别安装更新。
第一次对话:从哪开、说什么、报错看哪 💬
这一节给你第一次回复,外加最常见的"找不到 CLI"报错的两步修法。
入口有两处:左侧边缘的 ribbon 小图标,或命令面板里搜插件名。点开就是聊天侧边栏。第一句话可以试试:
打开当前这篇笔记,用三句话总结我的观点,再列出 5 个可以补充的论据。
如果报spawn claude ENOENT或 "Claude CLI not found",十有八九是 PATH 问题:图形界面版的 Obsidian 看不见你用 nvm、volta 装的 CLI。两步解决:
- 确认安装位置:macOS / Linux 执行
which claude,Windows 执行where.exe claude - 在 设置 → 高级 里手动填入 CLI 路径;Windows 请用原生 .exe,避开 .cmd 包装
| 系统 | 定位命令 | 路径示例 |
|---|---|---|
| macOS / Linux | which claude | /Users/you/.volta/bin/claude |
| Windows | where.exe claude | C:\Users\you\AppData\Local\Claude\claude.exe |
Claudian 功能速查表:7 项日常能力,多数一个符号触发 ✍️
这一节给你的是一张随身速查表:记住符号就知道功能,不用翻菜单。
| 功能 | 触发方式 | 它帮你做什么 |
|---|---|---|
| 行内编辑 | 选中文字按热键 | AI 原地修改,词级 diff 预览,不满意一键回退 |
| 提示词模板 | 输入框敲/ | 可复用模板,写一次反复用 |
| 技能 Skills | 输入框敲$ | 调用用户级或库级技能,团队可共享 |
| @ 提及 | 输入框敲@ | 把库内文件、文件夹喂给 AI 当素材 |
| 指令模式 | 输入/instruction | 给本次对话追加"家规",AI 照规矩办事 |
| MCP 服务器 | 沿用各智能体原生 CLI 配置 | 接外部工具,配置零学习成本 |
| 多标签页 | 侧边栏新建标签 | 并行处理不同任务,历史互不干扰 |
行内编辑的整个弹窗实现在 src/features/inline-edit/,想调热键或弹窗行为先去那里看;命令和技能的发现、存储与运行时加载则统一归 src/core/providers/commands/ 管理。另外还有个实验性的 Collab Mode,能和别的 Claudian 用户协作共享项目,需要本机装好 Git。
权限规则:先划边界,再放心放手 🔐
这一节给你一套"免审批清单"的设置思路:高频安全命令放行,碰库的操作每次通知你。
规则支持两类匹配:
- bash:精确命令或显式通配符,比如
git *、npm:* - 文件读写:按路径前缀匹配,只放行指定目录
匹配逻辑就写在 src/core/security/approvalRules.ts 里,是个几分钟能读完的短文件。推荐组合:git *免审批;一切文件写入设为每次确认。这样让 AI 跑长流程时,你不用盯着它会不会越界。
最可能被问到的 5 个问题
这一节把安装前后最容易卡住的 5 个问题一次讲清,每条回答不超过三行。
Q:需要联网和付费吗?需要。你的对话内容、附件文件会发往你选择的提供方,对应订阅或 API 额度要自备。
Q:笔记会被偷偷传走吗?不会。无遥测信标、无后台自动联网,只有你发起请求或主动调用已配置的 MCP 端点时才联网。
Q:能接国产模型吗?能。OpenRouter、Kimi、GLM、DeepSeek 等兼容 Claude Code 协议的服务都可用,界面内置含简繁中文在内的 10 种语言。
Q:多个智能体能共存吗?能。各自在设置里独立配置,聊天历史互不干扰,随时切换。
Q:为什么 Sync 不同步插件?主文件超过 5MB,超出官方 Sync 上限,需要在每台桌面设备上分别安装更新。
今天就试这个任务
最后给你一个可以立刻发出去的任务,用来验证整条链路是否跑通。
装好后,随便打开一篇长笔记,选中第一段按行内编辑热键让它润色一次——词级 diff 预览是你最先该感受到的东西。或者直接在侧边栏发一条多步任务:
找出所有提到"第三季度计划"的笔记,汇总成一份周报大纲,写入一个新文件。
想翻源码的话:src/core/ 是跨所有智能体的统一运行时与权限层,src/providers/ 下每个目录对应一个智能体的适配层。看完这两个目录,整个项目的骨架就清楚了。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考