文章大纲目录 (Table of Contents)
随着人工智能技术的爆发式演进，开发者与 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 | bash2. 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首次运行引导流程：
- 工作区信任验证（Trust Workspace）：系统会提示确认是否信任当前工作区目录，允许工具安全读取项目文件；
- 视觉配色与主题方案：引导程序会提供多款 TUI 主题供选择（推荐 Dark+ 或 Cyberpunk 风格）；
- 渲染模式配置：根据终端性能选择 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域名在国内部分网络已被污染阻断，必须绑定你自己的自定义域名！
- 在刚刚创建的 Worker 中，进入 设置 (Settings) ➔ 触发器 (Triggers) ➔ 自定义域 (Custom Domains)；
- 添加你的二级域名，例如：
gemini.yourdomain.com； - 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 数据，说明反向代理与本地链路已彻底打通！
六、 开发者安全与避坑守则
- API Key 泄露防护：千万不要将包含
GEMINI_API_KEY的配置文件直接提交到公开的 GitHub 仓库中，务必在.gitignore中排除； - Workers 访问控制（可选）：如果担心自定义域名被他人恶意刷量，可在 Cloudflare Worker 代码中加入简单的 Header 密码验证或 IP 限制；
- 工作区权限防范：Antigravity CLI 拥有强大的终端执行权限，在包含高危删除命令（如
rm -rf）或敏感凭据的项目中，请仔细审查 Agent 提出的每一步操作。
结语
通过将 Google Antigravity CLI 的智能体交互能力 与 Cloudflare Workers 的低延迟边缘反代 相结合，你成功打造了一套完全独立、免受网络环境干扰的现代化 AI 编程工作流。
即刻在终端中键入 agy，开启你的人机结对极客之旅吧！