Antigravity CLI 怎么用?安装、登录与额度
Antigravity CLI 不是 IDE 的附属命令,而是一个独立的终端 Agent 客户端:它能在本地 Shell、远程云环境和 SSH 会话里跑 Antigravity 工作流。装好只是第一步,登录方式、模型选择和权限模式才决定它会不会在你不知情时改文件。

快速结论
这篇指南的直接答案是什么?
Antigravity CLI 的可执行文件是 agy,支持 macOS/Linux 和 Windows。安装后直接运行 agy,会优先用系统钥匙串里的凭据,否则打开浏览器登录;SSH 环境会打印授权 URL 和验证码。模型与额度随 Free、Google AI Plus、Pro、Ultra 方案变化,Gemini 与 Claude/GPT 模型分别计算周限额和 5 小时限额;用 /permissions 管理工具审批,用 /logout 退出。
购买前先记住这几点
- 可执行文件是 agy,支持本地、远程和 SSH 会话。
- 安装后运行 agy 即可登录,SSH 用 URL + 验证码。
- 模型与额度随 Free/Plus/Pro/Ultra 方案变化。
- 用 /permissions 管理工具审批与工作区范围。
- 配置默认在 ~/.gemini/antigravity-cli/settings.json。
直达入口:Google AI Pro 专区 · 帮助中心
Antigravity CLI 是什么?
Antigravity CLI 是 Antigravity 的键盘优先终端客户端,可在本地 Shell、远程云环境和 SSH 中运行 Agent 工作流。
它和 IDE 共用 Antigravity 的账号与模型体系,但交互方式变成终端命令和斜杠命令。适合远程服务器、无图形界面环境和习惯键盘操作的开发者。
官方文档把 CLI 列在 Desktop & terminal clients 中,Free、Google AI Plus、Pro、Ultra 方案都可以使用,具体可用模型和额度随方案变化。
- 终端优先,适合远程/SSH。
- 共享 Antigravity 账号与模型。
- 支持 Free/Plus/Pro/Ultra。
- 可执行文件为 agy。
怎么安装和升级?
macOS/Linux 用官方 install.sh,Windows 用 PowerShell install.ps1;安装后运行 agy --version 验证,用 agy update 升级。
官方 Quickstart 给出的 macOS/Linux 命令是 curl 安装脚本,Windows 是 PowerShell 的 irm 脚本。安装器支持 --skip-aliases 和 --skip-path,适合不想改 shell 配置的用户。
安装完成后,agy 通常在 ~/.local/bin 或 Windows 的用户目录下。若终端找不到命令,先检查 PATH;不要从不明来源下载所谓“绿色版”二进制。
- 1macOS/Linux:运行官方 install.sh。
- 2Windows:运行官方 install.ps1。
- 3按需加 --skip-aliases 或 --skip-path。
- 4运行 agy --version 确认安装。
- 5运行 agy update 升级到最新版。
- 6检查 PATH 与终端重启。
怎么登录和切换账号?
直接运行 agy,优先使用系统钥匙串;没有凭据时打开浏览器登录。SSH 环境会打印 URL 和验证码,/logout 可退出。
本地登录会打开默认浏览器完成 Google Sign-In,也支持 Gemini Enterprise 或 GCP 项目账号。SSH 环境无法打开本地浏览器时,CLI 会打印授权 URL 和验证码,在本地打开后把码贴回终端。
无头/CI 场景可以用 API Key:在设置里把 modelProvider 设为 gemini,导出 GEMINI_API_KEY,再运行 agy。也可以用 ADC:先 gcloud auth application-default login,再设置 AGY_ADC_AUTH=true。
- 本地:agy 自动打开浏览器。
- SSH:URL + 验证码。
- API Key:modelProvider=gemini + GEMINI_API_KEY。
- ADC:gcloud 登录 + AGY_ADC_AUTH=true。
- 退出:/logout。
模型和额度怎么算?
CLI 支持 Gemini 4 Carbon/Argon/Hydrogen、3.8/3.7/3.6 Flash、3.1 Pro,以及 Claude/GPT 模型;Gemini 与 Claude/GPT 分别计算周限额和 5 小时限额。
模型列表和名称会随版本更新,接入前用 /model 或官方文档确认当前可用项。高能力模型消耗更快,长周期 Agent 任务尤其明显。
Free、Google AI Plus、Pro、Ultra 的额度不同,CLI 还提到 AI credits 和可选超额付费。配额与订阅绑定,家庭组或共享账号会共用额度池。
| 项目 | 说明 | 注意 |
|---|---|---|
| Gemini 模型 | 4 Carbon/Argon/Hydrogen 等 | 按方案可用性不同 |
| Claude/GPT | Sonnet/Opus、GPT-OSS 等 | 单独限额 |
| 限额窗口 | 周限额 + 5 小时限额 | /usage 查看 |
| 额度来源 | Free/Plus/Pro/Ultra | 共享账号共用池 |
权限和安全怎么设置?
默认模式会在执行工具前请求审批;用 /permissions 管理审批模式和工作区范围,不要把 always-proceed 用在不受信任的仓库。
CLI 能执行 Shell 命令、编辑文件、访问代码库。默认的 request-review 会在关键操作前停下,proceed-in-sandbox 在沙箱内自动执行,always-proceed 风险最高,strict 限制最严。
把工作目录限定在项目根目录,不要在包含密钥、生产配置或客户数据的目录里放开自动执行。涉及网络、部署和删除操作时,保留人工审批。
- 默认用 request-review。
- 不受信任仓库不要用 always-proceed。
- 用 /permissions 查看和切换模式。
- 限定工作区目录,避免全盘访问。
- 敏感操作保留人工审批。
常见问题怎么排查?
命令找不到先查 PATH;登录失败先清钥匙串或 /logout;额度报错查 /usage 和订阅;SSH 登录失败检查授权码是否过期。
CLI 更新后命令行为可能变化,先用 agy --version 和 /changelog 确认版本。配置损坏时,备份 ~/.gemini/antigravity-cli/settings.json 后再重建,不要直接删除整个目录。
如果账号被锁定或额度显示异常,先停止重试,按账号隔离、记录错误码、官方申诉的顺序处理;不要批量注册新账号。
- 1agy --version 确认版本。
- 2检查 PATH 与安装目录。
- 3登录失败先 /logout 再重试。
- 4SSH 授权码过期就重新生成。
- 5额度异常查 /usage 与订阅状态。
- 6锁定问题记录错误码并走官方申诉。
实时商品
查看当前价格、库存与交付方式
文章不写死站内价格。进入商品页可查看实时售卖状态;显示暂时缺货时无法下单。
查看全部商品价格与套餐:Gemini Pro 价格:开通包与成品号
相关专区与价格
以下页面的价格、库存与售卖状态都实时读取商品数据,可作为本文的购买与核对入口。
资料来源与复核范围
套餐和功能会变化。以下官方资料已在页面最后更新时间复核;购买前仍应打开来源查看当前版本。
- 1. Gemini API|模型文档 ↗
核对 Antigravity Agent 与 Gemini 3.8/4 系列模型 ID 和定位。
- 2. Gemini 帮助|套餐与使用限额 ↗
核对 Gemini 应用与 Antigravity 相关额度、方案差异与限制。
- 3. Google One|Google AI 方案 ↗
核对 Google AI Plus、Pro、Ultra 的方案定位与功能范围。
常见问题
Antigravity CLI 的可执行文件叫什么?
叫 agy,安装后可以用 agy --version 验证。
SSH 环境怎么登录?
运行 agy 后会打印授权 URL 和验证码,在本地打开 URL 登录,再把验证码贴回终端。
CLI 需要订阅吗?
Free、Google AI Plus、Pro、Ultra 都可以使用,但可用模型和额度随方案变化。
怎么退出登录?
在 CLI 中运行 /logout 清除凭据。
配置文件在哪里?
默认在 ~/.gemini/antigravity-cli/settings.json,修改前先备份。