Claudian安装教程:把Claude Code嵌进Obsidian,10分钟跑通第一条命令
2026/9/11 9:29:26 网站建设 项目流程

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分钟要体验最新功能或参与开发

推荐走社区插件,全程不用碰终端。

⚡ 社区插件三步安装

  1. 打开Obsidian,进入设置 → 社区插件 → Browse
  2. 搜索Claudian,点击Install,再点击启用——看到开关变绿即成功。
  3. 确认左侧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 ENOENTClaude CLI not found

  • 现象:发消息时报CLI找不到。
  • 原因:GUI应用通过PATH找不到CLI,用nvm、fnm、volta等Node版本管理器时最常见。
  • 动作:先保持CLI路径设置为空让Claudian自动检测;失败则用下表命令查到路径,填入设置 → 高级 → Claude CLI path
平台检查命令示例结果
macOS/Linuxwhich claude/Users/you/.volta/bin/claude
Windows(原生)where.exe claudeC:\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),仅供参考

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

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

立即咨询