让 AI 直接住进你的知识库Claudian 把 Claude Code 和 Codex 嵌入 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 帮忙润色、查资料、甚至整理整个文件夹于是打开浏览器、登录网页版、复制粘贴一大段内容、等回复、再复制回来……来回切换窗口的烦躁足够浇灭一半创作热情。更麻烦的是网页版 AI 根本看不到你的知识库全貌。它不知道你写过什么、不知道上个星期整理的那篇笔记在哪里只能靠你手动喂上下文。Claudian就是来终结这个场景的。它是一款专为 Obsidian 设计的开源插件把 Claude Code、Codex、Grok、OpenCode、Pi 等主流 AI 编码代理直接嵌入你的笔记软件让 AI 变成知识库里的同事——你的 vault 就是它的工作目录读文件、写笔记、搜内容、执行命令、多步骤任务全都开箱即用。先看它长什么样下面是 Claudian 在 Obsidian 里的真实运行界面左侧是你的笔记内容右侧是 AI 对话面板你在笔记里选中文字、在面板里下达指令AI 直接在库内帮你改写、整理、生成内容。它不是聊天机器人是你的驻库员工理解 Claudian关键在一句话让代码级 AI 代理以你的笔记库为工作区运行。过去 Obsidian 里的 AI 插件大多是问答式的——把选中的文本发给接口返回一段文字。而 Claudian 用的是真正意义上的 Agent 架构AI 可以在你的 vault 里自由读写文件、运行命令、跨笔记搜索、规划并执行多步骤任务。你在聊天里说一句把本周所有会议记录整理成行动项清单它会自己去翻文件、归纳、生成新笔记。这就是核心关键词AI 协作伙伴AI collaborator。配套的长尾词是Obsidian AI 插件和Claude Code 嵌入笔记软件。三分钟完成环境配置Claudian 的上手路径很短按下面三步走就行。第一步安装插件最省事的方式是直接从 Obsidian 社区插件市场安装打开 Obsidian → 设置 → 第三方插件Community plugins→ 浏览搜索Claudian点击安装并启用想自己动手编译也没问题。把仓库 clone 到 vault 的插件目录然后安装依赖并构建git clone https://gitcode.com/GitHub_Trending/cl/claudian npm install npm run build然后在 Obsidian 的第三方插件设置里启用即可。注意Claudian 仅支持桌面端macOS、Linux、Windows需要 Obsidian v1.7.2 以上版本。第二步准备一个 AI 运行时Claudian 本身不提供模型它是胶水层——需要你本机装有至少一个编码代理 CLI比如 Claude Code、Codex、Grok Build、OpenCode 或 Pi。搭配对应的订阅或 API 服务商OpenRouter、Kimi、GLM、DeepSeek 等即可运行。装好 CLI 后Claudian 会自动探测路径。如果探测失败在设置 → Advanced 里手动指定即可。第三步打开侧边栏开始对话从功能区的 ribbon 图标或命令面板打开聊天面板。现在你可以像使用 Claude Code 一样和 AI 对话——它读你库里的文件、改笔记、建目录一切都发生在 Obsidian 内部。六个会改变你工作方式的实用功能1. 行内编辑选中即改带逐字 diff 预览在笔记里选中一段文字按快捷键触发行内编辑AI 会在原位置直接改写并用词级 diff 高亮显示改动前和改动后的差异确认后一键应用。写论文、改文案、修代码片段时这个体验比复制出去再粘贴回来顺滑太多。核心实现见 src/features/inline-edit/ui/InlineEditModal.ts。2. 计划模式先想清楚再动手按ShiftTab切换计划模式。AI 先探索你的笔记库、理解需求、给出实施计划经你批准后才真正执行修改。对重要文档、团队共用的知识库来说这层审批闸门能避免 AI 乱改内容。3. 斜杠命令与技能把常用指令沉淀下来输入/触发内置命令比如clear开启新会话、resume恢复历史对话、fork把整段对话分叉到新会话。输入$可以调用技能Skills——相当于可复用的提示词模板分为用户级和知识库级两个范围团队可以共享一套标准工作流。内置命令的定义见 src/core/commands/builtInCommands.ts。4. 提及把任意上下文拖进对话输入可以直接提及知识库里的文件、子代理甚至是 vault 外部的目录文件。想让 AI 基于某篇笔记、某个外部文件夹里的资料来做任务不用手动复制粘贴一个 就搞定。5. 指令模式给 AI 定制工作守则输入#打开指令模式从聊天输入框补充精细化的自定义指令让 AI 在本次会话中遵守你写的规则——比如回复用中文语气像产品文档。6. 多标签与会话管理像浏览器一样管理 AI 会话Claudian 支持多个标签页并行运行不同的 AI 会话单面板模式下用标签切换双面板模式下可以把持久化的会话管理器放在聊天区旁边。配合resume命令随时回到之前的对话继续工作历史会话由各代理原生的存储机制管理。连接外部工具MCP 服务器Claudian 支持通过每个编码代理自带的 CLI 管理 MCP 配置从而把外部工具接入工作流。也就是说AI 不仅能读写笔记还能调用你配置好的外部服务把 Obsidian 变成 AI 的中枢操作台。一个插件五家 AI 任你切换Claudian 最大的差异化在于Provider 无关Claude Code、Codex、Grok、OpenCode、Pi 都在支持之列你可以在不同标签页里跑不同的 AI按任务选人。这种多代理架构在代码里体现得很清晰src/providers/目录下每个子目录对应一家代理的适配器比如 claude、codex、grok、opencode、pi以及统一的 acp 传输层。上层则是一套 Provider 无关的核心运行时定义在 src/core/新代理接入不影响整体架构。另外插件的界面文案支持 10 种语言i18n 目录下可见 en、zh-CN、ja、ko 等语言包对中文用户非常友好。隐私设计没有遥测不搞小动作对笔记类工具隐私是硬要求。Claudian 在这方面的原则很清晰不运行遥测信标没有后台偷偷上报数据的行为界面轮询定时器只读取本地 Obsidian 编辑器的选中状态网络活动仅限于你明确触发的 AI 运行时调用、已配置的 MCP 端点以及回答请求所需的 SDK/CLI 调用也就是说你的数据去向取决于你选了哪家 provider插件本身不做多余的小动作。常见问题排查如果 Claude CLI 找不到典型的报错是spawn claude ENOENT或Claude CLI not found。常见原因是 Node 版本管理器nvm、fnm、volta导致 PATH 不完整。解决方法是先用which claude找到可执行文件路径在设置 → Advanced → Claude CLI path 中手动指定或者把 Node 的 bin 目录加到 PATH 里如果用的是 npm 安装的 CLI还要确保它的可执行文件路径和 Node.js 在同一个环境变量环境下否则 Obsidian 这样的 GUI 应用可能找不到 Node。建议优先安装原生二进制版本。下一步从一篇笔记开始Claudian 的价值不在于多了个聊天框而在于它打破了知识库和AI之间的墙。你不用再搬运内容AI 直接住在你的笔记里工作。如果它是你需要的工具行动路径很简单安装插件 → 装好任一编码代理 CLI → 打开侧边栏让它帮你整理今天写的那篇笔记。五分钟就能感受到差别。想深入了解插件的能力边界和内部实现可以查看项目里的 README.md 和 src/features/chat/ 源码。遇到问题项目的 CONTRIBUTING.md 也说明了如何参与贡献与反馈。把 AI 请进知识库就从 Claudian 开始。【免费下载链接】claudianAn Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault项目地址: https://gitcode.com/GitHub_Trending/cl/claudian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考