3分钟装好Claudian：在Obsidian里给笔记接上一个AI编码助手
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
在笔记里选中一段文字，按下热键，这段文字就被AI就地改写，逐词差异摆在你面前，等你决定要不要采纳。这就是Claudian插件的日常形态：它把 Claude Code、Codex 这类编码助手搬进 Obsidian 侧边栏，你的知识库就成了它们干活的工作目录——读文件、写文件、搜索、跑命令，都在笔记旁边完成。
开始之前
装插件之前，先备齐四样东西：
- 桌面版 Obsidian，版本不低于 v1.13.0，移动端不受支持
- macOS、Linux、Windows 任选其一
- 系统里装好至少一个助手 CLI——Claude Code、Codex、Grok、Opencode、Pi 任选其一，并备好对应订阅或 API 密钥
- 想试多设备协作模式的话，再装一个 Git
装好之后可以放心用：插件没有遥测后台，网络活动只发生在你明确发起的提供商调用里，不做后台数据上传。
在 Obsidian 里装上 Claudian
最省事的是社区插件市场，一共四步：
- 打开 Obsidian 的设置页，进入“社区插件”
- 点“浏览”，搜索“Claudian”
- 点“安装”
- 回到插件列表把它启用，左侧边栏随即出现聊天图标
如果市场里搜不到，也可以手动下载 main.js、manifest.json、styles.css 三个文件，放进知识库的 .obsidian/plugins/claudian/ 目录，重启 Obsidian 就能用。开发者则把代码克隆到同一目录（git clone https://gitcode.com/GitHub_Trending/cl/claudian），再跑 npm install 和 npm run build 生成插件文件。
装完第一次用起来
装完就能用，不需要额外配置：
- 点击左侧缎带图标，或从命令面板调出“Claudian”，聊天侧边栏打开
- 在笔记里选中一段文字，按内联编辑热键，AI 开始就地改写
- 看差异高亮，改动逐词可见，点一下采纳或拒绝
下图是启动后的样子：左侧是笔记正文，右侧是 Claudian 对话面板，能看到助手的回复，以及它对知识库文件做的操作。
想让助手碰某个具体文件，在输入框里输入 @ 把它提出来，再发送。
日常会用到的几个快捷方式
再记几个快捷方式，日常用一周就会回不去了：
- 输入 / 或 $，调出用户级和知识库级的提示词模板
- 输入 @，提及想让助手处理的东西：知识库文件、子代理，甚至外部目录里的文件
- 按 Shift+Tab 切换计划模式，助手先探索设计、给出计划，你批准后它才动手
- 多标签对话、分支与恢复会话，都在侧边栏里直接完成
遇到问题先看这里
提前说明两个高频问题，都出在“插件找不到 CLI”这一件事上：
提示 spawn claude ENOENT 或 Claude CLI not foundGUI 进程继承的 PATH 和终端不一致，用 nvm、fnm、volta 这类 Node 版本管理器时最常见。修复：先把设置里的 CLI 路径留空交给自动检测，仍不行就用 which claude（macOS/Linux）或 where.exe claude（Windows）查出位置，填进设置 → 高级。Windows 上别指向 .cmd 或 .ps1 包装器，原生安装指 claude.exe，npm 安装指 cli-wrapper.cjs。
npm 装的 CLI 调不起来npm 装的 claude 和 node 不在同一目录，Obsidian 找不到 Node.js。修复：改装原生二进制版本，或在设置 → 环境 → 自定义变量里补上 Node 路径。
想再折腾一点
对实现细节感兴趣，从这几处看起：
- src/providers/ 是各助手适配器所在地，一个提供商一个目录，新助手在这里接入
- src/features/chat/ 装着侧边栏聊天、标签与消息渲染；src/features/inline-edit/ 是内联编辑的实现
- src/core/ 是提供商无关的运行时，命令、提示词、存储、工具契约都在里面
- src/app/collab/ 是局域网协作体系，含 Git 项目托管与主机交接
- 也可以经由各 CLI 的原生配置接入 MCP 服务器，用外部工具扩展助手能力
先跑一次内联编辑，三分钟你就能摸清“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），仅供参考
