Antigravity Tools 使用攻略

Antigravity Tools 使用攻略

前言

作为一名开发者，你是否也曾为 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 核心能力

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 技术架构

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

二、安装部署

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

macOS

使用 Homebrew（推荐）:

# 1. 添加 Tap 源
brew tap lbjlaq/antigravity-manager 

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

一键安装脚本:

curl -fsSL  | bash

Windows

PowerShell 一键安装:

irm  | iex

Linux

# 一键安装（自动检测包管理器）
curl -fsSL  | bash

或手动下载：

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

2.3 常见安装问题

macOS 提示"应用已损坏，无法打开"

sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"

或使用 Homebrew 时添加参数：

brew install --cask --no-quarantine antigravity-tools

️ TUN 模式配置提醒

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

三、账号配置详解

3.1 OAuth 授权流程

1. 打开 Antigravity Tools，进入 Accounts（账号） 页面
2. 点击 添加账号 → 选择 OAuth
3. 点击授权链接，会自动复制到剪贴板

4. 在浏览器中打开授权链接，使用 Google 账号登录
5. 授权成功后，浏览器会显示 " 授权成功！"
6. 返回 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: 验证配置

# 查看生成的配置文件
cat ~/.config/opencode/opencode.json

4.3 集成方式二：手动配置

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

// ~/.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<用户名>.configopencodeopencode.json

4.5 验证与测试

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

# 基础测试 - 使用 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

预期输出:

 Connected to antigravity-manager
 Model: gemini-3-pro
 Response received

[AI 回复内容...]

4.6 可用模型列表

variant 参数说明:

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

4.7 清理与恢复

如需清除 OpenCode 配置：

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

五、高级功能

5.1 模型路由中心

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

使用场景示例:

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

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 爱好者
• 成本敏感用户

相关链接

• GitHub 仓库: github.com/lbjlaq/Anti…
• Google Antigravity 官网: antigravity.google
• 官方文档: github.com/lbjlaq/Anti…

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