Antigravity Tools 使用攻略

小碗细面2026-02-25 16:33

Antigravity Tools 使用攻略

手把手教你用 Google 免费额度驱动 OpenCode 等 AI 开发工具

前言

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

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

而 Google Gemini 却提供了相当慷慨的免费额度：学生认证后一年免费使用，普通用户每天也有 50 次调用额度。但问题在于，这些额度只能在 Google 官方客户端或网页端使用，无法直接接入我们的开发工具。

Antigravity Tools 应运而生------它可以将 Google 的免费额度转化为标准 API 接口，让你在 OpenCode、Cursor、Cherry Studio 等任意支持 OpenAI 协议的工具中免费使用顶级 AI 模型。

本文将手把手教你安装、配置并使用 Antigravity Tools，打造属于你自己的免费 AI API 网关。

一、Antigravity Tools 是什么？

1.1 项目简介

Antigravity Tools （原 Antigravity-Manager）是一款开源的跨平台桌面应用，专为开发者和 AI 爱好者设计。它采用 Tauri + Rust + React 技术栈，轻量高效，支持 macOS、Windows 和 Linux 三大平台。

项目地址 : github.com/lbjlaq/Anti...

1.2 核心能力

功能 说明
🔐 多账号管理 支持 OAuth 自动授权，批量添加 Google/Anthropic 账号
🔌 三协议代理 同时支持 OpenAI、Anthropic(Claude)、Gemini 三种 API 协议
📊 智能配额监控 实时显示各账号配额使用情况，自动切换最佳账号
🎨 Imagen 3 图片生成 支持 Google 最新图像生成模型
🔄 模型路由映射 自定义模型名称映射，灵活适配各种客户端

1.3 支持的模型

Antigravity Tools 支持通过 Google 的 Vertex AI 调用以下模型：

Gemini 系列:

  • gemini-3-pro / gemini-3.1-pro - 复杂任务、代码生成
  • gemini-3-flash - 快速响应、简单任务
  • gemini-3-pro-image - Imagen 3 图像生成

Claude 系列:

  • claude-opus-4-6-thinking - 深度分析、复杂推理
  • claude-sonnet-4-6 / claude-sonnet-4-6-thinking - 通用编程
  • claude-haiku-4-5 - 快速响应

1.4 技术架构

scss 复制代码 
┌─────────────────────────────────────────────────────────┐
│                   外部应用层                              │
│   OpenCode / Cursor / Cherry Studio / Python SDK        │
└─────────────────────┬───────────────────────────────────┘
                      │ OpenAI / Anthropic / Gemini 协议
                      ▼
┌─────────────────────────────────────────────────────────┐
│              Antigravity Tools (本地网关)                 │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────────┐   │
│  │ 账号管理  │  │ 协议转换  │  │ 智能调度 & 配额保护   │   │
│  └──────────┘  └──────────┘  └──────────────────────┘   │
└─────────────────────┬───────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────┐
│              上游 API (Google Vertex AI)                 │
│           Gemini / Claude / Imagen 3                    │
└─────────────────────────────────────────────────────────┘

二、安装部署

2.1 方式一：桌面应用安装（推荐）

macOS

使用 Homebrew（推荐）:

bash 复制代码 
# 1. 添加 Tap 源
brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager

# 2. 安装应用
brew install --cask antigravity-tools

一键安装脚本:

bash 复制代码 
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.sh | bash
Windows

PowerShell 一键安装:

powershell 复制代码 
irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex
Linux
bash 复制代码 
# 一键安装（自动检测包管理器）
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.sh | bash

或手动下载：

  • Debian/Ubuntu: .deb 包
  • Arch Linux: AppImage
  • 其他发行版: AppImage

2.3 常见安装问题

macOS 提示"应用已损坏，无法打开"
bash 复制代码 
sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"

或使用 Homebrew 时添加参数：

bash 复制代码 
brew install --cask --no-quarantine antigravity-tools
⚠️ TUN 模式配置提醒

如果使用代理软件，登录 Google 账号时需要开启 TUN 模式（虚拟网卡模式），否则可能出现登录失败。建议切换到新加坡等节点尝试。

