站点图标 高效码农

Antigravity Tools：AI多账号管理与协议反代难题，这个开源神器一次性搞定

高效码农

Antigravity Tools：一站式AI账号管理与协议反代解决方案

在AI应用日益普及的今天，开发者和AI爱好者常常面临一个共同的难题：不同AI服务（如Google Gemini、Anthropic Claude）的接口协议不统一，多账号管理繁琐，配额监控困难。这些问题不仅影响开发效率，还可能导致资源浪费或服务中断。

Antigravity Tools（版本3.3.1）正是为解决这些问题而生。作为一款专业的桌面应用，它将多账号管理、协议转换和智能请求调度整合在一起，成为你的本地AI中转站。无论是将Web端的Session转化为标准化API，还是实现不同AI服务的无缝切换，它都能提供稳定、高效的支持。

核心功能：让AI管理更简单

智能账号仪表盘：全局状态一目了然

想象一下，当你同时使用多个Gemini Pro、Gemini Flash、Claude账号时，如何快速知道哪个账号配额充足、状态良好？智能账号仪表盘就是你的”AI账号指挥中心”。

它能实时展示所有账号的健康状况，包括各类模型的平均剩余配额。更实用的是，系统会根据账号的配额冗余度，自动推荐”最佳账号”，支持一键切换，省去手动比对的麻烦。同时，活跃账号的配额百分比和最后同步时间也会直观显示，让你对资源使用情况了如指掌。

强大的账号管家：灵活管理多账号

添加和管理多个AI账号往往是件头疼的事，但Antigravity Tools的账号管家功能让这一过程变得简单：

  • OAuth 2.0授权：添加账号时，系统会生成可复制的授权链接，你可以在任意浏览器完成授权。授权成功后，应用会自动保存账号信息；若未自动完成，点击”我已授权，继续”即可手动收尾。
  • 多维度导入：支持单条Token录入、JSON批量导入（比如从其他工具的备份文件导入），还能从V1旧版本数据库自动迁移，无需重复配置。
  • 网关级视图：提供”列表”和”网格”两种视图，方便不同场景下的操作。同时，它能自动检测403封禁状态，标注并跳过权限异常的账号，避免无效请求。

协议转换与中继：打破API壁垒

不同AI厂商的接口协议往往不兼容，这意味着你可能需要为每个服务单独编写适配代码。Antigravity Tools的协议转换功能彻底解决了这个问题：

  • 全协议适配：
    • 提供OpenAI格式的/v1/chat/completions端点，兼容99%的现有AI应用；
    • 支持Anthropic原生/v1/messages接口，包括Claude Code CLI的全功能（如思维链、系统提示词）；
    • 兼容Google官方SDK，可直接调用Gemini相关功能。
  • 智能状态自愈：当请求遇到429（请求过多）或401（授权过期）错误时，后端会在毫秒级自动重试并切换账号，确保业务不中断。

模型路由中心：精准控制请求流向

如果你需要将特定请求路由到指定模型，模型路由中心能满足你的需求：

  • 系列化映射：可以将复杂的原始模型ID归类到”规格家族”，比如将所有GPT-4请求统一路由到gemini-3-pro-high。
  • 专家级重定向：支持自定义正则表达式进行模型映射，精准控制每一个请求的落地模型，灵活应对各种场景。

多模态与Imagen 3支持：处理高清内容无压力

对于需要处理图片的场景，Antigravity Tools同样表现出色：

  • 高级画质控制：通过OpenAI的size参数（如1024x1024、16:9），自动映射到Imagen 3的相应规格，无需手动调整。
  • 超强负载支持：后端支持高达100MB的Payload，处理4K高清图识别绰绰有余，满足多模态应用的需求。

界面导览：直观易用的操作体验

Antigravity Tools的界面设计注重实用性和易用性，主要包含以下核心页面：

仪表盘 – 全局配额监控与一键切换

仪表盘是你使用工具的起点，集中展示所有账号的配额状态和最佳推荐，让你快速掌握全局情况。

账号列表 – 高密度配额展示与403智能标注

