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 安装教程走 3 步就能跑通:它把 Claude Code、Codex 等 AI 编码助手装进 Obsidian,你的笔记库直接变成它们的工作目录,装完即可在笔记旁读写文件、搜索、执行多步任务。
装之前,10 秒核对这三项
| 项目 | 要求 |
|---|---|
| Obsidian | 桌面版 v1.13.0 及以上,移动端不支持 |
| CLI 工具 | Claude Code / Codex / Grok / Opencode / Pi,至少装一个且终端能直接运行 |
| 账号 | 对应提供商的订阅或 API Key |
| Git | 仅协作(Collab)模式需要 |
缺前两项就别往下走了,装上也连不上。用 nvm、fnm 管理 Node 的话,记住这一点,排错时会用到。
从一条命令开始:最小安装路径
- 在终端跑
which claude(Windows 用where.exe claude),能输出路径说明 CLI 就绪。 - 打开 Obsidian → 设置 → 社区插件 → 浏览,搜索
Claudian,点安装。- 备选:市场搜不到时,把发布版的
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。
- 备选:市场搜不到时,把发布版的
- 回到插件列表,把 Claudian 启用。
- 点侧边栏的 Claudian 图标打开对话面板,发一句"列出这个库里有哪些笔记",有正常回复即跑通。
跑通之后,先试这三件事
就地改一段话。选中笔记里一句话,从命令面板执行 Inline edit,AI 在原文位置改写,差异按词标出,接受或拒绝各一键。
@ 点名一个文件。输入框敲@,选中库里的某篇笔记喂给对话,让 AI 基于它总结或续写,省掉复制粘贴。
先出计划再动手。按Shift+Tab切到计划模式,AI 会先探索文件、给出方案,等你批准才实施,改大库时更安心。
🔧 连不上时的三条急救
提示 CLI 找不到(spawn claude ENOENT之类)。先试:把设置里的手动路径留空,交给自动检测。再不行:终端跑which claude拿实际路径,填进 设置 → 高级 → Claude CLI 路径。nvm、fnm 用户多半卡在这里。
CLI 明明装了,插件还是连不上。先试:分别执行dirname $(which claude)和dirname $(which node),看两个目录是否一致。再不行:换原生二进制安装版,或在 设置 → 环境 里把 Node 所在目录加进自定义变量。
Codex、Opencode 等提供商反应不对。先试:在终端直接运行对应 CLI,确认能跑。再不行:照前两条核对路径,再用该提供商自带的诊断命令确认版本正常。
⚡ 想更进一步
下一步:挑个真实任务在计划模式跑一遍。源码从 src/providers/ 各提供商适配器 和 src/features/chat/ 聊天面板 看起。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考