核心编程工具

Antigravity CLI

Google Antigravity 的命令行工具 agy，通过 Gemini 协议接入。

本文介绍 Google Antigravity 的命令行工具 agy 的接入方式。agy 只支持 Gemini 协议，需使用 Gemini 分组的密钥；Claude、GPT 模型请改用 Claude Code、Codex 等工具。桌面版 Antigravity App 不支持自定义 API Key，不在本文范围内。

1安装并确认版本

先在页面右上方选择操作系统，下面的命令会随之变化。执行安装命令：

macOS / Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

macOS 还需要把安装目录加入 PATH：

macOS

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

重新打开终端，确认能输出版本号：

终端

agy --version

2配置接入

示例中的 YOUR_API_KEY 是占位符，直接复制无法使用。登录后可选择自己的密钥，自动填入本页全部示例。

登录后填入密钥

先写入 agy 的配置文件，声明使用 API Key 方式接入。

~/.gemini/antigravity-cli/settings.json

{ "modelProvider": "gemini" }

一键写入（已配置过则跳过，否则先备份）

# 1. 写入 agy 配置文件，声明使用 API Key 方式接入；已经配置过则跳过
dir=~/.gemini/antigravity-cli
file="$dir/settings.json"
mkdir -p "$dir"
if ! grep -q '"modelProvider"[[:space:]]*:[[:space:]]*"gemini"' "$file" 2>/dev/null; then
  # 已有配置文件时先备份为带时间的 .bak
  [ -f "$file" ] && cp "$file" "$file.$(date +%Y%m%d-%H%M%S).bak"
  echo '{ "modelProvider": "gemini" }' > "$file"
fi

可能覆盖已有配置

如果 settings.json 里已经有 modelProvider 为 gemini 的设置，上面的命令不会改动它。否则会先把已有文件备份成带时间的 .bak 文件，再整体覆盖。如果你在里面配置过 MCP 或其他选项，请手动合并，只加上 modelProvider 这一个字段。手动保存时使用不带 BOM 的 UTF-8 编码。

再设置两个环境变量。命令会按你当前使用的 shell 写入对应的配置文件：zsh（macOS 默认）写入 ~/.zshrc，bash（多数 Linux 默认）写入 ~/.bashrc，只需要写入其中一个。

macOS / Linux

# 2. 把密钥和网关地址写入 shell 配置文件：zsh 用 ~/.zshrc，bash 用 ~/.bashrc（以后新开的终端自动生效）
case "$SHELL" in */zsh) rc=~/.zshrc ;; *) rc=~/.bashrc ;; esac
# 先备份，再去掉以前写入的同名变量，重复执行不会重复写入
touch "$rc" && cp "$rc" "$rc.agy.bak"
grep -v -e '^# Antigravity CLI (agy)
#39; -e '^export GEMINI_API_KEY=' -e '^export GOOGLE_GEMINI_BASE_URL=' "$rc.agy.bak" > "$rc"
echo '# Antigravity CLI (agy)' >> "$rc"
echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> "$rc"
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.keyvia.cc"' >> "$rc"
# 当前终端也立即生效，不用重新打开
export GEMINI_API_KEY='YOUR_API_KEY'
export GOOGLE_GEMINI_BASE_URL='https://api.keyvia.cc'
echo '配置完成，请进入你的项目目录，输入 agy 即可使用。'

命令执行完会提示“配置完成”。当前终端已经可以直接使用；其他已经打开的终端需要重新打开，环境变量才会生效。

注意

GEMINI_API_KEY 和 GOOGLE_GEMINI_BASE_URL 是通用变量名，同一台电脑上的 Gemini CLI、Google GenAI SDK 等工具也会读到，请求同样会走本站。密钥以明文保存，请勿把这个文件上传或分享给他人。

写入的内容前有一行 # Antigravity CLI (agy) 注释，方便日后查找。重复执行不会重复写入：命令会先把原文件备份为同名的 .agy.bak，去掉以前写入的这两个变量，再写入新值，所以更换密钥时重新执行即可。不再使用时删除注释和它下面的两行。

字段说明

GOOGLE_GEMINI_BASE_URL 填根地址，不带 /v1 或 /v1beta，路径由 agy 自己补。

modelProvider 只能填 gemini，其他值会被忽略并回到 Google 账号登录。只设置 GEMINI_API_KEY 而不写这个字段不会生效；agy 也不会读取 .env 文件。

密钥绑定的分组需支持 Gemini 协议。

3验证

进入你的项目文件夹后启动 agy：

终端

agy

首次启动先选配色方案，直接回车。
服务条款页面里回车只是勾选，需要先移到右侧的 Done 再回车。
询问是否信任当前文件夹时，选择 Yes, I trust this folder。

agy 会跳过登录页直接进入主界面，顶部显示 Gemini API key 而不是账号邮箱，即已通过密钥接入。发一条消息，回复正常并且控制台用量记录里出现这次请求，就接入成功了。

常见问题

提示 command not found：重新打开终端；macOS 请确认已执行加入 PATH 的那条命令。Windows 安装时出现红色的 ERROR: logging before google.Init 可以忽略，只要 agy --version 能输出版本号即可。
打开了 Google 登录页，或提示 authentication required：配置没有生效，重新执行第 2 步的命令并重开终端。
404 或提示模型不可用：确认密钥属于 Gemini 分组，并且所选模型在模型名称列表里。
提示 gemini-3.1-flash-lite-preview 不受支持：agy 在后台用这个模型给会话起标题，不影响正常使用，可以忽略。
提示 Invalid thought signature：新开一个会话，不要在同一个会话中途切换模型；仍然出现请提交工单并附上报错时间。
401、403、429 等状态码见错误码。