Opencode Antigravity Auth 插件:通过 Google OAuth 解锁 Antigravity 配额
在现代 AI 辅助开发中,获取稳定且高质量的模型访问至关重要。今天我要介绍一个实用的 Opencode 插件——opencode-antigravity-auth,它能让你通过 Google OAuth 认证来访问 Antigravity(Google 的 IDE)的配额,从而使用 Claude Opus 4.6、Gemini 3.1 Pro 等高级模型。
主要功能
这个插件提供了以下核心特性:
- 多模型支持 - 通过 Google OAuth 访问 Claude Opus 4.6、Sonnet 4.6 和 Gemini 3.1 Pro/Flash
- 多账户管理 - 支持添加多个 Google 账户,配额耗尽时自动轮换
- 双配额系统 - 同时访问 Antigravity 和 Gemini CLI 的配额
- 思维模型支持 - 支持 Claude 和 Gemini 3 的扩展思维功能,可配置思维预算
- Google 搜索接地 - 为 Gemini 模型启用网络搜索功能
- 自动恢复 - 自动处理会话错误和工具故障
- 插件兼容性 - 可与其他 OpenCode 插件(oh-my-opencode、dcp 等)配合使用
安装步骤
方式一:自动安装(推荐)
将以下命令粘贴到任何 LLM 代理(Claude Code、OpenCode、Cursor 等)中:
1 | 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 |
方式二:手动安装
添加插件配置
在
~/.config/opencode/opencode.json中添加:1
2
3{
"plugin": ["opencode-antigravity-auth@latest"]
}登录 Google 账户
1
opencode auth login
配置模型
运行
opencode auth login→ 选择 Google → OAuth with Google (Antigravity) → 选择 “Configure models in opencode.json”(自动配置所有模型)开始使用
1
opencode run "Hello" --model=google/antigravity-claude-opus-4-6-thinking --variant=max
模型参考
Antigravity 配额(Claude 和 Gemini 的默认路由)
| 模型 | 变体 | 说明 |
|---|---|---|
| antigravity-gemini-3-pro | low, high | Gemini 3 Pro 支持思维 |
| antigravity-gemini-3.1-pro | low, high | Gemini 3.1 Pro 支持思维(取决于部署情况) |
| antigravity-gemini-3-flash | minimal, low, medium, high | Gemini 3 Flash 支持思维 |
| antigravity-claude-sonnet-4-6 | — | Claude Sonnet 4.6 |
| antigravity-claude-opus-4-6-thinking | low, max | Claude Opus 4.6 支持扩展思维 |
Gemini CLI 配额(与 Antigravity 分开的配额池)
| 模型 | 说明 |
|---|---|
| gemini-2.5-flash | Gemini 2.5 Flash |
| gemini-2.5-pro | Gemini 2.5 Pro |
| gemini-3-flash-preview | Gemini 3 Flash(预览版) |
| gemini-3-pro-preview | Gemini 3 Pro(预览版) |
| gemini-3.1-pro-preview | Gemini 3.1 Pro(预览版) |
完整配置示例
将以下配置添加到 ~/.config/opencode/opencode.json:
1 | { |
多账户设置
要获得更高的配额,可以添加多个 Google 账户:
1 | opencode auth login # 再次运行以添加更多账户 |
账户管理选项:
- 配置模型 - 在 opencode.json 中自动配置所有插件模型
- 检查配额 - 查看每个账户的剩余 API 配额
- 管理账户 - 启用/禁用用于轮换的特定账户
故障排除
快速重置
大多数问题可以通过删除账户文件并重新登录解决:
1 | rm ~/.config/opencode/antigravity-accounts.json |
常见问题
- 403 权限拒绝 - 需要在 Google Cloud Console 中启用 Gemini for Google Cloud API
- 找不到 Gemini 模型 - 在 provider 配置中添加
"npm": "@ai-sdk/google" - 400 错误 - 更新到最新测试版或禁用不兼容的 MCP 服务器
- 所有账户速率限制 - 更新插件或删除账户文件重新认证
重要警告
⚠️ 使用风险提示
使用此插件可能违反 Google 的服务条款。一些用户报告了他们的 Google 账户被禁止或影子禁止(无明确通知的限制访问)。
使用此插件即表示你承认:
- 这是一个未经 Google 认可的非官方工具
- 你的账户可能被暂停或永久禁止
- 你需要承担使用此插件的所有风险
项目信息
- GitHub 仓库:NoeFabris/opencode-antigravity-auth
- 许可证:MIT License
- 支持:如果此插件对你有帮助,可以考虑在 Ko-fi 上支持开发者
这个插件为 Opencode 用户提供了强大的模型访问能力,但使用时请务必了解相关风险。对于需要高质量 AI 辅助开发的开发者来说,这是一个值得尝试的工具。