把 Claude Code 接入 Obsidian:Claudian 插件 5 分钟配置指南
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
Claudian 是一款把 Claude Code、Codex 这类 AI 编码助手嵌入 Obsidian 知识库的插件。你的笔记文件夹就是 AI 的工作目录,文件读写、搜索、bash 命令都就地完成。这篇教程写给想在 Obsidian 里用 AI 的人。
装完之后三个实际用得上的场景
笔记里选中的文字直接改写:划出一段,触发行内编辑,AI 改完给出逐词前后对比,确认即生效。输入框敲@,能把知识库文件、子代理、MCP 服务器拉进对话当上下文。敲/或$调出存好的提示模板,生成发布说明这类重复动作一句话办完。
安装准备:环境要求清单
要求不高,桌面版 Obsidian 加一家提供商的 CLI 就够。
| 组件 | 要求 | 说明 |
|---|---|---|
| Obsidian | v1.13.0+ | 仅桌面端,移动端装不了 |
| 操作系统 | macOS / Windows / Linux | 只有桌面版可用 |
| Claude Code CLI | 已安装并登录 | 走你本人的订阅或 API |
| 其他 CLI | 可选 | Codex、Grok、Opencode、Pi 等 |
只用一家提供商的话,装对应那一个 CLI 即可,不必全家桶。
从 Obsidian 社区插件市场安装:5 步走通
社区市场是最快的路,下面 5 步 1-2 分钟能走完。
- 打开 Obsidian 设置(左下角齿轮图标)。
- 左侧菜单点社区插件,处于限制模式的话先打开开启社区插件。
- 点浏览进入插件市场。
- 搜索框输入
Claudian,找到后点安装。 - 回到插件列表,把 Claudian 的开关打开。
想锁定某个版本,从发布页下载main.js、manifest.json、styles.css三个文件放进.obsidian/plugins/claudian/,重启 Obsidian 再启用即可。想改源码的话,在插件目录执行git clone https://gitcode.com/GitHub_Trending/cl/claudian,然后npm install、npm run build,做法相同。
确认插件跑通了:3 步验证
右侧出现 AI 面板,链路就通了。
- 点 Obsidian 左侧竖条上的插件图标;或命令面板(
Ctrl+P/Cmd+P)搜「Claudian」,选打开聊天的命令。 - 面板上方滚动着 AI 的思考与操作记录,下方是输入框和模型选择器。
- 发一句「列出我仓库根目录下的文件」,能看到文件列表回显就通了。
常见报错:问答式速查
提示spawn claude ENOENT是怎么回事?
插件找不到 Claude Code 的安装位置,nvm、fnm 这类版本管理器最容易把路径藏起来。先把设置里的 Claude CLI 路径留空让它自动检测;仍不行就在终端跑which claude(Windows 用where.exe claude),把结果填进设置 → 高级 → Claude CLI 路径。
终端能跑,为什么插件说找不到 Claude CLI?
多半是 npm 装的claude和node分在两处,GUI 应用够不着 Node 运行时。用dirname $(which claude)和dirname $(which node)对比一下路径;要么改用原生二进制版 Claude Code,要么在设置 → 环境 → 自定义变量里补上 Node.js 路径。
Codex、Opencode 等功能为什么用不了?
最常见原因是没装对应 CLI。装好后确认终端能直接调用,重启 Obsidian 检查环境变量;仍不行就升级插件到最新版。
手机上能用吗?
不能。它只支持桌面端,移动 Obsidian 用不了。
装好之后深入玩的三个方向
把重复动作存成技能。常做生成发布说明、整理引用格式这类事,存成技能后一句话调用,模板支持用户级和知识库级两种范围。挂 MCP 服务器。在设置里接上外部数据源和工具,AI 就能超出知识库文件本身,实现在 src/shared/settings/。换一家提供商。输入框的模型选择器就能切换,会一点 Node 的话,src/providers/ 是理解各提供商适配架构的入口。
现在就发一句「列出我仓库根目录下的文件」,看 AI 在你知识库里干活的第一现场。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考