Google Antigravity 与 Gemini CLI：全平台安装部署与免费反向代理搭建终极指南

随着人工智能技术的爆发式演进，开发者与 AI 的协作方式正在从传统的网页对话框，全面转向沉浸式的本地代码库与终端交互。

Google Antigravity CLI（简称 agy） 作为 Google 推出的新一代智能体终端协作工具，通过终端用户界面（TUI）直接支持代码生成、逻辑推理、工作区任务流自动化与本地文件智能重构。配合 Google Gemini API / Gemini CLI，为开发者带来了前所未有的本地 AI 极速生产力。

然而，对于国内开发者而言，官方 API 域名（generativelanguage.googleapis.com）常因跨境网络限制导致请求超时或阻断，使得工具难以顺畅运行。

本文为你整理了一套从环境安装、基础配置，到利用 Cloudflare Workers 零成本搭建免代理专属反向代理的完整实战闭环，助你一站式彻底搞定 Google AI 终端开发环境！

一、 Google Antigravity CLI 核心特性

• 终端用户界面（TUI）：开箱即用的现代化终端美化交互，支持代码对比、状态流监控与键盘快捷键极速操作；
• 本地工作区深度绑定：直接读取本地项目上下文，执行代码修改、测试命令，安全高效；
• 支持 Gemini 2.0 / Flash 顶尖模型：极高推理速度与庞大上下文窗口，代码理解力极强。

二、 全平台一键安装指南

根据你的操作系统，在终端中执行对应的一键安装命令：

flowchart TD
    OS[选择你的操作系统] --> Linux[Linux / macOS]
    OS --> WinCMD[Windows CMD]
    OS --> WinPS[Windows PowerShell]
    Linux --> C1["curl -fsSL https://antigravity.google/cli/install.sh | bash"]
    WinCMD --> C2["curl -fsSL .../install.cmd -o install.cmd && install.cmd"]
    WinPS --> C3["irm https://antigravity.google/cli/install.ps1 | iex"]

1. Linux 与 macOS

通过官方一键 Shell 脚本安装（自动完成二进制文件下载并配置系统 PATH）：

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. Windows 平台

• 使用 PowerShell（强烈推荐）：

  irm https://antigravity.google/cli/install.ps1 | iex

• 使用传统 CMD（命令提示符）：

  curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

三、 首次启动与环境初始化

在你的代码项目根目录下执行启动命令：

agy

首次运行引导流程：

1. 工作区信任验证（Trust Workspace）：系统会提示确认是否信任当前工作区目录，允许工具安全读取项目文件；
2. 视觉配色与主题方案：引导程序会提供多款 TUI 主题供选择（推荐 Dark+ 或 Cyberpunk 风格）；
3. 渲染模式配置：根据终端性能选择 GPU 硬件加速或纯文本渲染。

四、 突破网络限制：基于 Cloudflare Workers 搭建专属免费反向代理

如果你在国内网络环境下遇到 API 报错、连接超时或无法登录 Google 账号，最稳妥、最优雅的解决方案不是开全局 VPN，而是搭建一个专属于你自己域名的 API 反向代理。

1. 为什么选择 Cloudflare Workers 反向代理？

• 零成本：Cloudflare Workers 每日提供 100,000 次免费请求额度，个人开发完全用不完；
• 极速响应：依托 Cloudflare 全球边缘计算网络，国内连接延迟极低；
• 定向专用：只代理 Google Gemini API 这一条通道，不影响设备其他任何网络流量，安全无污染；
• 免去本地复杂代理依赖：配置完成后，无论是本地终端、云服务器还是无代理环境，均可畅通调用。

2. Cloudflare Worker 核心代理脚本

进入 Cloudflare 控制台，点击 Workers 和 Pages ➔ 创建 Worker，粘贴以下经过优化的生产级代码（原生支持流式输出 Stream 与大文件上传）：