三、账号配置详解

3.1 OAuth 授权流程

  1. 打开 Antigravity Tools，进入 Accounts（账号） 页面
  2. 点击 添加账号 → 选择 OAuth
  3. 点击授权链接，会自动复制到剪贴板
  1. 在浏览器中打开授权链接，使用 Google 账号登录
  2. 授权成功后，浏览器会显示 "✅ 授权成功！"
  3. 返回 Antigravity Tools，账号会自动添加

3.2 配额仪表盘

添加账号后，可以在 Dashboard（仪表盘） 页面查看：

  • 各账号的配额剩余百分比
  • Gemini Pro / Flash / Claude 等模型的独立配额
  • 最后同步时间
  • 最佳账号推荐

3.3 多账号管理策略

Antigravity Tools 支持智能账号切换：

  • 自动切换: 当当前账号配额耗尽时，自动切换到下一个可用账号
  • 优先级排序: 根据账号类型和配额重置频率自动排序
  • 403 检测: 自动检测并跳过被禁用的账号

四、实战：OpenCode 集成教程

4.1 OpenCode 简介

OpenCode 是一款开源的 AI 编程助手，支持多种模型提供商。结合 Antigravity Tools，你可以免费使用 Gemini 3 Pro、Claude Sonnet 等顶级模型进行编程辅助。

4.2 集成方式一：一键同步（推荐）

Antigravity Tools 提供了 OpenCode 专用的一键同步功能：

步骤 1 : 启动 Antigravity Tools，确保 API 反代 服务已开启

步骤 2 : 进入 API 反代 → CLI配置一键同步 → 找到 OpenCode 配置 卡片

步骤 3 : 点击 立即同步配置 按钮，选择要同步的模型：

  • 创建配置文件 ~/.config/opencode/opencode.json
  • 添加独立 provider antigravity-manager（不覆盖现有配置）

步骤 4: 验证配置

bash 复制代码 
# 查看生成的配置文件
cat ~/.config/opencode/opencode.json

4.3 集成方式二：手动配置

如果你更喜欢手动配置，可以直接编辑配置文件：

json 复制代码 
// ~/.config/opencode/opencode.json
{
  "providers": {
    "antigravity-manager": {
      "type": "openai",
      "apiKey": "sk-antigravity",
      "baseURL": "http://127.0.0.1:8045/v1",
      "models": [
        "gemini-3-pro",
        "gemini-3-flash",
        "claude-sonnet-4-6",
        "claude-sonnet-4-6-thinking",
        "claude-opus-4-6-thinking"
      ]
    }
  }
}

Windows 用户 配置文件路径：C:\Users\<用户名>\.config\opencode\opencode.json

4.5 验证与测试

配置完成后，使用以下命令验证：

bash 复制代码 
# 基础测试 - 使用 Gemini 3 Pro
opencode run "你好，请自我介绍" --model antigravity-manager/gemini-3-pro

# 使用 Claude Sonnet 4.6
opencode run "写一个 Python 冒泡排序" --model antigravity-manager/claude-sonnet-4-6

# 使用 thinking 模式 + high variant
opencode run "分析这段代码的时间复杂度" \
  --model antigravity-manager/claude-sonnet-4-6-thinking \
  --variant high

预期输出:

vbscript 复制代码 
✓ Connected to antigravity-manager
✓ Model: gemini-3-pro
✓ Response received

[AI 回复内容...]

4.6 可用模型列表

模型 ID 说明 推荐场景 variant 支持
gemini-3-pro Gemini 3 Pro 复杂任务、代码生成 -
gemini-3-flash Gemini 3 Flash 快速响应、简单任务 -
claude-sonnet-4-6 Claude Sonnet 4.6 通用编程 -
claude-sonnet-4-6-thinking Claude Sonnet 4.6 思考模式 复杂推理 low/medium/high
claude-opus-4-6-thinking Claude Opus 4.6 思考模式 深度分析 low/medium/high

variant 参数说明:

  • low: 快速响应，思考深度较浅
  • medium: 平衡模式（默认）
  • high: 深度思考，响应较慢但质量更高

