跳到正文

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_URLhttps://api.hop-base.com
请求的接口POST /v1beta/models/{model}:streamGenerateContent?alt=sse

已在生产环境用 agy 1.5.12 实测:读写和修改文件、执行 shell 命令、并行与连续工具调用、多轮续接(--continue)、长上下文、图片输入,以及从建项目、写代码到跑测试的完整编码任务均可用。

密钥要包含 Gemini 分组:

创建密钥时选中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 / -highagy --model gemini-4-argon-medium
gemini-4-carbon-low / -medium / -highagy --model gemini-4-carbon-high
gemini-4-hydrogen-low / -medium / -highagy --model gemini-4-hydrogen-low
gemini-4-neon-low / -medium / -highagy --model gemini-4-neon-medium
gemini-3.8-flash-low / -medium / -highagy --model gemini-3.8-flash-medium

价格见模型列表。

agy 会在后台调用辅助型号:

agy 每执行一步,会额外用 gemini-3.1-flash-lite-preview 或 gemini-3.8-flash 做一次安全审核。这些请求同样计费,会出现在控制台的使用记录里。

已知限制

  • 整段输出:回答不是逐字流式返回,而是生成完后一次性返回。长回答或高思考档位时,界面会先等待一段时间再整段出现,这不是卡住。
  • -xhigh 档位暂不支持:agy 清单里的 -xhigh 后缀请改用 -high。
  • 中断仍计费:按 Ctrl+C 中断时,已经发出的那次请求仍会在服务端跑完并计费。

下一步