企业官网建设流程全解析

Claudian Obsidian 插件完整指南：3 个功能把 AI 协作嵌入知识库

【免费下载链接】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、Grok 等 AI 编码代理嵌入笔记库侧边栏，直接读写、搜索笔记并执行多步任务，适合需要批量处理笔记的知识工作者与开发者。

项目概览

Claudian 是一个开源的 Obsidian 插件，它的核心思路是把你的 vault（笔记库）变成 AI 代理的工作目录：对话发生在 Obsidian 侧边栏，而代理的操作发生在你的笔记文件上。文件读写、全文搜索、命令执行和多步骤工作流开箱即用，不需要把内容复制到别的工具里。

插件内置多代理支持，可在 Claude Code、Codex、Grok、OpenCode、Pi 之间按任务选择；要求 Obsidian v1.13.0 以上、桌面端系统，并在本机安装至少一个对应的 CLI 及可用的 API 或订阅。

功能速览

• 多代理会话：Claude Code、Codex、Grok 等代理任选，按任务特点切换，避免单一模型的限制。
• 行内编辑：选中文字直接让 AI 改写，带词级 diff 预览，改前可逐字确认。
• 多标签与多会话管理：单面板多标签或双栏会话管理器，不同任务互不干扰。
• @提及与#引用：精准指定文件、目录和协作工单，缩小代理检索范围。
• 斜杠命令与 Skills：内置/clear、/resume、/fork等命令，配合可复用提示模板减少重复输入。
• MCP 服务器接入：通过各代理原生的 MCP 配置连接外部工具，扩展能力边界。

功能详解

行内编辑：选中文字让 AI 改写并预览差异

行内编辑让你不必打开聊天窗口处理小改动：在笔记里选中一段文字（或把光标放在编辑位置），触发快捷键，AI 的修改建议会以词级 diff 的形式叠加在原文上，新增与删除一目了然。确认后才真正落盘，取消则原样保留。边界在于：它适合段落级、局部性的改写，例如润色、压缩、术语替换；跨文件的结构调整仍建议在侧边栏对话中完成。

@mention：让 AI 只读你指定的文件

输入@会列出 vault 中的文件和目录，输入#可引用协作工单。把几篇笔记或一个文件夹直接挂进提示词，代理就只围绕这些内容作答，而不是全库搜索。这样做的好处是上下文更准、响应更快，也降低了无关笔记被误改的风险。

多标签与多代理会话：并行推进不同任务

侧边栏支持多标签模式，也可以启用双栏布局，在聊天旁挂一个常驻会话管理器。你可以在一个标签里用 Claude Code 整理文献，在另一个标签里用 Codex 审查代码片段，互不阻塞。每个标签保留独立的会话历史，/resume可以恢复之前的对话，/fork能把当前对话分叉成新会话用于尝试不同方向。

斜杠命令与可复用指令

输入/展开命令列表：/clear开始新对话，/resume恢复历史会话，/fork分叉会话，/instruction保存一条可复用的自定义指令。配合/或$触发的提示模板（Skills），可以把"按固定格式总结""生成引用列表"这类高频任务固化下来。命令清单定义在 内置斜杠命令源码 中，标签页与会话管理逻辑位于 features/chat/tabs。

使用场景

文档工程师：批量统一术语使用前：打开几十个文件，手动查找替换，还要逐篇检查格式。使用后：在对话中说明替换规则和涉及目录，代理批量修改并逐文件展示 diff，你只需确认。

研究人员：从文献笔记到综述草稿使用前：多篇笔记散落各处，人工归纳要点、手写综述初稿。使用后：用@提及目标文件夹，让代理提炼要点并起草综述，你负责校对事实与引用。

开发者：维护个人笔记中的代码片段库使用前：笔记里的代码示例过期，只能凭记忆手工更新。使用后：代理直接读取、修改 vault 内的文件，还能执行 bash 命令做验证，改动前后都有清晰的差异记录。

安装与首次运行

1. 确认已安装 Obsidian 1.13.0 及以上（桌面端），并装好至少一个代理 CLI（如 Claude Code 或 Codex）及可用的 API/订阅。
2. 打开 Obsidian → 设置 → 社区插件 → 浏览，搜索 "Claudian" 并安装、启用。
3. 若自动检测不到 CLI，在设置中手动填写可执行文件路径；macOS/Linux 可在终端用which claude查到。
4. 从侧边栏图标或命令面板打开聊天，输入第一条指令，例如"总结 @某文件夹 下所有笔记的主题"。

源码安装适合开发调试：把仓库克隆到 vault 的.obsidian/plugins目录后执行npm install && npm run build即可：

git clone https://gitcode.com/GitHub_Trending/cl/claudian

常见问题与进阶技巧

• 提示找不到 CLI 或报错 spawn ENOENT：常见于使用 nvm、volta 等版本管理器时，GUI 应用读不到 shell 的 PATH。先留空 CLI 路径让插件自动检测；失败再在设置中手动填写路径，或把 Node 的 bin 目录加进设置里的环境变量。
• Windows 上路径要避开包装脚本：优先使用原生的claude.exe或cli-wrapper.cjs，不要用.cmd、.ps1包装文件。
• 先计划再动手：对批量修改类任务，可以先让代理列出改动计划，确认范围后再执行，避免大面积误改。
• 进阶：用 Shift+Tab 切换计划模式；用 MCP 连接外部工具（相关接入逻辑见 providers/acp）；把高频指令通过/instruction或 Skills 沉淀为模板。

Claudian 的价值在于把"对话"和"文件"放在同一处：AI 的每一步操作都发生在你的 vault 里，可预览、可确认、可恢复。如果你正在用 Obsidian 管理大量笔记，不妨从社区插件市场安装它，用一条@提及指令完成第一个批量任务。

【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian