Claudian安装教程:把Claude Code嵌进Obsidian,10分钟跑通第一条命令
【免费下载链接】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插件。安装启用后,你的vault就是agent的工作目录,你能在侧边栏聊天里直接让它读写笔记、执行命令、跑多步任务。
🧩 让AI直接上手你的笔记
你想让AI整理一堆散落的笔记,却卡在这里:AI碰不到vault里的文件,只能靠你在两个窗口之间复制粘贴。Claudian把当前vault设为agent工作目录,把这道墙拆掉了。
| 能力 | 一句话说清 | 什么时候用 |
|---|---|---|
| Inline Edit | 选中文本直接在笔记里改写,带单词级差异预览 | 想让AI就地修改某段文字 |
| Slash Commands & Skills | 用/或$调用可复用的提示模板 | 经常重复下达同类指令 |
@mention | @引用知识库文件和文件夹,#引用工单 | 需要AI精确引用某份内容 |
| MCP Servers | 通过各agent原生CLI的MCP配置接入外部工具 | 需要给agent扩展工具集 |
| 多标签与Session管理 | 单面板多标签,或侧边常驻会话面板双栏 | 并行管理多个对话 |
| Collab Mode(实验) | 与其他Claudian用户协作共享项目 | 和队友一起处理同一个项目 |
📦 确认环境,选择路径
先确认前置条件:已安装Claude Code CLI、Codex CLI、Grok Build、OpenCode、Pi中至少一个,并有对应的订阅或API密钥;Obsidian v1.13.0+,仅支持桌面版(macOS、Linux、Windows);Collab Mode额外要求Git。
| 方式 | 难度 | 大约耗时 | 适合谁 |
|---|---|---|---|
| Obsidian社区插件 | 低 | 2分钟 | 普通用户,装完即用 |
| 从源代码克隆 | 中 | 10分钟 | 要体验最新功能或参与开发 |
推荐走社区插件,全程不用碰终端。
⚡ 社区插件三步安装
- 打开Obsidian,进入设置 → 社区插件 → Browse。
- 搜索Claudian,点击Install,再点击启用——看到开关变绿即成功。
- 确认左侧ribbon出现Claudian图标,说明安装完成。
如果你还没装Claude Code CLI,先完成CLI安装再启用,Claudian会自动检测。
从源代码安装:把仓库克隆到vault的plugins文件夹,装依赖并构建,然后在Obsidian里启用插件。
cd /path/to/vault/.obsidian/plugins git clone https://gitcode.com/GitHub_Trending/cl/claudian cd claudian && npm install && npm run build🔍 装完验证与侧边栏初体验
点击ribbon上的Claudian图标(或在命令面板里搜索Claudian)打开聊天侧边栏,发送"总结当前这篇笔记"。看到agent读取文件并返回摘要,说明链路已全部打通。
打开侧边栏后,可以直接选中一段文字试试Inline Edit,体会单词级差异预览的效果。
🩹 两个高概率卡点
1.spawn claude ENOENT或Claude CLI not found
- 现象:发消息时报CLI找不到。
- 原因:GUI应用通过PATH找不到CLI,用nvm、fnm、volta等Node版本管理器时最常见。
- 动作:先保持CLI路径设置为空让Claudian自动检测;失败则用下表命令查到路径,填入设置 → 高级 → Claude CLI path。
| 平台 | 检查命令 | 示例结果 |
|---|---|---|
| macOS/Linux | which claude | /Users/you/.volta/bin/claude |
| Windows(原生) | where.exe claude | C:\Users\you\AppData\Local\Claude\claude.exe |
| Windows(npm) | npm root -g | {root}\@anthropic-ai\claude-code\cli-wrapper.cjs |
Windows上避免使用.cmd和.ps1包装器:原生装用claude.exe,包管理器装用cli-wrapper.cjs。
2. npm安装的CLI与Node.js不同目录
- 现象:终端里CLI能跑,Obsidian里却调不起来。
- 原因:GUI应用不继承终端环境,CLI找不到Node.js。
- 动作:执行下面两条命令对比路径,不一致就改装原生二进制,或在设置 → 环境 → 自定义变量里补上Node路径(如
PATH=/path/to/node/bin)。
dirname $(which claude) dirname $(which node)📚 继续往下挖
- src/:源码根目录,聊天、内联编辑、设置各占一个模块
- src/features/chat/:侧边栏聊天实现,含标签页、控制器与渲染器
- src/features/inline-edit/:内联编辑弹窗与provider侧编辑服务
- CONTRIBUTING.md:贡献指南,提issue或PR前先读
侧边栏能读写你的vault之后,下一篇要改写的笔记就交给agent去跑吧——现在就可以发一句"总结这篇笔记"试试。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考