🌌 Antigravity 全家桶安装与使用指南

Antigravity 是 Google 推出的 AI 编码 IDE 平台，由 Antigravity IDE（VSCode fork 增强版）和 Antigravity Tools（OAuth 账号管理 + 本地 LLM API 代理）两部分组成。它的核心创新是本地代理层——把外部 AI 服务（Claude / GPT / zai 等）的 OAuth token、限流、调度统一收敛到 127.0.0.1:8045，让 OpenClaw、Claude Code、Codex、自研 Agent 都能用 OpenAI-compatible 协议无缝接入。

0. 桌面版：Antigravity IDE 深度使用

Antigravity IDE 是 Antigravity 全家桶的核心入口——一个基于 VSCode 1.23 fork 深度改造的 AI 原生 IDE。它不只是"装了 AI 插件的 VSCode"，而是把 AI Agent 变成一等公民：侧边栏有 Plan / Actor / Memory 三个 AI 面板，编辑器支持 inline AI diff 审阅，终端可派发 Agent 任务。Antigravity Tools 负责账号/代理，IDE 负责体验。

0.1 与 VSCode 的关系

0.2 启动与首次配置

# 1. 启动 IDE
open /Applications/Antigravity.app
# 或 CLI（已在 PATH）
antigravity

# 2. 选择工作区
# File → Open Folder → ~/projects/xiaoao

# 3. 首次会提示登录 Antigravity 账号
# 走 Antigravity Tools 已配的 OAuth（xiazhwq1@gmail.com）

# 4. 验证 Antigravity 代理连通
# IDE 底部状态栏会显示 "✓ antigravity-tools" 绿色 dot
# 点 dot 可切换模型（claude-sonnet-4-5 / opus-4 / gpt-5）

0.3 三大 AI 面板

0.4 实战工作流（4 步）

# 1. Plan 模式：让 AI 规划
Plan: "帮我给 xiaoao 主题加搜索功能"
→ AI 拆 5 步：装 lunr.js / 生成索引 / 写 search.html / 集成 nav / 测移动端

# 2. 审阅方案
→ 接受 / 修改 / 拒绝某步

# 3. Actor 模式：自动执行
Actor: [Run all approved]
→ AI 写 4 个文件 + 跑测试 + 输出 diff

# 4. 审阅 inline diff
→ 单击文件 diff → Alt+Enter 接受/拒绝每一处

0.5 vs Cursor / Windsurf / Trae

💡 Antigravity IDE 杀手锏：Plan + Actor 分离。Cursor 把"出方案"和"执行"混在 Chat 里，AI 容易越权乱改。Antigravity 强制分两阶段——你必须先批准 Plan，Actor 才动代码，对生产代码更安全。

一、Antigravity 全家桶组成

macOS 上全部装在 /Applications/：

/Applications/Antigravity.app              # IDE 主程序
/Applications/Antigravity IDE.app          # IDE 别名入口
/Applications/Antigravity Tools_4.1.33.app # 代理管理 GUI
/Applications/Antigravity_1.23.2.app       # 历史版本（保留）

💡 Antigravity IDE vs VSCode：Antigravity IDE 是 VSCode 的 fork，分发版本号 1.23.2 对应 VSCode 1.x。它保留了 VSCode 全部能力（settings.json、扩展、keybindings），并在侧边栏多出 Agent / Plan / Actor 三个面板。

二、安装：三平台步骤

2.1 macOS — DMG 安装

# 1. 下载官方 DMG（需要 Google 账号）
# https://antigravity.google/download/mac

# 2. 拖 Antigravity.app 到 /Applications/
open ~/Downloads/Antigravity.dmg
cp -R /Volumes/Antigravity/Antigravity.app /Applications/

# 3. 拖 Antigravity Tools_4.x.x.app 到 /Applications/
cp -R "/Volumes/Antigravity/Antigravity Tools_4.1.33.app" /Applications/

# 4. 启动 IDE 一次（注册 launchd 服务）
open /Applications/Antigravity.app
# 或 CLI
~/.antigravity/antigravity/bin/antigravity

2.2 Windows — MSI 安装

# 1. 下载 MSI（需要管理员权限）
# https://antigravity.google/download/windows

# 2. 双击运行 AntigravityTools-4.1.33.msi
# 安装到 C:\Program Files\Antigravity Tools\

# 3. 数据目录
# C:\Users\<USER>\.antigravity_tools\
# C:\Users\<USER>\.antigravity\

2.3 Linux — AppImage / deb

# AppImage（推荐，无 root）
wget https://antigravity.google/download/antigravity-tools.AppImage
chmod +x antigravity-tools.AppImage
./antigravity-tools.AppImage

# Debian/Ubuntu
wget https://antigravity.google/download/antigravity-tools.deb
sudo dpkg -i antigravity-tools.deb