export default {
  async fetch(request) {
    const url = new URL(request.url);
    // 将请求目标重定向至 Google 官方 Gemini API
    url.hostname = "generativelanguage.googleapis.com";

    // 原样透传请求方法、请求头及数据体
    return fetch(url.toString(), {
      method: request.method,
      headers: request.headers,
      body: request.body,
      redirect: "follow"
    });
  }
};

3. 绑定自定义域名（关键步骤）

注意：默认的 *.workers.dev 域名在国内部分网络已被污染阻断，必须绑定你自己的自定义域名！

1. 在刚刚创建的 Worker 中，进入 设置 (Settings) ➔ 触发器 (Triggers) ➔ 自定义域 (Custom Domains)；
2. 添加你的二级域名，例如：gemini.yourdomain.com；
3. Cloudflare 会自动为你下发 SSL 证书并配置 DNS 解析，稍等 1~2 分钟即可生效。

五、 客户端环境变量与配置实战

1. 配置系统环境变量

获取你的官方 API Key（以 AIza 开头）后，在终端中设置以下两项环境变量：

• Linux / macOS： 将以下内容追加至 ~/.zshrc 或 ~/.bashrc：

  export GEMINI_API_KEY="你的真实API_KEY"
  export GOOGLE_GEMINI_BASE_URL="https://gemini.yourdomain.com"

  执行 source ~/.zshrc 立即生效。

• Windows PowerShell：

  [Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的真实API_KEY", "User")
  [Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://gemini.yourdomain.com", "User")

2. Antigravity CLI 专用配置

在 ~/.gemini/antigravity-cli/settings.json 中，确保指定 modelProvider 为 gemini：

{
  "modelProvider": "gemini"
}

3. 终端一键验证连通性

打开终端，执行以下 curl 测试指令：

curl "https://gemini.yourdomain.com/v1beta/models/gemini-2.0-flash:generateContent?key=你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello, test connection"}]}]}'

如果终端返回了包含 candidates 的标准 JSON 数据，说明反向代理与本地链路已彻底打通！

六、 进阶实战：工作区规则系统与 Skills 技能扩展

Antigravity 不仅是一个终端聊天工具，更是一套具备上下文记忆与任务执行能力的智能体系统：

1. 项目级规则绑定 (AGENTS.md)

在项目根目录下创建 AGENTS.md，可为当前仓库定义专属于该项目的开发准则：

# 项目级开发规范
- 技术栈：Astro + TypeScript + Tailwind CSS
- 代码风格：保持所有函数有清晰类型推断，杜绝 any
- 提交规范：采用 Conventional Commits (feat, fix, refactor)

每次在当前工作区启动 agy 时，智能体都会自动加载该规范并作为最高优先级准则执行。

2. 常用斜杠指令 (Slash Commands) 高效协作

• /plan：对于跨多文件、复杂的重构任务，输入 /plan 引导 Agent 先行输出可复核的架构执行方案；
• /compact：当会话历史过长占用上下文时，一键提炼关键状态，释放上下文窗口；
• /boost：面对棘手的算法、死锁或编译 Bug 时，激活多角度深度推理模式。

七、 常见故障排查与速查表

在本地终端与 Cloudflare 代理链路中，若遇到异常报错，可对照下表快速定位：

八、 开发者安全与避坑守则

1. API Key 泄露防护：千万不要将包含 GEMINI_API_KEY 的配置文件直接提交到公开的 GitHub 仓库中，务必在 .gitignore 中排除；
2. Workers 访问控制（密钥鉴权）：如果担心自定义域名被他人恶意刷量，可在 Cloudflare Worker 代码中加入自定义 Header 校验（如 X-Auth-Key），未携带正确密码一律返回 401 Unauthorized；
3. 工作区权限防范：Antigravity CLI 拥有强大的终端执行权限，在包含高危删除命令（如 rm -rf）或敏感凭据的项目中，请仔细审查 Agent 提出的每一步操作。

结语

通过将 Google Antigravity CLI 的智能体交互能力 与 Cloudflare Workers 的低延迟边缘反代 相结合，你成功打造了一套完全独立、免受网络环境干扰的现代化 AI 编程工作流。

即刻在终端中键入 agy，开启你的人机结对极客之旅吧！