Antigravity CLI
用 Gemini API Key 和自定义 Base URL,把 Google Antigravity CLI(agy)连到 HopBase 的 Gemini 原生接口。
Antigravity CLI(命令 agy)是 Google 的终端编程代理。它支持用 Gemini API Key 登录并改写 Base URL,直接讲 Gemini 原生协议,所以不需要任何转换,把 Base URL 指向 HopBase 即可。
| 配置项 | 值 |
|---|---|
modelProvider(settings.json) | gemini |
GEMINI_API_KEY | 控制台创建的密钥 |
GOOGLE_GEMINI_BASE_URL | https://api.hop-base.com |
| 请求的接口 | POST /v1beta/models/{model}:streamGenerateContent?alt=sse |
已在生产环境用 agy 1.5.12 实测:读写和修改文件、执行 shell 命令、并行与连续工具调用、多轮续接(--continue)、长上下文、图片输入,以及从建项目、写代码到跑测试的完整编码任务均可用。
创建密钥时选中Gemini 官方直连(企业级)。agy 的主力型号与它在后台自动调用的辅助型号都在这个分组里;密钥不含该分组时会返回 404。
配置 Antigravity CLI
安装
macOS 用 Homebrew 安装:
brew install --cask antigravity-cli
agy --version其他系统按 Antigravity CLI 官方页面的说明安装。改用 API Key 与自定义 Base URL 需要 1.1.13 或更新版本。
把登录方式设为 Gemini API Key
编辑用户目录下的 ~/.gemini/antigravity-cli/settings.json(不存在就新建):
{
"modelProvider": "gemini"
}值必须是小写的 gemini。只设置环境变量而不改这一项时,agy 仍会走 Google 账号登录。
设置密钥和 Base URL
export GEMINI_API_KEY=sk-your-key
export GOOGLE_GEMINI_BASE_URL=https://api.hop-base.com想长期生效,把这两行写进 ~/.zshrc 或 ~/.bashrc。
GOOGLE_GEMINI_BASE_URL 只写根地址,不要加 /v1beta 等路径。agy 只读启动它的终端里的环境变量,不读 .env 文件,也不读 GOOGLE_API_KEY。
启动并选择型号
agy --model gemini-4-argon-medium
# 或者单次执行
agy -p "Explain this repository" --model gemini-4-hydrogen-low选择型号
agy 的型号名是「HopBase 型号 ID + 思考档位后缀」,后缀对应请求里的 thinkingLevel,档位越高思考越久、用量越多。agy models 列出的是 agy 内置清单,以下面这张表为准:
| HopBase 型号 | 可用后缀 | 示例 |
|---|---|---|
gemini-4-argon | -low / -medium / -high | agy --model gemini-4-argon-medium |
gemini-4-carbon | -low / -medium / -high | agy --model gemini-4-carbon-high |
gemini-4-hydrogen | -low / -medium / -high | agy --model gemini-4-hydrogen-low |
gemini-4-neon | -low / -medium / -high | agy --model gemini-4-neon-medium |
gemini-3.8-flash | -low / -medium / -high | agy --model gemini-3.8-flash-medium |
价格见模型列表。
agy 每执行一步,会额外用 gemini-3.1-flash-lite-preview 或 gemini-3.8-flash 做一次安全审核。这些请求同样计费,会出现在控制台的使用记录里。
已知限制
- 整段输出:回答不是逐字流式返回,而是生成完后一次性返回。长回答或高思考档位时,界面会先等待一段时间再整段出现,这不是卡住。
-xhigh档位暂不支持:agy 清单里的-xhigh后缀请改用-high。- 中断仍计费:按 Ctrl+C 中断时,已经发出的那次请求仍会在服务端跑完并计费。