Claudian插件安装教程:Obsidian里接入AI编码助手的3种方式
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
想让 Claude Code 或 Codex 直接在你的 Obsidian 库里干活——读笔记、改文件、跑命令,就需要 Claudian 插件。它把知识库变成 AI 助手的工作目录,装好就能用:多标签对话、计划模式、@提及、行内编辑都支持。适合把桌面版 Obsidian 当主力工作台、又想顺手调用 AI 编码能力的写作者和开发者。
安装前准备:系统与依赖清单
动手前先确认环境和工具都在位:
| 类别 | 要求 | 说明 |
|---|---|---|
| 必需 | Obsidian v1.7.2+ | 桌面版,版本不能太旧 |
| 必需 | 桌面操作系统 | macOS、Windows、Linux 均支持 |
| 必需 | Claude Code CLI | 需 Claude 订阅、API 或兼容提供商 |
| 可选 | Codex CLI | OpenAI 的命令行编码工具 |
| 可选 | Opencode | 另一款 AI 编码助手 |
| 可选 | Pi | Pi AI 助手 |
⚠️ Claudian 目前只覆盖桌面端 Obsidian,手机端用不了。 插件本身不内置 AI 能力,它调用的是你机器上对应提供商的 CLI 工具。
Claudian插件的3种安装方式
三条路径按投入成本排序:
- 社区插件市场:新手首选,两步装完
- 手动安装:不依赖市场,拷 3 个文件进插件目录,最通用
- 开发者构建:从源码编译,适合想尝鲜或二次开发的人
手动安装:拷贝3个文件
- 从项目发布页下载最新版本,包里应有
main.js、manifest.json、styles.css这 3 个文件 - 在库的插件目录里新建
claudian文件夹,位置固定:/你的知识库路径/.obsidian/plugins/claudian/ - 把 3 个文件全部拷进这个文件夹
- 重启 Obsidian,进入 设置 → 社区插件,打开 Claudian 的开关
社区市场安装:两步完成
- 打开 Obsidian,进入 设置 → 社区插件 → 浏览
- 搜索框输入 "Claudian",找到后点安装
- 回到已安装列表,把 Claudian 启用
整个过程不超过一分钟。
开发者构建:从源码打包
想跑最新提交或改代码就走这条路:
- 把仓库克隆到库的插件目录:
cd /你的知识库路径/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian - 装依赖并构建,2 条命令:
npm install npm run build - 到 设置 → 社区插件 里启用 Claudian
装完Claudian插件后第一眼看到什么
通过功能区图标或命令面板打开 Claudian 聊天侧边栏。左侧照常是你的笔记,右侧是 AI 交互面板:顶部是标题栏和会话操作按钮,中间按时间流展示每一轮操作——读取哪个文件、对文件做了什么编辑(改动会以 +18 / −1 这类行数差异标出)、以及 AI 的说明文字,底部是输入框,右下角能切换模型档位。
Claudian插件最常撞的3个坑
npm装的CLI调不动怎么办
现象:插件本身没问题,但就是调不起 Claude 命令。
根源:用 npm 装的时候,claude和node往往不在同一目录,GUI 应用启动时可能找不到 Node.js。
修复:先跑两条命令对比位置——
dirname $(which claude) dirname $(which node)目录不一致时,要么换成原生二进制版安装(推荐),要么在 设置 → 环境 → 自定义变量 里补上 Node.js 的路径。
Claude CLI找不到怎么办
现象:启动时报spawn claude ENOENT或Claude CLI not found。
根源:插件自动探测 CLI 位置失败,用 nvm、fnm、volta 这类 Node 版本管理器的用户最容易中招。
修复:先把设置里的 Claude CLI 路径留空,交给自动检测;还不行就手动找路径——macOS/Linux 终端跑which claude,Windows 命令提示符跑where.exe claude,再把结果填进 设置 → 高级 → Claude CLI路径。
其他提供商功能不全
现象:Codex、Opencode、Pi 等提供商的部分能力缺失。
根源:这几家提供商的适配还在迭代,存在平台兼容性差异。
修复:确认对应 CLI 已装好、环境变量配对了,剩下的等版本更新补齐即可。
继续深挖Claudian源码
整个代码库按"核心运行时 + 提供商适配 + 界面功能"分层:
src/ ├── main.ts # 插件入口 ├── core/ # 与提供商无关的核心运行时 ├── providers/ # 各 AI 提供商的适配器 ├── features/ # 界面功能模块 └── style/ # 样式文件- 聊天功能:侧边栏界面、标签页、消息渲染都在这
- 内联编辑:选中文字后的 AI 编辑与差异预览
- 提供商适配层:Claude、Codex、Grok、Opencode、Pi 各自的接入实现
下一步可以按这条路线走:先用/和$摸清快捷命令 → 接入一个 MCP 服务器试试外部工具 → 把重复流程存成自定义技能 → 切换计划模式体验"先出方案、批准再动手"的工作流。
Claudian 把 Obsidian 从笔记软件变成了 AI 的工作台。把 CLI 装好、挑一条安装路径走完,剩下的在对话里就能学会。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考