这篇文章是 GK 的实测记录：从安装、登录到第一次让它干活，全部走了一遍。同时把国内用户最关心的地区限制问题也实测了——文末有完整结论和截图。读完这一篇，从零到上手都能搞定。
一、Antigravity CLI 是什么
Antigravity CLI 是Google 官方 AI Agent 平台家族的命令行成员。这个平台可以理解成 Google 版的 Claude Code / DeepSeek Harness：它不是单一工具，而是一整个家族——桌面 IDE（Antigravity 2.0）、命令行工具（Antigravity CLI）、浏览器插件、以及给开发者用的 SDK。
其中 Antigravity CLI 是跑在终端里的版本，安装后得到一个 agy 命令。和桌面版共享同一个 AI 内核——多步推理、读写文件、执行命令、调用工具这些能力完全一致，只是界面换成了纯键盘操作的终端界面。轻量、启动快，适合在 SSH 服务器上跑，也适合习惯终端工作的开发者。
1.1 它和 Gemini CLI 是什么关系
如果你用过 Gemini CLI，可以直接理解：Antigravity CLI 就是 Gemini CLI 的官方继任者。Google 在 2026 年 5 月 19 日宣布 Antigravity 全面开放，同时宣布 Gemini CLI 在 6 月 18 日之后停止为免费用户提供服务。
也就是说，Google 把终端 AI 助手这条产品线整体迁移到了 Antigravity。老用户迁移也很平滑：Antigravity CLI 支持一键导入 Gemini CLI 的扩展、技能和设置，登录后几分钟就能把旧环境搬过来。
二、和 DeepSeek Harness / Claude Code 怎么选
现在主流的终端 AI Agent 主要有三个流派：DeepSeek Harness（开源自部署）、Claude Code（Anthropic 官方）、Antigravity CLI（Google 官方）。三者的核心差异在模型和部署方式上：
| 对比项 | Antigravity CLI | DeepSeek Harness | Claude Code |
|---|---|---|---|
| 开发方 | Google（闭源托管） | DeepSeek（MIT 开源） | Anthropic（闭源） |
| 默认模型 | Gemini 3.8 Flash / 3.1 Pro | DeepSeek 系列 | Claude 系列 |
| 免费额度 | 有，每周刷新 | 看 API 价格，极便宜 | 无（需订阅或 API） |
| 部署方式 | 官方托管，账号登录即用 | 本地自部署，可完全自控 | 官方托管 + 本地 CLI |
| 模型可选性 | Pro/Ultra 解锁 Claude 等第三方模型 | 可配置多家模型 | 仅 Claude |
| 地区限制 | 仅支持官方名单内地区 | 无限制 | 国内直连不可用 |
| 适合谁 | Google 生态用户、终端党、SSH 场景 | 追求自控/开源/低成本的用户 | Claude 重度用户 |
一句话总结：想省心、想白嫖免费额度、已经在用 Google 生态的，选 Antigravity CLI；想完全自控、用开源方案的，DeepSeek Harness 更合适（完整上手教程我们之前写过，点这里看）。
三、安装（Mac / Windows / Linux）
安装非常简单，官方安装文档提供了一条命令的安装脚本，不需要 Node.js、不需要 Homebrew，装完直接能用。
3.1 macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash脚本会自动检测系统架构（Apple Silicon / Intel / ARM），下载对应版本，安装到 ~/.local/bin/agy，并自动把路径加进 shell 配置。GK 在 macOS 上实测，从下载到装完不到 30 秒，输出如下：
装完验证一下版本：
agy --version能输出版本号就说明装好了。这个工具更新很快：GK 实测时最新是 1.1.24，2026 年 9 月 15 日官方已发到 1.2.3——装完先跑一次 agy update 拉到最新再开始用。
3.2 Windows
Windows 用户在 PowerShell 里执行：
irm https://antigravity.google/cli/install.ps1 | iex装好后二进制在 C:Users你的用户名AppDataLocalagyin，同样会被自动加入 PATH。
四、登录：三种认证方式
Antigravity CLI 支持三种认证方式，按使用场景选：
4.1 本机登录（最简单）
在本地终端直接运行 agy，它会自动打开浏览器，用 Google 账号登录即可。登录状态存在系统钥匙串里，下次启动静默认证，不用重复登录。
4.2 SSH 远程登录（服务器场景）
在远程服务器上跑 agy 时，因为服务器没有浏览器，CLI 会走授权码流程：终端打印一个授权 URL → 你在本地浏览器打开并登录 → 浏览器显示一段授权码 → 把授权码贴回服务器终端。整个过程 1 分钟，之后服务器上就能直接用了。这对想在 VPS 上跑 AI Agent 的用户很实用。
4.3 Gemini API Key（脚本 / CI 场景）
如果你只是想写脚本调用、不想登录账号，可以用 Gemini API Key。在 AI Studio 创建 Key，然后在配置里指定用 API Key 模式：
// ~/.gemini/antigravity-cli/settings.json
{ "modelProvider": "gemini" }export GEMINI_API_KEY="你的 Key"设置好之后运行 agy，就会直接以 API Key 模式进入，不走账号登录。适合 CI、headless 跑批任务的场景。
五、第一次启动
第一次运行 agy 会有一个简短的初始化流程，三件事：
- 选择配色主题：terminal / light / tokyo night 等，后续随时能改
- 选择渲染模式：Alt-Screen（全屏独立界面）或 Inline（直接在终端历史里滚动输出）
- 确认工作区信任：确认后 Agent 才能读写当前目录的文件
初始化完成后进入主界面，顶部显示当前登录的 Google 账号、当前使用的模型（GK 实测时默认 Gemini 3.8 Flash），底部是输入框。
六、让 Agent 干第一件活
用法和 DeepSeek Harness / Claude Code 一样：在底部输入框直接说人话，Agent 会自己读代码、改文件、跑命令。官方推荐的第一个任务是让它写个脚本，比如：
写一个 Python 脚本，抓取指定网页的标题和正文文本接下来你会看到 Agent 的完整工作流：先规划步骤，然后自己创建文件、写代码、运行测试、根据报错修改，最后把结果展示给你。整个过程的每一步（计划、改动、命令输出）都会在界面上展示，你可以随时打断、纠正方向。
几个关键的交互方式：
- 改动文件前，Agent 会先展示计划，确认后才动手
- 涉及文件修改会显示 diff，让你看清楚改了哪里
- 发现 Agent 跑偏了，直接输入文字纠正，它会调整继续
- 会话是持久的，随时回来继续上一次的任务
七、核心功能与常用命令速查
下面这些是日常用得最多的功能：
| 功能 | 说明 |
|---|---|
| /goal | 让 Agent 一口气把任务做完，中途不回头问你 |
| /grill-me | 动手前先反问澄清需求，适合需求模糊的任务 |
| /schedule | 定时任务：让 Agent 在指定时间自动执行（比如每天跑一次脚本） |
| /browser | 浏览器调试模式（配合 Chrome） |
| /usage | 查看帮助手册（注意：不是查额度；官方命令目录里没有 /credits） |
| MCP 服务器 | 支持接入外部 MCP，连数据库、API 等任意工具 |
| Skills / 插件 | 自定义技能和斜杠命令，支持从 Gemini CLI 一键迁移 |
| 会话导出 | 终端会话可以直接导出到桌面版 Antigravity 2.0 继续 |
另外几个值得记的：/boost、/teamwork-preview 只有付费计划可用；1.2.0 加了 remote-control 常驻后台服务；1.1.28 起”读取 URL”的默认权限从总是允许改成了先询问——自动化脚本会因此多一步确认，可用权限设置调回去。
其中 /schedule 定时任务是 Antigravity 区别于大多数终端 Agent 的亮点：别的 Agent 都是”你叫它才干活”，它可以让 Agent 自己按计划干活，适合”每天自动整理日志””每周自动巡检”这类重复场景。
八、免费额度与套餐
这是很多人最关心的。Antigravity 没有一刀切的付费墙，而是”免费额度 + 可选订阅”的模式：
| 套餐 | 价格 | 额度 |
|---|---|---|
| 免费（Individual） | $0 | 可使用 Gemini 3.1 Pro、3.8 Flash 等核心模型，额度每周刷新 |
| Google AI Pro | 订阅制 | 额度更高，每 5 小时刷新，支持购买 AI Credits 超额 |
| Google AI Ultra | 订阅制 | 最高额度，解锁 Claude 等第三方模型 |
几个 GK 实测后的理解：
- 免费层不是摆设：Gemini 3.1 Pro 和 3.8 Flash 都是正经旗舰模型，不是拿小模型糊弄你
- 额度按”工作量”算：官方说明额度消耗和任务复杂度挂钩，简单任务能跑很多次，复杂任务消耗快
- 不支持自带 Key 提额：官方明确说了没有 BYOK 通道，额度用完要么等刷新、要么买 AI Credits 或升级
- 政策变得快：额度规则、模型阵容都在快速调整中，具体以官网为准
九、重要：地区限制（实测）
写这篇文章之前，GK 以为 Antigravity 和 Gemini 网页版一样，能访问 Google 就能用。实测下来发现不是——Antigravity 有严格的地域限制，只对官方名单内的国家/地区开放。
9.1 实测过程
GK 在 macOS 上装好 CLI、完成 Google 账号登录后，界面上直接弹出了资格检查失败提示：
Eligibility check failed: Your current account is not eligible for Antigravity, because it is not currently available in your location.
翻译过来就是：你的账号当前所在地区不在支持名单内，无法使用 Antigravity。
9.2 官方支持的地区
根据 Google 官方文档，Antigravity 目前对美洲、欧洲、非洲、亚太等地区的数百个国家开放，但中国大陆不在名单内。亚太地区可用的主要国家和地区包括：日本、新加坡、韩国、台湾、印度、澳大利亚等。
这里要特别提醒：中国香港目前也不在支持名单内。GK 最初以为用香港网络环境就能绕过，查了官方名单后确认不行。也就是说，这个问题不是换个网络出口就能解决的，取决于账号归属地区的判定。
9.3 国内用户怎么办
坦率地说，截至本文写作时，对国内用户没有官方渠道可用。现实的选择有三个：
- 等开放：Google 的服务经常逐步扩大地区，Antigravity 才发布几个月，后续开放中国大陆不是没可能
- 使用支持地区的网络环境与账号：有海外条件的用户可以正常使用（判断标准是账号被判定为支持地区）
- 先用替代方案：DeepSeek Harness 没有任何地区限制，国内直连可用，是当前最务实的选择
这个限制是”政策状态”而不是”技术限制”，随时可能变化。文章会持续跟进，开放了 GK 第一时间更新。
十、总结
最后做个总结。Antigravity CLI 本身是个完成度很高的终端 AI Agent：安装一条命令、免费额度真实可用、默认模型是 Gemini 3.8 Flash 和 3.1 Pro、支持定时任务和 MCP，还能从 Gemini CLI 无缝迁移。如果你是 Google 生态用户、有海外网络条件，它值得一试，尤其是想在服务器上跑 Agent 的场景。
但对国内用户，目前最大的门槛不是工具本身，而是地区限制。在 Google 开放中国大陆之前，国内直连可用的 DeepSeek Harness 依然是更务实的选择（DeepSeek Harness 完整教程）。
这篇文章会持续更新。有变化（开放地区、额度政策、新功能），GK 都会同步进来。
另外两套主流方案也有实测教程：Claude Code + DeepSeek（Anthropic 系）和 Codex Mac DeepSeek（OpenAI 系）。
