Antigravity CLI 和 Gemini CLI 是什么关系

Antigravity CLI（命令名 agy）是 Google 在 2026 年推出的终端编程智能体，是 Gemini CLI 的官方继任者。Gemini CLI 已于 2026 年 6 月 18 日停止维护，老用户建议迁移到 agy。agy 复用了同一套 Agent 内核，并新增异步子代理、斜杠命令编排和多模型切换能力。

Antigravity CLI 有免费额度吗

有。预览阶段 agy 通过 Google 账号登录即可获得较为慷慨的免费速率额度，无需绑定信用卡。若需要更高的并发与配额用于生产环境，则需要切换到启用了结算的 Google Cloud 项目，或配置 ANTIGRAVITY_API_KEY 使用 API 计费。

Antigravity CLI（agy）新手入门指南

约 1974 字大约 7 分钟...

Antigravity CLI 是 Google 在 2026 年推出的终端 AI 编程智能体，命令名为 agy，是 Gemini CLI 的官方继任者。它复用了 Gemini CLI 的 Agent 内核，但把重心放在「可编排」上：内置异步子代理、丰富的斜杠命令，以及在 Gemini、Claude 等多个模型之间无缝切换的能力。本指南将带你从安装、登录，到第一次会话与子代理编排，逐步上手这款工具。

迁移提示：Gemini CLI 已于 2026 年 6 月 18 日停止维护。如果你还在使用 gemini，建议尽快迁移到 agy，两者的会话体验与项目上下文机制基本一致。

第一步：快速安装 Antigravity CLI

agy 提供一键安装脚本，会自动下载对应平台的二进制文件。

macOS / Linux

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

二进制默认安装到 ~/.local/bin/，请确保该目录已加入 PATH。

Windows（PowerShell）

irm https://antigravity.google/cli/install.ps1 | iex

Windows 下默认安装到 %LOCALAPPDATA%\agy\bin\（以官方为准）。安装脚本通常会自动写入 PATH，若提示 agy 命令找不到，手动把该目录加入用户 PATH 即可。

验证安装

安装完成后，运行以下命令验证：

agy --help

如果看到完整的帮助信息，说明安装成功。

第二步：登录与认证

agy 支持 Google 账号登录与 API Key 两种方式。

方式一：Google 账号登录（推荐个人用户）

在终端直接运行：
```
agy
```
首次启动时，agy 会自动打开浏览器，引导你完成 Google 登录与授权；授权后自动回到终端。
如果你在 SSH 或无图形界面的服务器上使用，agy 会给出一个授权链接和一次性验证码，在本地浏览器中完成验证即可。

方式二：API Key（适合脚本化 / 生产环境）

如果你需要在脚本或 CI 中使用，或想用启用了结算的 Google Cloud 项目获取更高配额，可以配置环境变量：

export ANTIGRAVITY_API_KEY="你的API密钥"

企业用户也可以绑定 Google Cloud 项目，使用企业级的计费与安全策略。

第三步：开始你的第一次会话

启动交互模式

agy

进入交互式界面后，就可以用自然语言对话了：

请解释这个项目的整体结构

帮我写一个 Go 函数，从 CSV 文件读取数据并去重

引用文件同样使用 @ 符号：

分析 @./src/main.ts 的代码质量并指出潜在问题

一次性命令模式

只想执行单个任务时，使用 -p：

agy -p "为 @./src/utils.ts 编写单元测试"

配合 -m 可以临时指定模型：

agy -m gemini-3.1-pro -p "重构这个函数使其更易读"

第四步：配置项目上下文（AGENTS.md）

agy 使用项目根目录下的 AGENTS.md 作为「项目记忆」，其中的内容会被附加到每次对话的上下文中。这与 Claude Code 的 CLAUDE.md、旧版 Gemini CLI 的 GEMINI.md 作用一致，且 AGENTS.md 正逐渐成为各家工具通用的约定。

在项目根目录创建 AGENTS.md：

# MyWebApp 项目指南

## 技术栈

- 前端：React + TypeScript + Vite
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 编码规范

- 所有函数必须有 TypeScript 类型注解
- 组件名使用 PascalCase，文件名使用 kebab-case
- 每次改动后运行 `pnpm test` 确保测试通过

## 项目结构

- `/src/components/` - React 组件
- `/src/hooks/` - 自定义 Hooks
- `/src/api/` - API 调用

第五步：多模型切换

agy 最大的特点之一是不绑定单一模型。默认模型为 Gemini 3.5 Flash（速度快、适合日常编码），你也可以按需切换到更强的推理模型，甚至 Claude 系列或开源模型。

在交互模式中用 /model 切换：

/model gemini-3.1-pro

常见可选模型包括 Gemini 3.5 Flash、Gemini 3.1 Pro、Claude Sonnet、Claude Opus，以及 GPT-OSS 120B 等开源模型（以官方实际支持为准）。简单任务用 Flash 省额度，复杂重构或架构设计再切换到 Pro / Opus。

第六步：异步子代理与斜杠命令

相比 Gemini CLI，agy 的核心升级是异步子代理（subagents）：编排器（orchestrator）会读取你的目标，自动拆解任务，并派发拥有独立上下文窗口的子代理并行执行，从而避免单一上下文被长任务「撑爆」。

常用斜杠命令

/help - 显示所有命令与快捷键
/goal - 给定目标后自主执行直到完成
/grill-me - 执行前先反问你澄清需求，减少返工
/agents - 查看后台所有子代理的运行状态与进度
/model [名称] - 切换模型
/context - 查看当前上下文的 Token 占用
/usage - 查看额度与速率限制状态
/permissions - 配置细粒度的工具 / 命令授权

YOLO 模式（跳过确认）

在受信任的自动化场景中，可以跳过所有工具授权确认：

agy --dangerously-skip-permissions

⚠️ 该模式会跳过文件修改与命令执行的确认提示，存在误改文件、误执行命令的风险。请仅在受信任项目中使用，并配合 Git 提交点做回滚保护。如需更精细的控制，建议改用 /permissions 配置允许 / 拒绝清单，而不是一刀切跳过。

了解使用成本

免费额度

预览阶段，agy 通过 Google 账号登录即可获得较为慷慨的免费速率额度，无需绑定信用卡，适合个人日常使用。可随时用 /usage 查看当前额度与速率限制。

付费 / 生产使用

当你需要更高并发或用于生产环境时，可以：

绑定启用了结算的 Google Cloud 项目，获取更高速率限制；
或配置 ANTIGRAVITY_API_KEY，按所选模型的 API 价格计费。

预览期的额度与计费政策可能调整，最终以 Antigravity 官方说明为准。

常见问题解答

Q: 我之前的 Gemini CLI 配置还能用吗？ A: agy 复用了同一套 Agent 内核，会话体验与上下文机制基本一致。项目上下文建议从 GEMINI.md 迁移为 AGENTS.md（通用约定）。

Q: 我的代码会被发送到 Google 吗？ A: 会。运行期间数据会发送到 Google 的 API 进行处理，处理敏感代码前请先确认你的公司政策与 Google 的数据使用条款。

Q: 一定要用 Gemini 模型吗？ A: 不是。agy 支持用 /model 在 Gemini、Claude 及部分开源模型之间切换，可按任务难度和成本灵活选择。

Q: 子代理会消耗更多额度吗？ A: 会。并行子代理意味着同时进行多次模型调用，建议先用 /grill-me 收敛需求，并用 /usage 关注消耗。