Claudian 快速上手:3 分钟把 Claude Code 装进你的 Obsidian 笔记库
2026/9/20 9:09:33 网站建设 项目流程

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 个前置条件,缺一个插件都跑不起来:

  1. 装好至少一个智能体 CLI:Claude Code、Codex、Grok、OpenCode、Pi,五选一
  2. 有该智能体对应的订阅或 API 额度
  3. Obsidian 版本不低于 1.13.0

路线一:社区插件市场(3 次点击)

  1. 设置 → 社区插件 → 浏览
  2. 搜索 "Claudian",点击安装
  3. 回到插件列表里启用它

路线二:源码构建(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。两步解决:

  1. 确认安装位置:macOS / Linux 执行which claude,Windows 执行where.exe claude
  2. 在 设置 → 高级 里手动填入 CLI 路径;Windows 请用原生 .exe,避开 .cmd 包装
系统定位命令路径示例
macOS / Linuxwhich claude/Users/you/.volta/bin/claude
Windowswhere.exe claudeC:\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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询