Antigravity CLIGemini

Antigravity CLI 怎么用?安装、登录与额度

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

深色工作区中悬浮的发光终端窗口,下方是 Agent 球体与键盘,青色命令行光线

快速结论

这篇指南的直接答案是什么?

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;不要从不明来源下载所谓“绿色版”二进制。

  1. 1macOS/Linux:运行官方 install.sh。
  2. 2Windows:运行官方 install.ps1。
  3. 3按需加 --skip-aliases 或 --skip-path。
  4. 4运行 agy --version 确认安装。
  5. 5运行 agy update 升级到最新版。
  6. 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 和可选超额付费。配额与订阅绑定,家庭组或共享账号会共用额度池。

CLI 使用要点
项目说明注意
Gemini 模型4 Carbon/Argon/Hydrogen 等按方案可用性不同
Claude/GPTSonnet/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 后再重建,不要直接删除整个目录。

如果账号被锁定或额度显示异常,先停止重试,按账号隔离、记录错误码、官方申诉的顺序处理;不要批量注册新账号。

  1. 1agy --version 确认版本。
  2. 2检查 PATH 与安装目录。
  3. 3登录失败先 /logout 再重试。
  4. 4SSH 授权码过期就重新生成。
  5. 5额度异常查 /usage 与订阅状态。
  6. 6锁定问题记录错误码并走官方申诉。

实时商品

文章不写死站内价格。进入商品页可查看实时售卖状态;显示暂时缺货时无法下单。

查看全部商品

价格与套餐:Gemini Pro 价格:开通包与成品号

以下页面的价格、库存与售卖状态都实时读取商品数据,可作为本文的购买与核对入口。

资料来源与复核范围

套餐和功能会变化。以下官方资料已在页面最后更新时间复核;购买前仍应打开来源查看当前版本。

  1. 1. Gemini API|模型文档 ↗

    核对 Antigravity Agent 与 Gemini 3.8/4 系列模型 ID 和定位。

  2. 2. Gemini 帮助|套餐与使用限额 ↗

    核对 Gemini 应用与 Antigravity 相关额度、方案差异与限制。

  3. 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,修改前先备份。

继续阅读

查看全部 →