起因很简单：我想把像 Claude Code 之类的 AI 编程助手，直接塞进我的 Obsidian 第二大脑里。

早几个月的时候，我们想用 AI 操作笔记，往往是打开一个黑乎乎的命令行窗口（CLI），指向 Obsidian 的文件库。虽然功能强大，但体验很割裂：写笔记在 Obsidian，跑指令在命令行，两边来回切换，选择文件也很麻烦。

为了解决这个问题，我折腾过不少插件。 最早试过 Claudian，但那时候我用起来好像不太灵光，不知道是我接的模型有问题，还是windows的问题，老是会中断。 我就在想，既然 Gemini 处理文本的能力这么强，有没有办法把 Gemini CLI 这种工具优雅地接进来？而且Gemini CLI现在还免费啊！

我理想中的状态是这样的：

• 就在手边：我在笔记里写着写着，鼠标右边一拉就能问它；
• 自由切换：今天想用 Claude Code 写代码，明天想用 Minimax 润色文案，后天想用 Gemini 画图，不需要换工具，只需要换“脑子”；
• 懂上下文：最好能直接把“当前这篇笔记”甩给它，让它基于现有内容干活。

然后，我找到了 Obsidian Agent Client 这个插件（基于 Zed 编辑器的 ACP 协议）。

装上之后，我发现： 以后可能真的不需要在多个窗口、多个工具里切来切去了，一个客户端就可以通吃所有模型。

它不仅能接 Claude Code，还能通过 OpenCode 接入国产的 Minimax、智谱 GLM免费用！今天就教大家怎么把这个万能插件装进你的 Obsidian。

01

三步给你请回免费AI小工

准备工作： 你的电脑得先安装 Node.js（相当于给 AI 运行搭个地基）。 去 Node.js 官网下载安装，或者在终端输入 node -v，有数字跳出来就是稳了。

第一步：在 Obsidian 里装上这个插件

打开 Obsidian，去社区插件里搜 Agent Client。 （如果搜不到，可以用 BRAT 插件安装 GitHub 地址：RAIT-09/obsidian-agent-client）

装好并启用后，你的侧边栏会多出一个对话气泡图标。点开它，现在它是空的，因为我们还没插电。

方案一：可访问github

安装BRAT插件。

注：BRAT插件是可以从github地址加载beta版插件的插件

在BRAT中接入这个地址：https://github.com/RAIT-09/obsidian-agent-client

如下，插件加载成功

方案二：无法访问github

下载插件压缩包，解压到对应目录，我帮你下载了一份，今天你必须用上！

https://my.feishu.cn/wiki/MM6twWUXui6NSGkLC43catjsn1A

解压目录：.\Obsidian Vault.obsidian\plugins\

然后启用插件即可！

第二步：安装开源大善人 OpenCode

打开你的终端（Windows 叫 PowerShell，Mac 叫 Terminal），输入这行指令：

npm install -g opencode

回车，搞定。 这时候你已经把 Minimax 和 智谱 的官方连接器装好了。 输入 opencode，不需要登录就可以直接用了，当然，我们不需要在这里使用。

第三步：关键一步！连线配置，让你的插件和你的CLI链接上

回到 Obsidian 的 Agent Client 插件设置页。 在 Command 配置栏里，我们需要告诉插件你的“大神”住在哪里。

稳妥的配置方法： 在终端输 where opencode（Mac 用 which opencode），把显示出来的完整路径复制下来，填进插件配置里。

比如我的配置是这样的：

• Name: OpenCode
• Command: C:\Users\zane\AppData\Roaming\npm\opencode.cmd (你的路径可能不一样)
• Arguments：acp ![[Obsidian AI 工具接入架构图]]

03

类似上面的方式安装你的Gemini Cli 和 Claude Code（可选）

Claude Code

先安装Claude Code

npm install -g @anthropic-ai/claude-code

然后安装他的ACP插件

npm install -g @zed-industries/claude-code-acp

Gemini CLI

Google的模型，个人版免费额度很香，本身自带ACP，不需要装插件，建议装preview版本支持skills

npm install -g @google/gemini-cli@preview

/settings开启 Agent Skills

重新启动Gemini CLI

在插件里面配置

都是现有的配置项，输入CMD中的路径即可，Gemini特殊一点需要输入Arguments：--experimental-acp

04

进来了怎么用？很简单，就和他对话

只需要选择下你想要的模型，我一般选minimax，当然你也可以用GLM-4.7，默认的话是Big Pickle，执行下逻辑任务也还是可以的。

然后，上一篇文章，我们介绍了能做的一些事儿。再来给大家展示一下具体的内容：

• 给我的公众号配图：一句话搞定！

• 给我的公众号配封面：一句话搞定！

END

工具再强，也不会自动替你思考。 但好工具的意义在于：它消灭了那些让你分心的阻力。

当你想画信息图时，MiniMax 就在手边； 当你想写文案时，Gemini 随叫随到。 甚至你可以让Gemini生成后，让Minimax用中文native润色下文案。

这才是真正的第二大脑——想事的时候它能帮你想，干活的时候它替你干。

👇 小嘚瑟

起初，这个插件在Windows环境下并不够友好，运行skills中的Python脚本时会报错，原因是插件无法正确识别系统环境变量。

不过在这个Vibe Coding大行其道的时代，我直接让AI来帮忙修复！经过几次交互就精准定位了问题，还顺便让AI指导我把修复代码提交PR给作者。现在作者已经采纳了我的修改，你去GitHub下载的最新版本就已经包含了我的贡献😉！