Antigravity CLI 使用 Gemini Key：provider 开关与端点覆盖

先认清 agy 与账户会话

Google 官方文档将 Antigravity CLI 的可执行程序称为 agy。默认启动会尝试使用系统安全钥匙串中的会话，没有可用会话时进入浏览器登录。 它与 Gemini CLI 的命令和配置位置不同，不能互换两篇教程的文件路径。

官方另外提供 Gemini API Key 路线，模型请求直接走 Gemini API，不建立账户会话，适合没有浏览器的环境。 这篇核对的是该路线与自定义 Gemini 兼容端点，不表示任何本站服务已经接入。

一个开关和一个变量缺一不可

只设置 GEMINI_API_KEY 不会切换认证模式。官方要求在 ~/.gemini/antigravity-cli/settings.json 指定 provider；仅接受 gemini 这一值。

{
  "modelProvider": "gemini",
  "toolPermission": "request-review",
  "enableTerminalSandbox": true
}

其中权限与终端沙箱键来自官方 CLI 参考。 示例是局部字段说明，应合并到现有设置，不覆盖其他内容。随后由启动进程读取密钥与地址：

export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://80321.cn"

根地址仅按 Gemini 协议展示为占位示例，不存在本文可调用的真实接口。实际版本路径、可选模型和认证规格必须先向服务方核实；此处没有配置任意 OpenAI 兼容模型的含义。

不要依赖另一个客户端的加载习惯

Antigravity 官方说明，这条路线只从环境读取 GEMINI_API_KEY，不会加载 .env 文件，GOOGLE_API_KEY 也不能替代。 因此 Gemini CLI 中可用的环境文件，对 agy 不一定有效。

启用 provider 却缺少 Key 会在启动时报错；Key 非空但无效，则可能到第一轮对话才暴露。 排查时把“启动参数齐全”和“服务端认可凭证”分开，避免因出现主界面就宣称认证成功。

一轮无头输出足够做第一关

官方提供 -p 打印模式以及 --output-format json，诊断信息写到 stderr，结果写到 stdout。 正式配置确认后可使用下列未执行的最小请求，不附加业务目录或文件。

agy -p "只返回 OK，不读取文件、不执行命令" --output-format json

不要伪造 JSON 成功样例。保存实际终态、错误消息和发生阶段；文本正常返回后，才考虑工具与更复杂任务。无头运行也需要有效认证，不能把没有浏览器误判成网络故障。

回退要同时处理模式和凭证

Key 模式没有已保存账户会话，/logout 不会清除这项认证。要恢复默认账户登录，官方要求移除 modelProvider 并重启；若只取消 Key 而保留 provider，客户端无法正常启动。 回退前保留脱敏配置差异，不上传钥匙串、账户令牌或真实密钥。权限设置与接口凭证控制的是不同风险，两者都应按最小范围配置。