跳到正文

Gemini CLI Antigravity 代理设置步骤

用环境变量设代理,先用 curl 测出口,再启动工具。

你在用 Gemini CLI 还是 Antigravity?

Google 自己的公告写明:2026 年 6 月 18 日起,Gemini CLI 不再为个人订阅(Google AI Pro、Ultra、个人版 Code Assist)提供服务,终端入口换成 Antigravity CLI。企业版 Code Assist 许可不受影响,付费的 Gemini API 密钥也仍可用 Gemini CLI。

所以先确认自己实际启动的是哪个、用什么方式登录。代理这一步两边是同一件事:让进程的流量走你的代理。

不同用法,代理该设在哪

不同用法,代理该设在哪
项目代理怎么设官方页面怎么说
Gemini CLI环境变量 HTTPS_PROXY(--proxy 参数已不存在)GitHub 上维护者的回复:HTTPS_PROXY 是标准做法,~/.gemini/.env 会被自动读取。
Gemini CLI + API 密钥同样的变量,密钥放在 GEMINI_API_KEY认证页:用 Google AI Studio 的密钥,不需要 Cloud 项目。
Antigravity CLI(agy)、桌面端、IDE 扩展我读到的页面没写:先试同样的环境变量,再自己验证入门页:没有代理章节。

2026 年 11 月 19 日读自 Gemini CLI 仓库讨论、官方文档和 Antigravity 入门页;Antigravity 那一行是官方没写,不代表不能用。

四步设好

  1. 第 1 步:拿到代理信息

    在「我的资产」里复制 HOST、PORT、USERNAME、PASSWORD,用 HTTP 那一行(2222 端口)。Proxy302 用同一组账号密码同时支持 HTTP 2222 和 SOCKS5 3333,但 Gemini CLI 文档没提 SOCKS。

  2. 第 2 步:先测出口

    运行下面的 curl 命令,应该打印出你买的那个 IP 和国家。不通就先按连接失败指南排查。

    预期结果 预期:ipinfo.io 返回 JSON,国家是代理所在国。

  3. 第 3 步:设置 HTTPS_PROXY

    可以只在当前终端 export,也可以写进 ~/.gemini/.env,之后每次运行都生效。如果你的版本读 HTTP_PROXY,就把它设成同一个值。

  4. 第 4 步:启动并登录

    在同一个终端里运行 gemini(或 agy)。「Sign in with Google」会打开浏览器,所以浏览器和终端必须在同一台机器上;无图形界面的服务器请改用 API 密钥。

    预期结果 预期:弹出登录页,CLI 能回答一句简单提问。

先测出口,再运行 Gemini CLI

# 1) 代理通不通?(HTTP 地址)
curl -x http://LOGIN:PASSWORD@HOST:PORT https://ipinfo.io/json

# 2) macOS、Linux、WSL:只对当前终端有效
export HTTPS_PROXY='http://LOGIN:PASSWORD@HOST:PORT'
gemini

# Windows PowerShell
$env:HTTPS_PROXY = "http://LOGIN:PASSWORD@HOST:PORT"
gemini

仅为示例:请把占位内容换成你自己的。

写进 ~/.gemini/.env 长期生效

# ~/.gemini/.env
HTTPS_PROXY=http://LOGIN:PASSWORD@HOST:PORT
HTTP_PROXY=http://LOGIN:PASSWORD@HOST:PORT

仅为示例。维护者说这个文件会被自动读取;配置页写明只用先找到的那个 .env,不会合并。

挂代理后的常见报错

登录提示 not currently available in your location

检查 出口 IP 所在国家 Gemini CLI 不支持,或者 CLI 根本没走代理。

处理 先跑 curl 看出口国家,再按官方排障页链接的可用地区列表换到支持的国家。

停止条件 代理改变不了 Google 不支持的国家或账号自身的地区,别反复换出口硬试。

unable to get local issuer certificate

检查 防火墙或代理在检查 TLS,把自己的证书放进了证书链。

处理 设 NODE_USE_SYSTEM_CA=1,或把 NODE_EXTRA_CA_CERTS 指向根证书文件的绝对路径(都来自官方排障页)。

停止条件 别把证书校验关掉。

登录页一直不弹或卡住

检查 「Sign in with Google」需要一个能连到终端的浏览器,远程或无界面的机器做不到。

处理 在本机完成登录,或者在服务器上用 Google AI Studio 的 GEMINI_API_KEY。

curl 能通,工具里不通

检查 进程没读到变量(设在了另一个终端,或者 .env 不是先被找到的那个)。

处理 在同一个终端里打印变量,改写进 ~/.gemini/.env,再运行。

停止条件 还是不行就先在普通浏览器里单独测代理,别在工具里反复试。

Antigravity:官方写了什么、没写什么

