共计 2525 个字符，预计需要花费 7 分钟才能阅读完成。
前段时间我做了一个视频，教大家如何在 Obsidian 当中，使用 Gemini CLI 来管理和检索自己的笔记。当然，你使用 Claude Code 也是可以的。不得不说，这种能直接执行命令、读写文件、还能自己修正错误的 AI Agent 实在是太让人上头了。
但随之而来的也有一个小烦恼：我的思考和记录大多发生在 Obsidian 里，每次要用 Agent 帮我写点什么脚本或者整理代码，都得在终端和 Obsidian 之间来回切换，这种上下文的割裂感常常打断我的思绪。
就在我琢磨着"要是能把终端里的 Agent 塞进 Obsidian 就好了"的时候，我在 GitHub 上发现了 Obsidian Agent Client 这个项目。它就像是打通了任督二脉，让我在写笔记的同时，手边就有了一个随时待命的 AI 工程师。今天就来聊聊这个让我眼前一亮的插件。
背景介绍
在深入这个插件之前，得先聊聊它背后的技术——ACP (Agent Client Protocol)。这是由 Zed 编辑器团队开发的一个协议，旨在标准化 AI Agent 与客户端（IDE、编辑器等）之间的通信。简单来说，以前每个编辑器要接入 AI 都要自己造轮子，现在有了 ACP，只要 Agent 支持这个协议（比如 Claude Code），任何支持 ACP 的客户端都能直接调用它。
目前的现状是，像 Cursor、Windsurf 这样的 AI 原生编辑器已经让大家尝到了"Agent 就在手边"的甜头。但在笔记软件领域，虽然有不少 AI 插件，但大多数还停留在"对话"或"文本生成"的层面，真正能像 IDE 里的 Agent 那样感知上下文、执行命令、读写文件的工具几乎没有。
Obsidian Agent Client 正是填补了这块空白。它本质上是一个在 Obsidian 内部运行的 ACP 客户端，允许你直接连接并控制像 Claude Code 这样强大的外部 Agent。
可以直接通过按 Command-P 然后输入 Agent 来打开 Agent Client。
在没有遇到 Agent Client 之前，我甚至寻找过方案，是否可以在 Obsidian 当中直接装载一个终端，但是调研了一下方案之后，发现方案始终不成熟，并且嵌入的终端也并没有 [[Warp]] 或者是 [[Ghostty]] 等终端好用。
深度分析
试用了一段时间后，我认为这个插件有几个核心优势非常值得关注：
真正的 Agent 体验，而非仅仅是 Chat
不同于普通的 ChatGPT 插件，Obsidian Agent Client 接入的是"Agent"。这意味着它不仅能陪你聊天，还能执行具体的任务。比如我可以在 Obsidian 的侧边栏里让它"帮我整理当前的笔记"，它会直接在系统后台执行命令完成任务，而不是仅仅告诉我如何去修改。
上下文感知的无缝集成
写作时最怕的就是要把资料复制粘贴给 AI。这个插件支持直接使用 @ 符号引用当前的笔记文件。比如我在写一篇关于 Next.js 的文章，我可以随时在这个插件的聊天框里 @Next.js笔记，然后问它："根据我这篇笔记的内容，生成一个简单的代码示例"。它会读取你引用的文件内容作为上下文，生成的回答准确度极高。
多模型与多 Agent 切换
虽然我主要用它来跑 Claude Code，但它实际上支持任何符合 ACP 标准的 Agent。你可以在设置里配置多个 Agent，然后在聊天界面通过下拉菜单随时切换。这就给了我们很大的灵活性：处理复杂编程任务切到 Claude Code，处理简单文本任务切到轻量级的模型（如果未来支持的话）。
终端集成（双刃剑）
它允许 Agent 执行终端命令。这非常强大，比如你可以让它直接 git commit 你的笔记库，或者安装一个 npm 包。当然，这也是把双刃剑，毕竟给了 AI 执行命令的权限，虽然插件有权限控制，但在使用时还是需要保持一份警惕。
安装和配置
这个插件目前的安装门槛稍微有点高，不适合纯小白用户，但对于爱折腾的 Geek 来说，这点麻烦完全值得。
安装与配置
目前它还没上架 Obsidian 官方市场，你需要用 BRAT 插件来安装。
- 安装 BRAT 插件。
- 在 BRAT 中添加 GitHub 仓库地址：
https://github.com/RAIT-09/obsidian-agent-client。
最关键的一步是配置 Agent。你需要先在系统里通过 npm 安装好 Agent。以 Claude Code 为例：
npm install -g @zed-industries/claude-code-acp
然后你需要找到这个包的安装路径（bin 目录下的可执行文件路径），并把它填入插件的设置里。这一步可能会卡住不少人，建议使用 which 命令或者在 npm 全局目录里仔细找找。
我的工作流
我现在已经把通过它来进行一些轻量级的自动化任务。比如，我经常需要把 Obsidian 里的某些草稿整理成一篇可以分享的文章。以前我需要手动整理文本素材。现在，我只需要在侧边栏告诉 Agent："帮我按照我自己的风格整理成一篇博客分享文章"。
再比如，我在整理大量文献笔记时，会用它来做"结对阅读"。我把几篇相关的笔记 @ 进去，让它帮我总结这几篇文章的共同点和分歧点，效率比我自己来回翻阅高得多。
遇到的小坑
- 路径问题：配置 Agent 路径时一定要用绝对路径，Windows 用户最好用 WSL 模式，不然路径处理会很头疼。
- 响应速度：因为是调用本地或远程的 Agent，有时候响应速度取决于你的网络和 Agent 本身的性能（Claude Code 有时候会思考比较久）。
最后
Obsidian Agent Client 虽然还是一个早期的项目，甚至界面还略显简陋，但它展示了一种令人兴奋的可能性：将笔记软件变成一个全能的创造工作台。
过去我们认为 Obsidian 是"第二大脑"，是用来想的；IDE 和终端是用来做的。现在，通过 Agent Client 这样的插件，"想"和"做"的界限正在变得模糊。我可以一边思考，一边让 AI 帮我验证想法、执行代码、整理数据，这种"知行合一"的体验，也许就是未来个人知识库（PKM）进化的方向。如果你也是一个不仅在 Obsidian 里记录想法，还希望在里面"搞点事情"的开发者或极客，强烈推荐你试一试这个插件。把 Claude Code 装进 Obsidian，你会发现你的笔记库突然有了"手脚"，这种感觉真的很棒。
