Claudian Obsidian 插件快速上手：5 步装好并使用-迪斯科星球

Claudian Obsidian 插件快速上手：5 步装好并使用

【免费下载链接】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、Grok、Opencode、Pi 等 AI 编码助手直接嵌进你的笔记库。装完以后，笔记库就是 AI 的工作目录，读写文件、搜索、跑多步任务全部就地发生。

它到底能做什么

直接在笔记里改写文字，以单词级差异预览，回车接受、Esc 拒绝
在侧边栏对话面板里让 AI 读取、修改、搜索库中任意文件
输入/或$调出你保存的提示模板和技能，一条指令完成重复流程
输入@把指定文件、文件夹直接喂进对话作为上下文

开始前的检查清单

前置项	最低要求	不满足会怎样
Obsidian	v1.13.0 及以上，桌面版	插件无法安装，移动端不支持
CLI 工具	Claude Code / Codex / Grok / Opencode / Pi，至少装一个	插件装上了但没有任何可对话的助手
账号	对应提供商的订阅或 API Key	对话时鉴权失败
Node.js	与 CLI 可执行文件同环境可见（源码构建另需 v24）	终端能跑、Obsidian 里跑不起来
Git	仅协作（Collab）模式需要	单机功能正常，协作功能不可用

安装步骤

打开设置 → 社区插件，完成标志：能看到「浏览」按钮。
点「浏览」，搜索框输入 Claudian，完成标志：结果列表中出现该插件及其版本号。
点「安装」，完成标志：按钮变为「已安装」。
在插件列表里开启「Claudian」，完成标志：Obsidian 左侧缎带栏出现 bot 图标。
重启一次 Obsidian，点击缎带图标打开对话面板，完成标志：右侧出现输入框和模型选择区。

备选路径（源码安装）：在库的.obsidian/plugins目录执行git clone https://gitcode.com/GitHub_Trending/cl/claudian，进入目录跑npm install && npm run build，再回 Obsidian 启用插件。

🔍 装完验收

右侧面板就是工作区：上方是会话记录，每条标注了读过的文件和+N -N的行改动数；下方是输入框，模型和思维强度切换都在这一行。左侧笔记被读、被改后，面板会同步显示对应的 Read / Edit 操作。

三个上手场景

就地改写一段文字。选中笔记里的目标段落，打开命令面板执行「Inline edit」（可在设置 → 快捷键里给它绑热键）。弹出的预览里改动以单词级差异标出，按 Enter 接受、Esc 拒绝；没选中文本时在光标处触发，AI 会在该行位置插入新内容。

用@和/精确派活。输入框里敲@会列出库中的文件和文件夹，选中即把文件内容作为上下文；接着敲/或$调出已保存的提示模板或技能，回车发出。协作模式下敲#还能引用工单。

先出计划再动手。在对话面板按Shift+Tab切到计划模式，AI 会先探索相关文件、给出方案，你批准后它才真正执行修改，适合改动面较大的任务。

遇到问题

现象	常见原因	处理办法
报`spawn claude ENOENT`或`Claude CLI not found`	桌面程序继承不到终端的 PATH，CLI 路径没被自动检测	先把设置里的手动路径留空让插件自测；仍失败就用`which claude`（Windows 用`where.exe claude`）拿到实际路径，填入设置 → 高级 → Claude CLI 路径
终端能跑，Obsidian 里连不上	CLI 可执行文件和 Node.js 不在同一 bin 目录	对比`dirname $(which claude)`与`dirname $(which node)`，不一致就改装原生二进制，或在设置 → 环境的自定义变量里把 Node 目录加入 PATH
Windows 下路径填了仍报错	指向了`.cmd`/`.ps1`包装脚本	原生安装填`claude.exe`，npm 安装填`{npm root -g}\@anthropic-ai\claude-code\cli-wrapper.cjs`
其他提供商（Codex、Opencode、Pi）无响应	对应 CLI 未安装或版本异常	先在终端确认 CLI 可直接运行，再按第一行思路核对路径，并用该提供商自带的诊断命令查版本

最容易踩的坑：nvm、fnm 这类 Node 版本管理器——你在终端里看到的命令路径，Obsidian 作为桌面程序未必能看到，手动路径一栏优先留空。

🧭 进阶

目录	职责
src/providers/	各家 AI 的适配器：`claude/`、`codex/`、`grok/`、`opencode/`、`pi/`、`acp/`
src/features/chat/	聊天侧边栏：标签页、控制器、渲染器
src/features/inline-edit/	内联编辑弹窗及其编辑服务
src/core/	不依赖具体提供商的运行时、注册表与类型契约
src/app/	应用服务、存储与协作模式基础设施
src/i18n/	10 种语言的翻译文案

下一步建议：挑一个真实任务切到计划模式完整跑一遍，顺手把一条你高频使用的指令存成斜杠命令模板；想深入了解行为细节，直接读 README.md 的 Features & Usage 一节即可。

【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析