Antigravity CLI（agy）新手入门指南
Antigravity CLI 是 Google 在 2026 年推出的终端 AI 编程智能体，命令名为 agy，是 Gemini CLI 的官方继任者。它复用了 Gemini CLI 的 Agent 内核，但把重心放在「可编排」上：内置异步子代理、丰富的斜杠命令，以及在 Gemini、Claude 等多个模型之间无缝切换的能力。本指南将带你从安装、登录，到第一次会话与子代理编排，逐步上手这款工具。
迁移提示：Gemini CLI 已官宣停服并迁移到
agy，两者的会话体验与项目上下文机制基本一致（本文原记停维护日为 2026 年 6 月 18 日。[待核实：google-gemini/gemini-cli 仓库截至 2026 年 9 月仍在发稳定版且 README 无 deprecation 公告，确切时间与状态以官方公告为准]）。如果你还在使用gemini，建议尽快迁移。
第一步：快速安装 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 | iexWindows 下默认安装到 %LOCALAPPDATA%\agy\bin\（以官方为准）。安装脚本通常会自动写入 PATH，若提示 agy 命令找不到，手动把该目录加入用户 PATH 即可。
验证安装
安装完成后，运行以下命令验证：
agy --help如果看到完整的帮助信息，说明安装成功。
第二步：登录与认证
agy 支持 Google 账号登录与 API Key 两种方式。
方式一：Google 账号登录（推荐个人用户）
在终端直接运行：
agy首次启动时，
agy会自动打开浏览器，引导你完成 Google 登录与授权；授权后自动回到终端。如果你在 SSH 或无图形界面的服务器上使用，
agy会给出一个授权链接和一次性验证码，在本地浏览器中完成验证即可。
方式二：API Key / 企业凭证（适合脚本化 / 生产环境）
如果你需要在脚本或 CI 中使用，或想用启用了结算的 Google Cloud 项目获取更高配额，官方定价页给出的企业路径是绑定 Google Cloud 项目，按 Gemini Enterprise 的消耗式 API 定价计费。认证指南还覆盖企业凭证、系统钥匙串与代理配置。
环境变量方式：
[待核实：ANTIGRAVITY_API_KEY 是否仍有效。官方计费已转向 AI Credits 积分体系，入门文档未提及此环境变量，有第三方说法称直接的 API Key 计费入口已取消]
export ANTIGRAVITY_API_KEY="你的API密钥"第三步：开始你的第一次会话
启动交互模式
agy进入交互式界面后，就可以用自然语言对话了：
请解释这个项目的整体结构帮我写一个 Go 函数，从 CSV 文件读取数据并去重引用文件同样使用 @ 符号：
分析 @./src/main.ts 的代码质量并指出潜在问题一次性命令模式
只想执行单个任务时，使用 -p：
agy -p "为 @./src/utils.ts 编写单元测试"配合 --model 可以临时指定模型（官方入门指南确认的写法）：
agy --model gemini-3.1-pro -p "重构这个函数使其更易读"用 agy models 可以列出当前账号可用的全部模型。
第四步：配置项目上下文（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.8 Flash、Gemini 3.7 Flash、Gemini 3.6 Flash、Gemini 3.1 Pro、Claude Sonnet 4.6、Claude Opus 4.6 以及 GPT-OSS 120B，图像生成任务由辅助模型 Nano Banana 2 承担。官方没有固定的默认模型，需自己在模型选择器中挑选（不同订阅档位可用的模型不同）。简单任务用 Flash 省积分，复杂重构或架构设计再切换到 Pro / Opus。
在交互模式中用 /model 切换：
/model gemini-3.1-pro第六步：异步子代理与斜杠命令
相比 Gemini CLI，agy 的核心升级是异步子代理（subagents）：编排器（orchestrator）会读取你的目标，自动拆解任务，并派发拥有独立上下文窗口的子代理并行执行，从而避免单一上下文被长任务「撑爆」。
常用斜杠命令
以下命令见官方入门文档：
/help- 显示所有命令与快捷键/goal- 给定目标后自主执行到完成，中途不停下来等计划确认/grill-me- 动手前先向你连环提问，对齐方案细节/schedule- 让某条指令在未来单次或周期执行/browser- 在终端里直接配置 Chrome 调试连接/model- 切换模型/config- 调整偏好设置/credits- 查看 AI Credits 积分消耗
完整清单以会话内的 /help 输出为准。
YOLO 模式（跳过确认）
在受信任的自动化场景中，可以跳过所有工具授权确认：
agy --dangerously-skip-permissions⚠️ 该模式会跳过文件修改与命令执行的确认提示，存在误改文件、误执行命令的风险。请仅在受信任项目中使用，并配合 Git 提交点做回滚保护。如需更精细的控制，建议先在
/config与会话内/help里查找可用的权限设置，而不是一刀切跳过。
了解使用成本
免费额度
个人版（Individual）定价为每月 0 美元，通过 Google 账号登录即可获得免费速率额度（按周计），无需绑定信用卡，适合个人日常使用。可随时用 /credits 查看积分消耗。
付费 / 生产使用
当你需要更高并发或用于生产环境时，可以：
- 升级 Google AI Pro / Ultra 订阅，获得更宽松的速率限制，付费方案采用 AI Credits 积分池；
- 绑定启用了结算的 Google Cloud 项目，走 Gemini Enterprise 的消耗式 API 定价（企业路径）；
- [待核实：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: 会。并行子代理意味着同时进行多次模型调用，建议先把需求描述清楚，并用 /credits 关注消耗。