Claudian 使用指南：把 AI 编程助手请进 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 编程助手嵌进你的笔记库，让助手直接读写、搜索你的笔记文件。适合想不切换工具，就用自然语言整理、改写和批量处理笔记的人。
先备好这三样，再开始动手
- 桌面版 Obsidian，版本 1.13.0 以上，macOS、Linux、Windows 均可，移动端不支持
- 一个 AI 助手的命令行工具：Claude Code、Codex、Grok Build、OpenCode、Pi 任选其一
- 该助手对应的订阅或 API 密钥，OpenRouter、Kimi、GLM、DeepSeek 都可以
它最适合笔记量大、经常要跨文件整理、想让 AI 自己动手改文件的人；只是偶尔写写短笔记的话，收益有限。
装好插件，并完成第一次对话
装它：社区插件市场一键安装
在 Obsidian 里打开 设置 → 社区插件 → 浏览，搜索 "Claudian"，点安装，再启用。想从源码装，就把仓库克隆到笔记库的.obsidian/plugins目录，执行git clone https://gitcode.com/GitHub_Trending/cl/claudian，然后npm install、npm run build，回 Obsidian 启用。逐步说明在 README.md 里。
确认它跑通了：让助手读一篇笔记
启用后点左侧边栏图标（或从命令面板里搜聊天命令），右侧出现聊天面板，输入框在底部，右下角是当前模型和思维档位。发一句"读取这篇笔记，总结它的结构"，面板里出现带绿色对勾的 Read 调用，说明链路通了。
把这三件事跑顺，日常使用就够了
打开侧边栏聊天，让助手直接读写你的笔记
它能干什么：助手的工作目录就是整个笔记库，读笔记、搜内容、建新文件、跑多步任务都可以。 怎么做：打开侧边栏，用自然语言下指令，比如"把项目计划里散落的日期统一成表格"。它会一步步执行：先 Read 读目标笔记，再 Edit 改写，旁边标着 +18 −1 这样的行数变化。 你会得到什么：笔记被就地修改，聊天里留下每次工具调用的记录，做了什么、改了多少，随时能回看。
📝 选中文字行内改写，diff 先过目再落笔
它能干什么：选中一段文字（或光标停在某处），按行内编辑快捷键，直接在笔记里改写，确认前能看到词级别的 diff。 怎么做：选中要改的段落，按快捷键并说明改法，逐词检查 diff，确认应用。 你会得到什么：改动落在笔记原位，每一步都有词级对照，不会出现"被 AI 悄悄改了一大片"。
🔁 用斜杠命令和 @ 引用，固定重复操作
它能干什么：输入/调出可复用的提示词模板，$触发技能（Skills），@引用具体的笔记或文件夹，把上下文一次钉住。 怎么做：输入框敲/选一个命令执行；要助手看某个文件就敲@选中它；常用流程做成用户级或库级技能，用$调用。 你会得到什么：重复的提示词变成一条命令，比如固定一条"周回顾总结"，以后每周敲一次就行。
进阶玩法，和三个容易踩的坑
想接外部工具，可以按各助手原生的 MCP 配置接 MCP 服务器；聊得多的项目，用多标签页或双栏的常驻会话管理器分开管理；要和同事共享项目，有实验性的 Collab 模式，带评审和冲突处理，需要先装 Git，功能还在稳定中。
常见的坑：
- 报错
spawn claude ENOENT或提示找不到 CLI，通常是图形界面拿不到命令行路径，用 nvm、fnm、volta 管理 Node 的人最常见。先把 CLI 路径设置留空让它自动找，不行就which claude查到路径，填进 设置 → Advanced。 - Windows 下别填
.cmd或.ps1包装脚本的路径，原生安装用claude.exe，npm 安装用cli-wrapper.cjs。 - CLI 是 npm 装的、又和 Node.js 不同目录时，Obsidian 可能找不到 Node，装原生二进制最省事，或在 设置 → Environment 里补 Node 路径。
说句实话：目前只支持桌面端，没有移动端；Collab 模式仍是实验功能；助手能力以你装的 CLI 为准，不同助手之间的体验不会完全一致。
装好之后，先挑一篇最近的长笔记，让它做一次跨文件整理，盯着每一步的行数变化再决定接受还是撤销。想弄清它怎么调 Claude Code 和 Codex，从 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），仅供参考