# 数据目录
# ~/.antigravity_tools/
# ~/.antigravity/

2.4 验证安装

# macOS - 启动代理管理 GUI
open /Applications/Antigravity\ Tools_4.1.33.app

# CLI 检查代理
curl http://127.0.0.1:8045/v1/models
# 应返回 JSON 模型列表

# CLI 启动 IDE
~/.antigravity/antigravity/bin/antigravity ~/projects

三、Antigravity Tools 本地代理（port 8045）

3.1 核心架构

┌──────────────────┐      ┌─────────────────────┐      ┌──────────────┐
│ Claude Code      │      │  Antigravity Tools  │      │ Anthropic    │
│ Codex CLI        │ ──→  │   127.0.0.1:8045    │ ──→  │ OpenAI       │
│ OpenClaw/Hermes  │      │  (OpenAI+Anthropic  │      │ z.ai         │
│ 自研 Agent       │      │   双协议兼容)        │      │ ...          │
└──────────────────┘      └─────────────────────┘      └──────────────┘
                          OAuth 续期 / 限流
                          zai 协议转换
                          调度 (Balance)
                          token 缓存

3.2 配置文件结构

macOS 数据目录 ~/.antigravity_tools/：

~/.antigravity_tools/
├── accounts.json              # 账号索引（id/email/disabled）
├── accounts/                  # 单个账号详细配置
│   └── 420f184b-2a95-4b9a-8bb1-c66bc3374503.json
├── gui_config.json            # GUI + 代理配置
├── user_tokens.db             # SQLite - OAuth token 库
├── token_stats.db             # SQLite - 用量统计
├── proxy_logs.db              # SQLite - 代理请求日志
├── security.db                # SQLite - 安全策略
├── update_settings.json       # 自动更新检查
└── logs/
    ├── app.log.YYYY-MM-DD     # 每日轮转
    └── ...

3.3 关键配置项（gui_config.json 截取）

{
  "language": "zh",                      // 界面语言
  "theme": "system",                     // 主题
  "auto_refresh": true,                  // 账号 token 自动刷新
  "refresh_interval": 15,                // 刷新间隔（秒）
  "proxy": {
    "enabled": true,                     // 启用本地代理
    "allow_lan_access": false,           // 仅本机访问（安全）
    "auth_mode": "auto",                 // auto/key/none
    "port": 8045,                        // 监听端口
    "auto_start": true,                  // 开机自启
    "request_timeout": 120,              // 请求超时
    "enable_logging": true,              // 写日志
    "scheduling": {
      "mode": "Balance",                 // 调度模式
      "max_wait_seconds": 60
    },
    "zai": {                             // zai 协议转 Anthropic
      "enabled": false,
      "base_url": "https://api.z.ai/api/anthropic",
      "models": {
        "opus": "glm-4.7",
        "sonnet": "glm-4.7",
        "haiku": "glm-4.5-air"
      }
    },
    "experimental": {
      "enable_signature_cache": true,
      "enable_tool_loop_recovery": true,
      "context_compression_threshold_l1": 0.4
    }
  }
}

四、OAuth 账号管理

4.1 添加账号

# GUI 方式
# 1. 打开 Antigravity Tools
# 2. 左上角 "添加账号"
# 3. 浏览器跳转 Google OAuth → 授权
# 4. 自动写入 accounts.json

# CLI 方式（从 GUI 菜单 Help → Show Logs 找）
# Antigravity Tools 暂不暴露 CLI 添加接口

# 验证当前账号
cat ~/.antigravity_tools/accounts.json

4.2 accounts.json 真实示例

{
  "version": "2.0",
  "accounts": [
    {
      "id": "420f184b-2a95-4b9a-8bb1-c66bc3374503",
      "email": "xiazhwq1@gmail.com",
      "name": "Wenqiang Zhang",
      "disabled": false,
      "proxy_disabled": false,
      "created_at": 1776728830,
      "last_used": 1776728830
    }
  ],
  "current_account_id": "420f184b-2a95-4b9a-8bb1-c66bc3374503"
}

4.3 订阅识别

Antigravity Tools 自动识别账号的 Antigravity 订阅档位：

💡 实际订阅档位和 Google AI Studio / Vertex 配额联动。Antigravity Tools 只做代理，不直接计费。

4.4 Token 自动续期

# 启动时日志（~/.antigravity_tools/logs/app.log.YYYY-MM-DD）
INFO  Successfully loaded index with 1 accounts
INFO      Success xiazhwq1@gmail.com
INFO  Batch refresh completed: 1 success, 0 failed, took: 4225ms
WARN  🔄 Optimistic reset: Cleared all 0 rate limit record(s)
# → 每 15 秒检查一次，token 过期前 5 分钟自动 refresh

五、zai 协议转 Anthropic（成本优化）