账号列表页面支持两种视图切换，清晰展示每个账号的详细信息，包括配额、状态等，方便批量管理。

关于页面 – 关于Antigravity Tools

关于页面提供工具的版本信息、版权说明等基础内容，帮助你了解工具的背景。

API反代 – 服务控制

API反代页面用于控制服务的开启与配置，包括端口、协议等关键参数，是实现协议转换的核心入口。

系统设置 – 通用配置

系统设置页面允许你自定义工具的各项参数，如开机启动、日志管理等，满足个性化需求。

技术架构：理解工具的工作原理

Antigravity Tools的高效运行依赖于清晰的技术架构，其核心流程如下：

  1. 外部应用接入：像Claude Code、NextChat这样的外部应用，通过OpenAI或Anthropic协议连接到Antigravity的Axum服务器。
  2. 中间件处理：请求首先经过鉴权、限流、日志等中间件，确保安全和合规。
  3. 模型路由：由Model Router根据预设的映射规则，将请求路由到对应的模型。
  4. 账号分发：账号分发器根据轮询或权重策略，选择合适的账号处理请求。
  5. 协议转换：请求映射器（Request Mapper）将外部请求转换为上游服务（如Google、Anthropic API）可识别的格式。
  6. 上游交互：转换后的请求发送到上游API，获取响应后，由响应映射器（Response Mapper）转换为外部应用可识别的格式，最终返回给客户端。

这种架构设计确保了请求处理的高效性和灵活性，也是工具能实现多协议兼容和智能调度的关键。

安装指南：快速部署工具

选项A：macOS终端安装（推荐）

如果你使用macOS且已安装Homebrew，可以通过以下步骤快速安装：

  1. 订阅仓库的Tap：
brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
  1. 安装应用：
brew install --cask antigravity-tools

如果遇到权限问题，可添加--no-quarantine参数：

brew install --cask --no-quarantine antigravity

选项B：手动下载

前往GitHub Releases下载对应系统的安装包：

  • macOS：.dmg格式（支持Apple Silicon和Intel芯片）
  • Windows：.msi或便携版.zip
  • Linux：.deb或AppImage

常见问题排查

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

这是由于macOS的安全机制导致的，可通过以下方法解决：

  1. 命令行修复（推荐）：
    打开终端，执行：
sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"
  1. Homebrew安装技巧：
    使用brew安装时，添加--no-quarantine参数可规避此问题：
brew install --cask --no-quarantine antigravity

快速接入：如何使用Antigravity Tools？

OAuth授权流程（添加账号）

  1. 打开”Accounts / 账号” → “添加账号” → “OAuth”。
  2. 弹窗会生成授权链接，点击链接可复制到剪贴板，用浏览器打开并完成授权。
  3. 授权成功后，浏览器会显示”✅ 授权成功!”。
  4. 应用会自动保存账号；若未自动完成，点击”我已授权，继续”手动完成。

提示：授权链接包含一次性回调端口，请使用弹窗中最新的链接；如果授权时应用未运行或弹窗已关闭，浏览器可能会提示localhost refused connection。

接入Claude Code CLI

  1. 启动Antigravity，在”API反代”页面开启服务。
  2. 在终端执行：
export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"
claude

接入Kilo Code

  1. 协议选择：建议优先使用Gemini协议。
  2. Base URL：填写http://127.0.0.1:8045。

注意事项：

  • OpenAI协议限制：Kilo Code使用OpenAI模式时，请求路径可能出现非标准格式（如/v1/chat/completions/responses），导致404错误，因此需选择Gemini模式。
  • 模型映射：若模型名称不匹配，可在”模型映射”页面设置自定义映射，并查看日志文件调试。

在Python中使用

import openai

client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)

response = client.chat.completions.create(
    model="gemini-3-flash",
    messages=[{"role": "user", "content": "你好，请自我介绍"}]
)
print(response.choices[0].message.content)

版本演进：工具的迭代与优化

Antigravity Tools持续迭代，不断优化功能和稳定性，以下是主要版本的更新亮点：

