linux.do

国内使用 OpenCode 接入 Antigravity：从安装到可用的实操教程


> 适用人群：希望在国内环境快速跑通 OpenCode + Antigravity 的用户
> 教程目标：完成安装、登录、插件接入与可用性验证
> 更新时间：2026-03-22

---

## 一、背景与目标

这篇文章不讲原理，专注“跑通链路”。
你将完成以下 5 件事：

1. 安装并确认 OpenCode 可运行
2. 准备可用的 Google 账号
3. 下载并登录 Antigravity
4. 安装 `opencode-antigravity` 插件
5. 执行一次真实调用，验证链路可用

---

## 二、前置条件

在开始前，请确认：

- 已有可用网络环境（全局和tun模式美区--增加通过的概率）
- 有一台可运行 OpenCode 的电脑（macOS / Linux / Windows）
- 有一个可稳定登录的 Google 账号

### 关于 Google 账号

如果你已有可用账号，可直接跳过获取账号步骤。
如需购买，你提供的参考链接是：

- &LThttps://gmailbuy.com/home/article/27.html>

实测经验（来自你的反馈）：

- 美区账号更容易跑通登录流程

注意事项：

- 第三方账号存在风控、售后、稳定性不确定性
- 请自行评估合规与账号安全风险
- 不建议在不可信设备上长期登录主力账号

---

## 三、步骤 1：安装 OpenCode

先按 OpenCode 官方文档完成安装。安装后立即做自检：

```bash
opencode --version
opencode --help

如果出现 command not found，优先检查：

安装是否完整
PATH 是否生效
终端是否重启
四、步骤 2：下载并登录 Antigravity
从 Antigravity 官方渠道下载安装包
打开客户端
选择 Google 登录
使用准备好的账号完成授权(授权的时候需要2fa.com的那个网站验证，用前面买的google邮箱)
登录成功标准：

能进入主界面
无反复跳转登录页
无明显授权失败提示
五、步骤 3：安装 OpenCode-Antigravity 插件
在 OpenCode 中安装插件：

插件名：opencode-antigravity
直接opencode对话框输入这个就可以了

Install the opencode-antigravity-auth plugin and add the Antigravity model definitions to ~/.config/opencode/opencode.json by following: https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/dev/README.md```

安装好之后，执行命令就可以进行授权验证了
![image|690x365](upload://cPGFIqQ36S2NlRotAiR9eoOBDfP.png)
选择 google->auth with google->add account
![image|690x466](upload://nsTUNNPtDSz1l4hbAEw015hoB8r.jpeg)
再回车到浏览器按照指示授权，接受之后，浏览器上方会有个url，copy下来粘贴到终端对话框就会授权成功了

然后重新打开一个opencode窗口就可以用最新的模型了

建议流程：

打开 OpenCode 插件管理界面
搜索并安装 opencode-antigravity
根据插件文档填写配置项（如 Token、Endpoint、Provider）
重启 OpenCode，确保插件已加载
建议检查点：

插件状态为 Enabled / Active
配置项保存后无报错
日志中无认证或初始化失败信息
六、步骤 4：执行可用性测试（关键）
不要只看“已登录”，一定要发起真实调用测试。

可先做配置检查（命令以你本地版本为准）：

bashCopyCopied!
opencode config list
再做最小调用测试（示例）：

bashCopyCopied!
opencode run "hello"
判定“可用”的标准：

有正常响应返回
无认证报错
无插件加载报错
响应时间在可接受范围
七、故障排查（按顺序）
如果调用失败，按以下顺序排查，效率最高：

Google 账号状态
是否异常登录、被风控、频繁二次验证
Antigravity 登录态
是否实际登录成功，而非“表面登录”
插件安装与配置
插件是否启用、配置是否保存成功
网络与代理环境
是否影响 OAuth 跳转和接口访问
版本兼容性
OpenCode 与插件版本是否匹配
八、一页 Checklist（发布可留）
opencode --version 有输出
Google 账号可稳定登录
Antigravity 登录成功
opencode-antigravity 已安装并启用
已完成一次真实调用并返回成功
九、结论
这套方案真正的难点不在“步骤数量”，而在“每一步是否真的打通”。
只要按 账号 → 登录 → 插件 → 实测调用 的顺序逐项确认，基本都能定位问题并跑通。

如果你后续遇到特定报错（例如登录回调失败、插件认证失败、调用超时），可以把报错信息贴出来，我可以按错误码给你一版“对症修复流程”。

最终效果
![image|690x331](upload://kPk5m4OP3rejaF7Cq92DLVqaMAV.png)

1 个帖子 - 1 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: shenglei)

26 views01:57