Gemini 3 Pro + Claude 4.6 免费用？这个插件做到了

手把手教你用 Google 账号解锁 Gemini 3 Pro 和 Claude 4.6

前言

作为一名开发者，你是否也在为 AI API 的高昂费用而头疼？

Claude API 每月 $20+，稍有不慎就超支
GPT-4 同样价格不菲，调用频繁时成本惊人
免费的 AI 工具要么功能受限，要么体验糟糕

而 Google 却提供了相当慷慨的免费额度：Antigravity IDE 用户可以免费使用 Gemini 3 Pro、Claude 4.6 等顶级模型。但问题在于，这些额度只能在 Google 官方 IDE 中使用，无法直接接入我们的开发工具。

opencode-antigravity-auth 应运而生------这是一个 OpenCode 插件，通过 OAuth 认证将你的 Google 账号与 OpenCode 打通，让你在本地开发环境中免费使用顶级 AI 模型。

本文将详细介绍这个插件的功能、安装配置方法以及使用技巧。

一、插件简介

1.1 什么是 opencode-antigravity-auth？

opencode-antigravity-auth 是一个开源的 OpenCode 插件，它通过 OAuth 认证机制，将你的 Google 账号与 OpenCode 集成，从而解锁以下能力：

访问 Gemini 3 Pro/Flash 和 Claude Opus/Sonnet 4.5/4.6 模型
利用 Google Antigravity IDE 的免费配额
支持多账号轮换，池化配额
支持 thinking 模式，深度推理
实时流式输出，包括思考过程

项目地址 : github.com/nicholasxuu...
NPM 包 : www.npmjs.com/package/ope...

1.2 核心功能概览

功能	说明
🔐 OAuth 认证	自动化 Google 账号授权，本地存储 refresh token
🎯 高级模型访问	解锁 Gemini 3 Pro/Flash、Claude 4.5/4.6 等模型
📊 双配额系统	同时利用 Antigravity 和 Gemini CLI 配额
🔄 多账号轮换	自动切换账号，池化配额，延长使用时间
🧠 Thinking 模型	支持可配置的思考预算，控制推理深度
📡 实时流式输出	SSE 支持，实时显示思考过程和输出
🔍 Google 搜索增强	内置网页搜索工具，支持 URL 分析和引用
🛡️ 自动错误恢复	优雅处理常见错误，如 `tool_result_missing`
🔁 自动 Token 刷新	透明的认证刷新，无需手动干预
🔀 跨模型对话	同一会话内无缝切换 Gemini 和 Claude

1.3 技术架构

markdown 复制代码

┌─────────────────────────────────────────────────────────┐
│                    OpenCode CLI                          │
│              (你的本地开发环境)                           │
└─────────────────────┬───────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────┐
│         opencode-antigravity-auth 插件                   │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────────┐   │
│  │ OAuth    │  │ 配额管理  │  │ 智能调度 & 错误恢复   │   │
│  └──────────┘  └──────────┘  └──────────────────────┘   │
└─────────────────────┬───────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────┐
│          Google Antigravity IDE / Vertex AI             │
│       Gemini 3 Pro/Flash + Claude 4.5/4.6              │
└─────────────────────────────────────────────────────────┘

1.4 支持的模型

Gemini 系列:

gemini-3-pro - 复杂任务、代码生成、深度推理
gemini-3-flash - 快速响应、简单任务
gemini-3-pro-image - Imagen 3 图像生成

Claude 系列:

claude-opus-4-6 - 最强推理能力
claude-opus-4-6-thinking - 深度分析、复杂推理（支持 thinking 模式）
claude-sonnet-4-6 - 通用编程、平衡性能
claude-sonnet-4-6-thinking - 思考增强版（支持 thinking 模式）
claude-haiku-4-5 - 快速响应、轻量任务

二、核心功能详解

2.1 双配额系统

opencode-antigravity-auth 的独特之处在于它利用了 两套配额：

