Claudian 安装教程:3 步把 Claude Code 搬进 Obsidian 笔记库
【免费下载链接】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 编码助手直接嵌进你的笔记库,让库里的文件读写、搜索、命令执行和多步任务都发生在笔记旁边。它适合已经持有这些 AI 助手订阅、想让知识库参与 AI 协作、又不想在代码编辑器里来回切换的人。装好 CLI 工具之后,按下面 3 步就能跑起来。
动手前自检:缺一项就跑不起来
| 项目 | 要求 |
|---|---|
| Obsidian | 桌面版 v1.13.0 及以上(macOS / Linux / Windows,移动端不支持) |
| CLI 工具 | Claude Code、Codex、Grok、Opencode、Pi 至少装一个 |
| 账号 | 对应提供商的订阅或 API Key |
| Node 版本管理器 | 如果你用 nvm、fnm 装过 CLI,先记一下,排查报错会用到 |
| Git | 只用协作模式(Collab Mode)才需要 |
主安装流程:从社区插件市场走最快
- 打开 Obsidian,进入
设置 → 社区插件。 - 点「浏览」,搜索框输入Claudian,点「安装」。
- 装完回到列表,把插件「启用」。
- 侧边栏出现 Claudian 图标,点一下打开对话面板;建议重启一次 Obsidian。
市场里搜不到时的两条备选路径:
- 手动装:把发布版的
main.js、manifest.json、styles.css放进库的.obsidian/plugins/claudian/目录,然后重启 Obsidian。 - 源码装:进入库的
.obsidian/plugins目录执行git clone https://gitcode.com/GitHub_Trending/cl/claudian,再依次运行npm install和npm run build,最后在 Obsidian 里启用插件。
跑通验证:装完第一眼看到什么
装好就是这个样子:左边是你的笔记,右边是 AI 对话面板。面板顶部列出它读过的文件和改动的行数(+18 -1这种绿色红色标记),底部是输入框,模型切换和权限档位都在这里。随便问一句、让它读一个文件,面板里出现读取记录和回答,就说明跑通了。
让它真正干活:三个高频场景各花两分钟
就地改一段文字:在笔记里选中一段话,触发内联编辑热键,AI 直接在原文位置改写,改动以单词级差异标出来,接受或拒绝各一键。相关实现在 src/features/inline-edit/。
调用一条自定义命令:输入框里敲/或$,会弹出你保存过的提示模板和技能。把重复性工作流存成模板之后,以后一条命令就发出去。
让 AI 先出计划再动手:按Shift+Tab切到计划模式,AI 会先探索文件、给出方案,等你批准才实施。另外,输入@可以点名库里的某个文件,把它直接喂给对话。
卡壳排查:按序排错
提示 CLI 找不到(spawn claude ENOENT或Claude CLI not found):先做这一步——把设置里的手动路径留空,让 Claudian 自己检测,大多数情况它就找到了。还不行:终端跑which claude(Windows 用where.exe claude)拿到实际路径,填进 设置 → 高级 → Claude CLI 路径。nvm、fnm 用户十有八九卡在这一步。
工具明明装了,插件还是连不上:先做这一步——分别执行dirname $(which claude)和dirname $(which node),看两个目录是否一致。不一致说明 Obsidian 这类桌面程序找不到 Node。还不行:换原生二进制安装版本,或者在 设置 → 环境 里把 Node 所在目录加进自定义变量。
Codex、Opencode、Pi 反应不对:先做这一步——确认对应 CLI 已安装并且终端里能直接运行。还不行:按上一条的思路核对路径,再用该提供商自带的诊断命令确认版本正常。
往深里走:源码分块速览
源码分四块,找对应目录就行:
- src/providers/:各家 AI 的适配器,claude、codex、grok、opencode、pi 各一个子目录
- src/features/chat/:聊天侧边栏,标签页、控制器、渲染逻辑都在这里
- src/features/inline-edit/:内联编辑弹窗与改稿服务
- src/core/:不依赖具体提供商的运行时、注册表和类型契约
明确的下一步:挑一个真实任务切到计划模式跑一遍,再把一条你高频使用的指令存成命令模板。想继续深挖,可以从插件入口 src/main.ts 读起,配合贡献指南 CONTRIBUTING.md 了解代码规范。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考