v3.3.1（2025-12-28）

  • Claude协议400错误修复：解决了长上下文对话中因cache_control标记或thought: true字段导致的上游校验报错，优化了MCP工具定义的转换逻辑。
  • 全协议内置联网工具适配：OpenAI、Gemini和Claude协议均支持”无需模型后缀”触发联网，增强了与Cherry Studio等客户端的兼容性。
  • 全链路追踪与日志优化：为每个请求添加6位随机Trace ID，标记请求属性（[USER]为真实对话，[AUTO]为后台任务），实现Token消耗闭环回显。
  • Claude CLI后台任务优化：识别标题生成、摘要提取等低价值请求，自动重定向至gemini-2.5-flash，节省高价值模型配额。

v3.3.0（2025-12-27）

  • Codex CLI与Claude CLI适配：支持Codex CLI的/v1/responses端点，解决Claude CLI使用Gemini 3系列模型时的签名校验报错。
  • OpenAI协议栈重构：新增/v1/completions和/v1/responses路由，整合图片解析与JSON Schema过滤策略。
  • 网络绑定控制：默认监听127.0.0.1（仅本机访问），可通过allow_lan_access开关允许局域网访问，兼顾隐私与灵活性。

v3.2.8（2025-12-26）

修复了OpenAI协议下向视觉模型（如gemini-3-pro-image）发送图片请求时的400错误，补齐了视觉处理能力，使其与Claude协议保持一致。

v3.2.7（2025-12-26）

  • 新功能：新增开机自动启动功能，账号列表支持分页大小选择（10/20/50/100条）。
  • JSON Schema清理增强：移除Gemini不支持的高级字段（如propertyNames、const等），解决Claude Code v2.0.76+使用MCP工具时的报错。
  • 反代稳定性优化：支持解析上游RetryInfo，精准遵循重试指令；优化画图请求并发处理，解决429报错。

更早版本

  • v3.2.6：优化Claude协议，解决工具冲突错误，增强反代稳定性。
  • v3.2.3：优化进程管理架构，解决Linux环境下的进程识别问题。
  • v3.2.2：升级日志系统，实现全量日志持久化，优化Google免费额度路由。
  • v3.2.1：支持自定义DB导入，增强OpenAI与Gemini协议的工具调用能力。
  • v3.2.0：重构API反代引擎，优化Linux进程管理，重构仪表盘界面。

常见问题（FAQ）

Antigravity Tools支持哪些AI服务？

目前支持Google Gemini（包括Pro、Flash、绘图模型）、Anthropic Claude等主流AI服务，通过协议转换可兼容多数基于OpenAI、Anthropic协议的应用。

多账号管理有什么优势？

多账号管理能避免单一账号配额耗尽导致的服务中断，系统会自动切换账号；同时，通过最佳账号推荐，可优先使用配额充足的账号，提高资源利用率。

如何解决安装后的启动问题？

  • macOS用户若遇到”应用已损坏”提示，可通过终端执行sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"修复。
  • 其他系统若启动失败，建议检查安装包完整性，或尝试重新下载对应版本的安装文件。

日志文件保存在哪里？如何查看？

日志文件自动归档至本地app.log，记录系统启动、请求处理等信息。你可以在设置页面找到日志相关选项，包括查看和清理日志。

工具是否会上传我的账号数据？

不会。所有账号数据均加密存储于本地SQLite数据库，除非手动开启同步功能，否则数据不会离开你的设备，保障隐私安全。

总结

Antigravity Tools作为一款专业的AI账号管理与协议反代系统，通过智能仪表盘、灵活的账号管理、全协议适配、精准的模型路由和多模态支持，为开发者和AI爱好者提供了高效的本地AI中转站解决方案。

无论是简化多账号管理流程，还是打破不同AI服务的协议壁垒，它都能发挥重要作用。随着版本的持续迭代，其功能和稳定性不断提升，成为连接各类AI服务的实用工具。

如果你正在为多AI服务管理烦恼，不妨尝试Antigravity Tools，让AI应用开发和使用变得更简单、高效。

退出移动版