Antigravity 配额：Google Antigravity IDE 的免费额度
Gemini CLI 配额：Google AI Studio / Gemini CLI 的免费额度

这意味着每个账号实际上拥有 双倍的可用容量，极大延长了使用时间。

2.2 多账号轮换

插件支持添加多个 Google 账号，并自动管理配额：

json 复制代码

{
  "plugins": {
    "opencode-antigravity-auth": {
      "accounts": [
        "account1@gmail.com",
        "account2@gmail.com",
        "account3@gmail.com"
      ]
    }
  }
}

工作原理:

优先使用第一个账号
遇到 429 错误（配额耗尽）时，自动切换到下一个账号
所有账号的配额被池化，延长总体使用时间

2.3 Thinking 模型

对于 Claude 和 Gemini 3 的 thinking 模型，插件支持配置 思考预算（thinking budget）：

variant	思考深度	响应速度	适用场景
`low`	浅层思考	快	简单任务、快速验证
`medium`	中等深度	中	通用任务（默认）
`high`	深度思考	慢	复杂推理、架构设计

使用示例:

bash 复制代码

# 使用高思考深度
opencode run "分析这段代码的架构问题" \
  --model antigravity/claude-sonnet-4-6-thinking \
  --variant high

2.4 实时流式输出

插件支持 Server-Sent Events (SSE) 实时流式输出，包括：

✅ 思考过程（thinking blocks）实时显示
✅ 增量输出，无需等待完整响应
✅ 流式错误处理

2.5 Google 搜索增强

对于 Gemini 模型，插件内置了 网页搜索工具：

🔍 实时网页搜索
📎 URL 分析和内容提取
📚 来源引用
⚙️ 可配置为自动或始终开启

配置示例:

json 复制代码

{
  "plugins": {
    "opencode-antigravity-auth": {
      "googleSearch": "auto"  // "auto" | "always" | "disabled"
    }
  }
}

2.6 自动错误恢复

插件内置了智能错误处理机制：

错误类型	处理方式
`tool_result_missing`	自动重试，补全缺失的工具结果
`429 Too Many Requests`	自动切换到下一个账号
`403 Forbidden`	标记账号为不可用，跳过
Token 过期	自动刷新，无需手动干预

三、安装配置教程

3.1 前置要求

✅ OpenCode CLI 已安装（版本 >= 0.5.0）
✅ Node.js 环境（版本 >= 18.0.0）
✅ 有效的 Google 账号
✅ 稳定的网络环境（需要代理）

3.2 安装步骤

步骤 1: 安装插件

编辑 OpenCode 配置文件 ~/.config/opencode/opencode.json（Windows 用户：C:\Users\<用户名>\.config\opencode\opencode.json）：

json 复制代码

{
  "plugins": {
    "opencode-antigravity-auth": {
      "enabled": true
    }
  }
}

或者使用命令行：

bash 复制代码

opencode plugin install opencode-antigravity-auth

步骤 2: OAuth 认证

运行认证命令：

bash 复制代码

opencode auth login

系统会自动打开浏览器，引导你完成 Google 账号授权：

选择你的 Google 账号
授权 OpenCode 访问你的 Antigravity 凭证
等待授权成功提示

授权成功提示页面：

步骤 3: 验证配置

bash 复制代码

# 查看已认证的账号
opencode auth status

# 测试连接
opencode run "你好，请自我介绍" --model antigravity/gemini-3-pro

3.3 添加多个账号

如果你想添加多个 Google 账号以池化配额：

bash 复制代码

# 添加第二个账号
opencode auth login --account account2@gmail.com

# 添加第三个账号
opencode auth login --account account3@gmail.com

# 查看所有账号
opencode auth list

3.4 高级配置

完整的配置选项：

json 复制代码

{
  "plugins": {
    "opencode-antigravity-auth": {
      "enabled": true,
      "googleSearch": "auto",
      "thinkingBudget": {
        "default": "medium",
        "models": {
          "claude-opus-4-6-thinking": "high",
          "claude-sonnet-4-6-thinking": "medium"
        }
      },
      "quotaStrategy": "round-robin",
      "accounts": [
        "primary@gmail.com",
        "secondary@gmail.com"
      ]
    }
  }
}