zai（智谱）是国内性价比极高的 GLM-4 系列模型服务，Antigravity Tools 内置zai → Anthropic 协议转换器，让 Claude Code 等只用 Anthropic 协议的 Agent 能透明调用 GLM-4.7 / 4.5-air。

5.1 启用 zai 兼容

# 编辑 ~/.antigravity_tools/gui_config.json
{
  "proxy": {
    "zai": {
      "enabled": true,
      "base_url": "https://api.z.ai/api/anthropic",
      "api_key": "*** 智谱 API key",
      "dispatch_mode": "auto",      // auto / opus_only / fallback
      "model_mapping": {
        "opus": "glm-4.7",          // 假装是 opus
        "sonnet": "glm-4.7",        // 假装是 sonnet
        "haiku": "glm-4.5-air"      // 假装是 haiku
      }
    }
  }
}

# 重启代理
killall "Antigravity Tools"
open /Applications/Antigravity\ Tools_4.1.33.app

5.2 成本对比

💡 适合日常开发 + 长上下文用 zai 跑 glm-4.7，关键架构决策才切 Anthropic 真 Claude Sonnet/Opus 4.5。

六、与 OpenClaw / Hermes 集成

6.1 Hermes config.yaml

providers:
  - name: antigravity
    type: openai-compat
    base_url: http://127.0.0.1:8045/v1
    api_key: dummy                  # 代理自动用 OAuth
    default_model: claude-sonnet-4-5

models:
  antigravity-sonnet:
    provider: antigravity
    model: claude-sonnet-4-5
  antigravity-opus:
    provider: antigravity
    model: claude-opus-4
  antigravity-gpt-5:
    provider: antigravity
    model: gpt-5

6.2 Claude Code 集成

# 1. Antigravity Tools 启动后
export ANTHROPIC_BASE_URL=http://127.0.0.1:8045
export ANTHROPIC_AUTH_TOKEN=dummy    # 实际由 Antigravity Tools OAuth 注入

# 2. 启动 Claude Code，所有请求走 Antigravity
claude

6.3 Codex CLI 集成

export OPENAI_BASE_URL=http://127.0.0.1:8045/v1
export OPENAI_API_KEY=dummy

codex
# GPT-* 模型请求会被 Antigravity 路由到对应 Provider

6.4 OpenClaw 集成

# ~/.openclaw/config.yaml
model_provider: antigravity
model: antigravity-sonnet

# 7x24 跑 OpenClaw 也不怕 token 过期
# Antigravity Tools 后台每 15 秒自动续期

七、调度模式与高级配置

7.1 调度模式

7.2 实验性特性

"experimental": {
  "enable_signature_cache": true,        // 缓存 function call signature
  "enable_tool_loop_recovery": true,     // Agent 死循环自动恢复
  "enable_cross_model_checks": true,     // 跨模型一致性校验
  "enable_usage_scaling": false,         // 用量预放大
  "context_compression_threshold_l1": 0.4, // 上下文 40% 触发 L1 压缩
  "context_compression_threshold_l2": 0.55 // 上下文 55% 触发 L2 压缩
}

💡 上下文压缩对长会话（>50K tokens）非常有用——避免频繁裁剪历史导致 Agent "失忆"。

八、装完必做的 4 件事

九、典型工作流

9.1 场景一：OpenClaw 7x24 跑

# 1. Antigravity Tools 开机自启（auto_start: true）
# 2. 配 OpenClaw
echo 'model_provider: antigravity' >> ~/.openclaw/config.yaml
# 3. 启动 OpenClaw
openclaw start
# 4. 安心睡觉——token 过期 Antigravity 自动续

9.2 场景二：多模型 A/B 对比

# 同时挂 Claude + GPT + zai GLM-4.7
# 用同一 prompt 跑三个模型对比
codex exec "实现快速排序" --output-format json | jq '.model'
# → "claude-sonnet-4-5"
# 切到 gpt-5
codex exec "实现快速排序" --model gpt-5
# → "gpt-5"
# 切到 zai 伪装 sonnet（实际 glm-4.7）
CODEX_MODEL=sonnet codex exec "实现快速排序"
# → "glm-4.7 (via zai)"

9.3 场景三：成本监控

# SQLite 查询当日用量
sqlite3 ~/.antigravity_tools/token_stats.db \
  "SELECT model, SUM(input_tokens), SUM(output_tokens)
   FROM usage
   WHERE date = date('now')
   GROUP BY model"
# 显示各模型当日 token 消耗

十、常见问题 FAQ

十一、与其他工具的关系

本文由 AI Know 基于 Antigravity IDE 1.23.2 + Antigravity Tools 4.1.33 真实配置整理。安装步骤、配置文件路径、CLI 行为均来自 ~/.antigravity_tools/ 实际数据，后续版本如有变动请以官方文档为准。

← 返回专题列表