Claudian 安装教程:3 步把 Claude Code 搬进 Obsidian 笔记库
2026/9/11 18:28:44 网站建设 项目流程

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)才需要

主安装流程:从社区插件市场走最快

  1. 打开 Obsidian,进入设置 → 社区插件
  2. 点「浏览」,搜索框输入Claudian,点「安装」。
  3. 装完回到列表,把插件「启用」。
  4. 侧边栏出现 Claudian 图标,点一下打开对话面板;建议重启一次 Obsidian。

市场里搜不到时的两条备选路径:

  • 手动装:把发布版的main.jsmanifest.jsonstyles.css放进库的.obsidian/plugins/claudian/目录,然后重启 Obsidian。
  • 源码装:进入库的.obsidian/plugins目录执行git clone https://gitcode.com/GitHub_Trending/cl/claudian,再依次运行npm installnpm run build,最后在 Obsidian 里启用插件。

跑通验证:装完第一眼看到什么

装好就是这个样子:左边是你的笔记,右边是 AI 对话面板。面板顶部列出它读过的文件和改动的行数(+18 -1这种绿色红色标记),底部是输入框,模型切换和权限档位都在这里。随便问一句、让它读一个文件,面板里出现读取记录和回答,就说明跑通了。

让它真正干活:三个高频场景各花两分钟

就地改一段文字:在笔记里选中一段话,触发内联编辑热键,AI 直接在原文位置改写,改动以单词级差异标出来,接受或拒绝各一键。相关实现在 src/features/inline-edit/。

调用一条自定义命令:输入框里敲/$,会弹出你保存过的提示模板和技能。把重复性工作流存成模板之后,以后一条命令就发出去。

让 AI 先出计划再动手:Shift+Tab切到计划模式,AI 会先探索文件、给出方案,等你批准才实施。另外,输入@可以点名库里的某个文件,把它直接喂给对话。

卡壳排查:按序排错

提示 CLI 找不到spawn claude ENOENTClaude 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询