配置说明:

参数	类型	说明
`googleSearch`	string	搜索增强模式：`auto`（自动）、`always`（始终）、`disabled`（禁用）
`thinkingBudget.default`	string	默认思考深度：`low`、`medium`、`high`
`thinkingBudget.models`	object	按模型自定义思考深度
`quotaStrategy`	string	配额策略：`round-robin`（轮换）、`priority`（优先级）
`accounts`	array	账号列表（可选，不填则使用所有已认证账号）

四、使用实战

4.1 基础使用

使用 Gemini 3 Pro

bash 复制代码

opencode run "解释一下 React 的 Fiber 架构" \
  --model antigravity/gemini-3-pro

使用 Claude Sonnet 4.6

bash 复制代码

opencode run "写一个 TypeScript 类型工具，提取对象的所有可选键" \
  --model antigravity/claude-sonnet-4-6

使用 Thinking 模式

bash 复制代码

opencode run "设计一个高并发的订单系统架构" \
  --model antigravity/claude-sonnet-4-6-thinking \
  --variant high

4.2 代码生成示例

bash 复制代码

# 生成 React 组件
opencode run "创建一个可复用的 Modal 组件，支持动画和键盘关闭" \
  --model antigravity/gemini-3-pro \
  --file Modal.tsx

# 生成测试用例
opencode run "为这个 API 接口编写单元测试" \
  --model antigravity/claude-sonnet-4-6 \
  --file api.test.ts

4.3 代码审查与重构

bash 复制代码

# 代码审查
opencode run "审查这段代码，指出潜在的性能问题和安全隐患" \
  --model antigravity/claude-opus-4-6-thinking \
  --variant high \
  --file src/utils.ts

# 重构建议
opencode run "将这个类组件重构为函数组件，使用 React Hooks" \
  --model antigravity/claude-sonnet-4-6

4.4 使用 Google 搜索增强

bash 复制代码

# 自动搜索最新信息
opencode run "2024 年 React 19 有哪些新特性？" \
  --model antigravity/gemini-3-pro \
  --search

4.5 最佳实践

1. 模型选择策略

任务类型	推荐模型	原因
日常编程	`claude-sonnet-4-6`	平衡性能和速度
复杂架构设计	`claude-opus-4-6-thinking` + `high` variant	深度推理
快速问答	`gemini-3-flash`	响应迅速，节省配额
代码生成	`gemini-3-pro`	代码能力强
文档编写	`claude-sonnet-4-6`	语言表达流畅

2. 配额管理技巧

🔄 多账号轮换：至少添加 2-3 个账号
⚡ 任务分级：简单任务用 Flash，复杂任务用 Pro/Opus
📊 监控配额：定期检查各账号的配额使用情况
🎯 优先级设置：为不同账号设置优先级

3. Thinking 模式使用建议

bash 复制代码

# 不推荐：简单任务使用 high variant（浪费配额）
opencode run "打印 Hello World" \
  --model antigravity/claude-sonnet-4-6-thinking \
  --variant high  # ❌ 过度使用

# 推荐：复杂任务使用 high variant
opencode run "设计一个分布式缓存系统" \
  --model antigravity/claude-opus-4-6-thinking \
  --variant high  # ✅ 合理使用

五、常见问题与解决方案

Q1: OAuth 授权失败怎么办？

可能原因:

网络环境问题（需要代理）
浏览器缓存冲突
Google 账号安全设置

解决方案:

确保开启了代理的 TUN 模式（虚拟网卡模式）
尝试使用无痕模式完成授权
切换代理节点（推荐新加坡节点）
检查 Google 账号的安全设置，确保没有阻止第三方应用

Q2: 出现 429 Too Many Requests 错误？

原因: 当前账号配额已耗尽

解决方案:

添加更多 Google 账号
等待配额重置（Gemini 每日重置，Antigravity 每月重置）
插件会自动切换到下一个可用账号

Q3: 出现 403 Forbidden 错误？

可能原因:

账号被 Google 风控
需要完成额外验证

解决方案:

检查错误信息中是否包含验证链接
点击链接完成 Google 验证
删除账号后重新添加：

bash 复制代码

opencode auth logout --account problematic@gmail.com
opencode auth login --account problematic@gmail.com

Q4: Token 过期后需要重新登录吗？

不需要。插件会自动刷新 token，无需手动干预。

Q5: 如何查看配额使用情况？

bash 复制代码

# 查看当前配额
opencode quota status

# 查看所有账号的配额
opencode quota list

Q6: 使用这个插件有风险吗？

⚠️ 重要警告:

使用 opencode-antigravity-auth 插件 可能违反 Google 的服务条款。有以下风险：

🚫 账号可能被封禁或限制（shadow ban）
⚠️ 新注册的账号风险更高
🔒 Pro/Ultra 订阅的账号更容易被标记

安全建议:

✅ 使用成熟的 Google 账号（注册时间 > 1 年）
❌ 不要专门为此创建新账号
🔄 准备备用账号
📊 监控账号状态，及时发现问题
💰 考虑订阅 Google One / Gemini Advanced 降低风险

六、与 Antigravity Tools 的对比

你可能听说过 Antigravity Tools（原 Antigravity-Manager），这是另一个类似的开源项目。两者有什么区别？

特性	opencode-antigravity-auth	Antigravity Tools
形态	OpenCode 插件	独立桌面应用
协议支持	OpenCode 专用	OpenAI / Anthropic / Gemini 三协议
客户端支持	仅 OpenCode	OpenCode、Cursor、Cherry Studio 等
安装复杂度	低（配置文件）	中（需安装应用）
GUI 界面	无	有（Web 管理后台）
配额监控	命令行	可视化仪表盘
适用场景	OpenCode 深度用户	多工具用户、团队使用

选择建议:

🎯 只用 OpenCode？选择 opencode-antigravity-auth（轻量、简单）
🔧 用多个 AI 工具？选择 Antigravity Tools（通用、可视化）

七、总结

核心价值

✅ 零成本 ：利用 Google 免费额度，无需购买 API

✅ 顶级模型 ：访问 Gemini 3 Pro 和 Claude 4.6

✅ 智能调度 ：多账号轮换，池化配额

✅ 深度推理 ：支持 thinking 模式，可配置思考深度

✅ 易于集成：OpenCode 插件，配置简单

局限性

⚠️ 风控风险 ：可能违反 Google 服务条款

⚠️ 网络要求 ：需要稳定的代理环境

⚠️ 账号依赖：需要有效的 Google 账号

适用人群

🎓 学生（可享一年免费）
👨‍💻 个人开发者
🤖 AI 爱好者
💰 成本敏感用户
🧪 实验性项目

附录：完整配置示例

json 复制代码

{
  "version": "1.0",
  "providers": {
    "antigravity": {
      "type": "openai",
      "baseURL": "https://antigravity.googleapis.com/v1",
      "models": [
        "gemini-3-pro",
        "gemini-3-flash",
        "claude-sonnet-4-6",
        "claude-opus-4-6-thinking"
      ]
    }
  },
  "plugins": {
    "opencode-antigravity-auth": {
      "enabled": true,
      "googleSearch": "auto",
      "thinkingBudget": {
        "default": "medium",
        "models": {
          "claude-opus-4-6-thinking": "high"
        }
      },
      "quotaStrategy": "round-robin"
    }
  },
  "defaultModel": "antigravity/claude-sonnet-4-6"
}

如果这篇文章对你有帮助，欢迎 点赞、收藏、关注！有问题欢迎在评论区讨论交流～

Happy Coding! 🚀

Gemini 3 Pro + Claude 4.6 免费用？这个插件做到了