Claudian Obsidian 插件零配置上手：3 步把 Claude Code 接进你的知识库
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
Claudian 是一款 Obsidian 插件，把 Claude Code、Codex 等 AI 编程助手直接嵌进你的知识库。笔记文件夹就是它的工作目录，文件读写、搜索、bash 命令开箱即用，10 分钟跑通。
场景速览：Claudian 插件能替你干什么 🔍
当你选中一段文字想改写时，它可以原地生成新版并给出逐词的前后差异。当你想让某篇笔记、子代理或 MCP 服务器参与对话时，输入@就能拉进来。当你想让 AI 先想清楚再动手，按Shift+Tab切到计划模式，经你批准后才执行。
动手前自查：Claudian 安装前环境对表 📋
| 项目 | 要求 | 备注 |
|---|---|---|
| Obsidian | v1.13.0+ | 以插件manifest.json为准 |
| 操作系统 | macOS / Windows / Linux | 仅桌面版，移动端不支持 |
| AI CLI | Claude Code / Codex / OpenCode / Pi 任选其一 | 需已安装并登录，用你自己的订阅或 API |
| Git | 可选 | 仅 Collab 协作模式需要 |
最容易忽略的限制：Claudian 是桌面专用插件，手机端装不了；且必须先在终端里能直接调用至少一个 AI CLI。
主路径上手：Claudian 一键安装步骤 🚀
推荐走社区插件市场，全程点选：
- 打开 Obsidian 设置页（左下角齿轮），点社区插件。
- 若处于限制模式，先打开开启社区插件。
- 点浏览，搜索框输入
Claudian。 - 点安装，装完回到插件列表。
- 打开 Claudian 的开关，完成启用。
手动安装发布包
适合走不了市场、或想锁定某个具体版本的人。从发布页下载main.js、manifest.json、styles.css三个文件，放进知识库.obsidian/plugins/claudian/目录，重启 Obsidian 后在社区插件里启用。
源码开发者构建
适合想跑主分支最新功能、或打算改代码的人。
- 在
.obsidian/plugins/目录执行git clone https://gitcode.com/GitHub_Trending/cl/claudian。 - 进入
claudian目录，执行npm install装好依赖。 - 执行
npm run build生成插件文件，重启 Obsidian 并启用。
跑通自检：4 项确认插件真的在工作 🧪
- 点左侧竖条的 Claudian 图标，或用
Ctrl+P搜「Claudian」打开聊天面板 - 右侧出现 AI 面板，上方有模型选择器，可实时滚动思考与操作记录
- 输入「列出我仓库根目录下的文件」并发送
- 面板回显出知识库根目录的真实文件列表
看到文件列表回显，整条链路就算通了。
翻车急救：Claudian 常见报错速查 🛠️
spawn claude ENOENT
- 症状：发消息后提示找不到 Claude CLI。
- 根因：nvm、fnm 这类版本管理器把路径藏起来，GUI 应用够不着。
- 解法：先把设置里的 Claude CLI 路径留空让它自动检测；仍不行就在终端跑
which claude（Windows 用where.exe claude），把路径填进设置 → 高级 → Claude CLI 路径。
终端能跑、插件提示找不到 CLI
- 症状：终端里
claude正常，插件却报找不到。 - 根因：npm 装的 CLI 和
node分在两处，GUI 拿不到 Node 运行时。 - 解法：用
dirname $(which claude)和dirname $(which node)对比路径；不一致就改用原生二进制版 Claude Code，或在设置 → 环境 → 自定义变量里补上 Node.js 路径。
Codex、OpenCode 等功能用不了
- 症状：切到对应提供商无响应或报错。
- 根因：该提供商的 CLI 没装，或环境变量对 GUI 不可见。
- 解法：装好对应 CLI 并确认终端可直接调用，重启 Obsidian；仍不行就升级到最新版插件。
装完不是终点 ⚙️
挖内置命令和技能：/后跟提示模板，$后跟可复用技能。重复做的事——生成发布说明、整理引用——存成技能，下次一句话调用。
接 MCP 服务器：设置里挂上 MCP 服务器，AI 就能访问外部数据源和工具。相关实现在 src/shared/settings/。
换第二家 AI 提供商：适配器结构统一，输入框里切模型即切换提供商。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），仅供参考
