Featured image of post 『Blog』在 macOS 优雅使用 Antigravity

『Blog』在 macOS 优雅使用 Antigravity

以 macOS 为例,无需开启 TUN,非侵入式解决 Antigravity 双网络栈代理与地区条款限制,并附 agy CLI 代理配置

背景

Antigravity 有两套不同语言写的网络栈,一个是前端与登录授权相关的 electron 网络栈,一个是与 model provider 建立双向通信的 go 网络栈。

  • 其中 electron 网络栈 trust env 接受来自系统代理提供的环境变量,常见的 proxy client 仅使用系统代理模式即可完成正常的登录授权。
  • 但与模型建立通信的网络栈不信任默认的系统代理环境变量,并在不使用特殊变量时与 provider 直连。

Antigravity 不允许服务条款受限地区的用户使用,例如中国大陆。

以上两点分别会引发两层不同的拦截,本篇文章简述如何分而治之,以非侵入的方式优雅使用 Antigravity。本文以 macOS 开发环境举例。

分而治之

网络栈问题

常见其他解决方案:

  1. 在非特殊网络环境下, Windows 个人用户通常可以使用 TUN 模式一并解决两个网络栈的不同行为问题。
  2. 在特殊局域网环境下,团队用户上游有专线或旁路由代理深层流量,能将位于个人电脑上可绕过 proxy client 的 Antigravity 流量在上游硬件层捕获然后全局送往 proxy server,本质和 TUN 一样。

如下以 macOS 个人电脑为例,介绍无法使用或不方便开启 TUN 时的处理方法。

#! /bin/zsh
# Antigravity (Proxy) launcher
# 让 Antigravity 的 Go language_server 进程继承代理环境变量,
# 使其到 aicode/cloudcode-pa 等 googleapis 的 gRPC-web 流量
# 经本机 mihomo mixed 端口出站,而不是直连。
#
# Antigravity 主进程是 Electron: Chromium/net 栈走系统代理 (OAuth 正常),
# 但 language_server (Go) 只认 *_PROXY 环境变量,不读 macOS 系统代理设置。

PROXY_URL="http://127.0.0.1:2081"

# mihomo mixed 端口不在监听时(代理未开),直接以原始环境启动,避免注入失效代理.
if nc -z 127.0.0.1 2081 >/dev/null 2>&1; then
    export HTTPS_PROXY="$PROXY_URL"
    export https_proxy="$PROXY_URL"
    export HTTP_PROXY="$PROXY_URL"
    export http_proxy="$PROXY_URL"
    export NO_PROXY="localhost,127.0.0.1,::1,*.local"
    export no_proxy="localhost,127.0.0.1,::1,*.local"
    # Antigravity LLM gateway 专用代理变量 (language_server 内部读取)
    export AGY_LLM_GATEWAY_PROXY_URL="$PROXY_URL"
fi

exec "/Applications/Antigravity.app/Contents/MacOS/Antigravity" "$@"

它的原理就是在 Antigravity 目录下起一个 zsh 脚本,非侵入,让 pull model list 的 Go 请求,能够受本机代理影响。非常优雅。注意:

  1. 在 ~/.zshrc 配置 AGY_LLM_GATEWAY_PROXY_URL 上下文环境变量无效,需要开在目标启动文件目录下才能影响 App 行为。
  2. 改成你的系统代理监听端口。
  3. Antigravity 全平台都使用同样的通信设计,如果你是其他操作系统,将本篇博客给到 AI 制作相同的代理注入代码放入正确的目录即可,该方案无侵入,只是配了个代理。

地区条款受限问题

Antigravity 登录的大致顺序是:

  1. OAuth2.0 授权
  2. 判断服务条款地区,若不满足条件,弹地区限制 warning 并拦截登入
  3. 若为满足地区服务条款的用户,尝试拉取 model list,需将该流量捕获入站并经由 proxy server 处理
  4. 获取到最新的 model list 状态,登录成功

本步骤处理的是第二步的问题。

在如下页面看一下当前账号的服务条款地区:

https://policies.google.com/terms

Google Terms 国家/地区版本|690x292

若处在非服务条款地区,例如中国大陆,需要去到如下链接提交表单修改条款地区,原因选择其他,内容自拟:

https://policies.google.com/country-association-form?client_theme=dark&source=policies-site

表单通常会在工作日数小时内批准修改,会有邮件通知。

country-association-form-preview

正常登录

可有限使用非 Gemini 4 Argon 模型。

Antigravity Model List 261104

使用 Gemini 4 Argon

需要 Google 账号有 pro 或 ultra plan。学生会员 pro 不可用,付费 plus 不可用。

Google Pro - Antigravity 简陋的 IDE 界面

agy cli

在你的 ~/.zshrc 配置如下信息,然后 source ~/.zshrc:

# == Proxy Settings == #

# -- Define --
PROXY_ENDPOINT="http://127.0.0.1:2088"
NO_PROXY_LIST="localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"

# -- Export --
export HTTP_PROXY="$PROXY_ENDPOINT"
export HTTPS_PROXY="$PROXY_ENDPOINT"
export http_proxy="$PROXY_ENDPOINT"
export https_proxy="$PROXY_ENDPOINT"
export GRPC_PROXY="$PROXY_ENDPOINT"
export ALL_PROXY="$PROXY_ENDPOINT"
export all_proxy="$PROXY_ENDPOINT"
export GRPC_ENABLE_HTTP_PROXY=1

export NO_PROXY="$NO_PROXY_LIST"
export no_proxy="$NO_PROXY_LIST"

监听端口 2088 改为你配置的。如果你是 win + gitbash,可能需要改的是 ~/.bashrc。

You will to enjoy grander sight / By climing to a greater height.