4.7 清理与恢复

如需清除 OpenCode 配置：

  • Clear Config: 一键清除 Antigravity Manager 相关配置
  • Restore: 从备份恢复之前的配置

五、高级功能

5.1 模型路由中心

在 API 反代 → 模型路由中心，你可以自定义模型映射：

使用场景示例:

将所有 gpt-5 请求重定向到 gemini-3-pro：

ini 复制代码 
gpt-4 => gemini-3-pro
gpt-5 => gemini-3-flash

5.2 智能配额调度

Antigravity Tools 的智能调度系统会：

  1. 优先级排序: 根据账号类型和配额重置频率自动排序
  2. 自动轮换: 遇到 429 错误时自动切换到下一个账号
  3. 配额保护: 防止单个账号过度消耗

5.3 后台任务降级

系统会自动识别后台请求（如标题生成），将其重定向到 Flash 模型，保护高级模型配额。

六、常见问题 FAQ

Q1: TUN 模式下登录失败怎么办？

解决方案:

  1. 切换代理节点（推荐新加坡）
  2. 确保代理开启了"虚拟网卡模式"或"TUN 模式"
  3. 尝试使用无痕模式完成授权

Q2: 出现 429 Too Many Requests 错误？

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

解决方案:

  1. 等待配额重置（Gemini 每日重置）
  2. 添加更多账号
  3. 系统会自动切换到下一个可用账号

Q3: OpenCode 无法连接到 Antigravity Tools？

排查步骤:

  1. 确认 Antigravity Tools 的 API 反代服务已启动
  2. 检查端口 8045 是否被占用
  3. 验证配置文件中的 baseURL 是否正确

Q4: 出现 403 Forbidden 错误？

可能原因:

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

解决方案:

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

Q5: 使用 2api 功能有风控风险吗？

⚠️ 重要提示: 由于近期 Google 风控加强，使用 2api 功能可能导致账号被风控。建议：

  • 减少高频调用
  • 关注官方公告和更新
  • 考虑使用更稳定的 gRPC 协议（测试中）

七、总结

优点

✅ 完全免费 : 利用 Google 免费额度，零成本使用顶级 AI 模型

✅ 开源透明 : 代码完全开源，社区活跃

✅ 功能全面 : 支持多账号、多协议、智能调度

✅ 跨平台 : 支持 macOS、Windows、Linux

✅ 易于集成: 一键同步 OpenCode 配置

局限性

⚠️ 依赖 Google 额度 : 需要有效的 Google 账号

⚠️ 风控风险 : 高频使用可能触发风控

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

适用人群

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

相关链接

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

相关推荐
GISer_Jing2 小时前
基于 OpenClaw 构建 博客自动撰写 Agent
前端·aigc·ai写作
JavaGuide2 小时前
7 道 AI 编程高频面试题！涵盖 Cursor、Claude Code、Skills
后端·ai编程
烤鸭的世界我们不懂3 小时前
开箱即用：OpenCLaw集成飞书实用部署与使用心得
人工智能·ai编程·openclaw
从文处安4 小时前
「前端何去何从」高效提示词（prompts）：前端开发者的AI协作指南
前端·aigc
多恩Stone5 小时前
【3D-AICG 系列-14】Trellis 2 的 Texturing Pipeline 保留单层薄壳，而 Textured GLB 会变成双层
人工智能·python·算法·3d·aigc
彪悍大蓝猫6 小时前
分享一个好用的Claude Code模型切换器
ai编程
师范大学生6 小时前
cursor安装agent skill
ai编程
AngelPP6 小时前
OpenClaw Memory 模块完整分析
前端·aigc·ai编程
树獭叔叔6 小时前
02-大模型位置编码详解：大模型如何理解顺序？
后端·aigc·openai
热门推荐
01GitHub 镜像站点02Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services03【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆04AI Agent 平台横评：ZeroClaw vs OpenClaw vs Nanobot05Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤06OpenClaw 使用和管理 MCP 完全指南07AI agent：介绍 ZeroClaw 安装，使用08OpenClaw 安装之（三）DeepSeek模型接入配置和详细配置参数09AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南10EvoMap 是什么？