Google 的入门页列出 Antigravity 的四种用法:桌面端、agy 命令行、IDE 扩展和 Python SDK,也讲了浏览器登录,但我没找到代理页,也没有支持国家名单。

所以没有官方说法可引。合理的试法是:启动 agy 之前在终端里设同样的变量,再确认账号看到的是哪个国家;工具仍然直连的话,另一个办法是用电脑的系统代理。这两条都只是要你自己验证的做法,不保证有效。

为什么出口 IP 要固定

付费的 Gemini 订阅要在同一个地方登录、付款、连续用几周。轮换的出口每次会话换国家换网络,这和绑定在一个地方的账号需要的正好相反。

Proxy302 的静态 ISP IP 租期内不轮换:30 天 US$7.99,支持 HTTP 和 SOCKS5,没有免费试用。下单页会显示你选的国家有没有库存,也请先确认它是 Google 支持的国家。订阅那一侧的细节看下面的 Gemini 专页。

关于 Gemini CLI 和代理的问题

Gemini CLI 有 --proxy 参数吗?

没有,是有意删掉的。维护者让大家用 HTTPS_PROXY 环境变量,可以写在 ~/.gemini/.env 里。

Gemini CLI 能用 SOCKS5 代理吗?

我读到的官方页面没说支持,所以请填 HTTP 地址。Proxy302 同一组账号密码有 2222 端口的 HTTP 线路。

现在还该用 Gemini CLI 吗?

Google AI Pro、Ultra 和个人版 Code Assist 用户,2026 年 6 月 18 日起终端入口换成了 Antigravity CLI。付费 Gemini API 密钥和企业版 Code Assist 许可仍可用 Gemini CLI。

代理能解决地区报错吗?

只有出口落在 Google 对该产品支持的国家、并且 CLI 确实走了代理时才有可能。它改变不了 Google 的规则和账号自身的地区。

延伸阅读

Proxy302 在 GitHub 上公开的同主题配置指南:

参考资料

8
  1. google-gemini/gemini-cli issue 12392: the --proxy flag was removed

    外部网站资料 · 确认日期:

    Read on 19 November 2026: a maintainer answers that HTTPS_PROXY is the standard way and the home-grown proxy flag was taken out, and that the variable can be declared in ~/.gemini/.env, which is picked up automatically.

  2. google-gemini/gemini-cli pull request 13696 (closed, not merged)

    外部网站资料 · 确认日期:

    Read on 19 November 2026: a maintainer comment says the --proxy flag was removed intentionally and a proxy can be configured with an environment variable, and links the environment-variables section of the configuration docs.

  3. Gemini CLI documentation: configuration

    官方文档 · 确认日期:

    Read on 19 November 2026: .env files are looked up in the working directory, then parent directories up to the project root or home, then ~/.env; settings.json lives at ~/.gemini/settings.json; command-line arguments override environment variables. The part of the page I read does not describe proxy variables.

    The proxy variables themselves are documented only in the maintainer comments linked above.

  4. Gemini CLI documentation: authentication

    官方文档 · 确认日期:

    Read on 19 November 2026: the options are Sign in with Google, Gemini API key (GEMINI_API_KEY) and Vertex AI; Sign in with Google opens a browser on a machine that can talk to the terminal; headless mode needs a cached credential or an API key or Vertex AI configured through environment variables.

  5. Gemini CLI documentation: troubleshooting

    官方文档 · 确认日期:

    Read on 19 November 2026: the location error text ("not currently available in your location") and its cause; the NODE_USE_SYSTEM_CA=1 and NODE_EXTRA_CA_CERTS fixes for "unable to get local issuer certificate" behind a firewall that inspects TLS; the line that Gemini CLI was replaced by Antigravity CLI on 18 June 2026 for unpaid-tier and Google One users.

  6. Google Developers Blog: transitioning Gemini CLI to Antigravity CLI

    官方文档 · 确认日期:

    Read on 19 November 2026: from 18 June 2026 Gemini CLI stops serving consumer plans (Google AI Pro, Ultra, Code Assist for individuals); enterprise Code Assist licences keep access; Gemini CLI stays usable with paid Gemini and Gemini Enterprise Agent Platform API keys; Antigravity CLI is the new terminal experience.

  7. Google Antigravity documentation: getting started

    官方文档 · 确认日期:

    Read on 19 November 2026: Antigravity comes as an app, a CLI (agy), IDE extensions and a Python SDK; the app signs in through the browser; the SDK uses GEMINI_API_KEY. The page has no proxy or supported-country section.

  8. Proxy302 product facts and price list

    产品观察 · 确认日期:

    Read the Proxy302 product facts on 10 November 2026: HTTP on port 2222 and SOCKS5 on port 3333; static ISP US$7.99 for 30 days; no free trial.

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。