把 Claude Code 接入 Obsidian:Claudian 插件 5 分钟配置指南
2026/9/11 2:23:56 网站建设 项目流程

把 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 就够。

组件要求说明
Obsidianv1.13.0+仅桌面端,移动端装不了
操作系统macOS / Windows / Linux只有桌面版可用
Claude Code CLI已安装并登录走你本人的订阅或 API
其他 CLI可选Codex、Grok、Opencode、Pi 等

只用一家提供商的话,装对应那一个 CLI 即可,不必全家桶。

从 Obsidian 社区插件市场安装:5 步走通

社区市场是最快的路,下面 5 步 1-2 分钟能走完。

  1. 打开 Obsidian 设置(左下角齿轮图标)。
  2. 左侧菜单点社区插件,处于限制模式的话先打开开启社区插件
  3. 浏览进入插件市场。
  4. 搜索框输入Claudian,找到后点安装
  5. 回到插件列表,把 Claudian 的开关打开。

想锁定某个版本,从发布页下载main.jsmanifest.jsonstyles.css三个文件放进.obsidian/plugins/claudian/,重启 Obsidian 再启用即可。想改源码的话,在插件目录执行git clone https://gitcode.com/GitHub_Trending/cl/claudian,然后npm installnpm run build,做法相同。

确认插件跑通了:3 步验证

右侧出现 AI 面板,链路就通了。

  1. 点 Obsidian 左侧竖条上的插件图标;或命令面板(Ctrl+P/Cmd+P)搜「Claudian」,选打开聊天的命令。
  2. 面板上方滚动着 AI 的思考与操作记录,下方是输入框和模型选择器。
  3. 发一句「列出我仓库根目录下的文件」,能看到文件列表回显就通了。

常见报错:问答式速查

提示spawn claude ENOENT是怎么回事?

插件找不到 Claude Code 的安装位置,nvm、fnm 这类版本管理器最容易把路径藏起来。先把设置里的 Claude CLI 路径留空让它自动检测;仍不行就在终端跑which claude(Windows 用where.exe claude),把结果填进设置 → 高级 → Claude CLI 路径。

终端能跑,为什么插件说找不到 Claude CLI?

多半是 npm 装的claudenode分在两处,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),仅供参考

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

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

立即咨询