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
还在手动逐个打开 Obsidian 笔记、复制粘贴内容找 AI 帮忙处理吗?Claudian 是一个 Obsidian 插件,它把 Claude Code、Codex 等 AI 编码代理直接嵌进你的库(vault)中。你的知识库就是代理的工作目录,文件读写、搜索、bash 命令和多步骤工作流开箱即用。装好之后,你只需要用一句自然语言指令,剩下的交给代理完成。
🧩 它解决了什么问题
没有 Claudian 时,AI 只能隔着聊天窗口看你贴过去的内容:你复制笔记、粘贴进对话框、拿到回复、再贴回来。十几个文件就要重复十几轮,格式稍有不同还得逐个手动核对。Claudian 的思路很直接:把代理放进你的库,让它自己去读、写、搜索文件,你只负责下指令。
💬 核心功能逐一拆解
库即工作目录
代理能直接操作你库里任意笔记,不需要你把内容搬进聊天框。它继承自 Claude Code 这类编码代理的完整能力:读、写、编辑文件,按文件名或内容搜索,执行 shell 命令。比如你说“把这个文件夹下所有笔记的 frontmatter 统一加上 tags 字段”,它会自己找到文件、逐个读取修改,你只需确认结果。
行内编辑
选中笔记里的一段文字按快捷键,代理会就地重写这部分内容,并给出词级别的 diff 预览。你能先看到具体改动再决定是否应用,而不是整篇重读。比如一段会议纪要太长,选中后输入“压缩成三条要点”,确认后原文即被替换。
斜杠命令与技能
在聊天输入框敲/或$,会弹出内置命令和可复用的提示模板。内置命令包括/clear开新对话、/resume恢复旧会话、/fork把当前对话分支成新会话、/instruction把自定义指令存成模板,逻辑定义在 src/core/commands/builtInCommands.ts。比如你用/instruction存好“周报语气要求”,之后每次写周报调用一次即可。
多标签页与会话管理
侧边栏可以开多个对话标签页,每个标签独立运行自己的代理任务。标签状态会被持久化保存,关掉再打开还能继续,管理逻辑实现在 src/features/chat/tabs/TabManager.ts。比如一个标签做文献整理,另一个标签跑代码审查,第三个标签顺手整理杂项笔记,互不干扰。
📋 三个典型使用例子
研究生整理文献笔记。在聊天里用@提及存放文献摘要的文件夹,要求“提取每篇的关键论点和引用信息,汇总成一篇综述”。代理自己读完所有文件后输出汇总笔记,你只需要校对一遍。
项目经理写周报。选中本周散落在各处的会议纪要和任务记录,输入“整理成进度、风险、下周计划三部分”。代理直接在库里生成或更新对应文件,几分钟内周报成形。
开发者维护代码笔记。先/fork把当前对话分叉出副本,再在新会话里让代理给库中的伪代码补注释和 TODO。原始会话原样保留,两条线的工作互不影响。
🚀 从零开始配置
- 先装好至少一个 AI 代理 CLI,比如 Claude Code CLI 或 Codex CLI。
- 确认 Obsidian 为 1.13.0 或更高版本(仅支持桌面端)。
- 打开 Obsidian 的“设置 → 社区插件 → 浏览”。
- 搜索 “Claudian”,点击安装,然后启用该插件。
- 点击左侧丝带状图标,打开聊天侧边栏。
- 输入“列出当前文件夹下的 md 文件”这类指令,确认代理可以正常操作。
❓ 新手常见疑问
问:提示找不到 Claude CLI 怎么办?先让 CLI 路径设置留空,由 Claudian 自动检测,这类报错常见于 nvm、fnm 等 Node 版本管理器。仍然失败就用which claude(macOS/Linux)或where.exe claude(Windows)找到可执行文件路径,填进“设置 → 高级 → Claude CLI 路径”。
问:我的笔记内容会传到第三方吗?你的输入和所附文件内容会发送给所选模型的 API 提供商(如 Anthropic 或 OpenAI),这是生成回复所必需的。Claudian 本身不上报告遥测,网络活动只发生在你明确发起的请求中。
问:改了环境变量,为什么代理行为没变?环境变量是批量写入并自动重启进程生效的,实现见 src/main.ts 中的applyEnvironmentVariablesBatch。如果旧会话行为仍不正常,用/clear开一个新对话再试。
Claudian 把你的库从存放笔记的地方变成 AI 代理的工作台,批量整理、批量修改这类重复劳动基本可以一句话委托出去。你可以直接在 Obsidian 社区插件市场安装它体验,更多细节可以看仓库里的 README 和排错章节。
【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考