最近OpenCode可是超级的火，而且之前我不是弄到了一年学生认证的Gemini 3 Pro嘛，这不正好可以让OpenCode来连接Gemini 3 Pro，来个强强联合！

但是要让这两强联合在一起也有一些难度，网上的教程都是通过第三方插件的方法来实现的，我是没有连接配置成功过，所以通过向Gemini求助，最终把这个最简单的配置方法落实下来。

我是在Windows 11系统下进行配置的，如果刚好你也想玩的话，那可以按着我的方法来试试看哦。

第一阶段：基础环境准备 (必做)

1、安装Node.js

OpenCode 的运行依赖于 Node.js 环境，所以第一步就是先安装 Node.js。

访问Node.js的官网（nodejs.org），进入下载页面，提议选择 LTS 长期支持版下载，例如我下载的就是 v22.22.0 LTS这个版本。这里不要选最新尝鲜版，LTS 版本最稳定。

下载好安装包就可以安装Node.js了，安装过程一路点击 “Next” 即可，如果不是专业开发者，安装过程中有个带 tools 的选项，可以按照默认跳过，即无需勾选。

2、安装 OpenCode 客户端

前往 OpenCode 的 GitHub 或官方渠道下载对应系统的安装包。

安装完成后，提议在OpenCode的桌面快捷方式上点鼠标右键，选择属性，进入兼容性标签页，勾选以管理员身份运行此程序，然后点确定保存，并启动软件。

第二阶段：获取“钥匙” (API Key)

我们需要一把钥匙来开启 Google Gemini 的大门，访问 Google AI Studio 并登录你的 Google 账号。点击左侧的 Get API key，点击 Create API key。然后在弹出的窗口中选择Create project创建一个项目，并给项目随意起个名字吧，我就把它命名为OpenCode，这样就会生成一组以 AIza 开头的长字符串，要把它复制下来并妥善保存在记事本里（不要发给别人）。

第三阶段：配置连接 (核心步骤)

这一步是将“钥匙”交给 OpenCode。我们将使用最稳妥的终端输入法。

打开 OpenCode，先点击右上角的按钮，这时界面底部会弹出一个 Terminal (终端) 标签页。

在终端标签页里面，输入以下命令并回车：

opencode auth login

然后使用键盘的⬇️键选中 Google 并按 Enter (回车) 确认。

接下来它会提示 Enter your API key。

这个时候就可以输入上面第二阶段获取的API KEY了，

将你刚才保存的 AIza… 开头的密钥粘贴进去，按 Enter (回车)。

当终端显示 Done 字样，说明配置成功！

第四阶段：切换模型与验证

目前钥匙插好了，我们需要告知软件：“请使用 Gemini 3 Pro 这个大脑”。

这时最快的方法是直接在 OpenCode 上方白色的聊天输入框中，发送以下指令：

/model google/gemini-3-pro

(发送后，你会看到左下角的模型指示器可能会变动，或者后台已经静默切换)

最终验证 在聊天框发送测试语：

“Hi！请你做下自我介绍吧。”

得到的回复如下图所示，就证明成功了。

关于显示名称：如果左下角依然显示 “Big Pickle” 或其他默认名字，请忽略它。这只是界面显示的预设包名称，只要它的回复内容是对的，就是成功的。由于当我们在聊天窗口中输入指令 /model google/gemini-3-pro 时，是在底层强行把OpenCode会话的“大脑”换成了 Gemini 3 Pro。

但是这个方法也有一个不方便的地方，就是每次关闭OpenCode并重新打开的时候，都需要在聊天窗口中输入前面的指令来调用Gemini 3 Pro：

/model google/gemini-3-pro

常见问题急救

如果你之前乱装了插件，或者怎么弄都报错，请使用“纯净重置法”：

删除配置文件：

快捷键Win+R打开运行，然后输入下面的路径并回车：%APPDATA%opencode

这时系统会打开资源管理器，找到并删除 opencode.json 文件。

重启软件：彻底关闭 OpenCode 并重新打开。

重做第三阶段：由于删除了配置，你需要重新在终端输入一次 API Key。

好了，以上就是我摸索出来的方法，也许不是最合适的，但的确 是最简单最容易实现的。如果这篇文章对你有所协助，请不要忘记收藏加转发，关注我，我们一起玩AI！

#探寻人工智能# #编程# #AI技术#