Google Antigravity CLI 入门：安装登录、AGENTS.md 规则与 agy -p 无头自动化
按 Google Antigravity 官方 CLI 文档（Installation and auth、Modes、Rules、Skills、Headless mode、Permissions）：安装 agy 并用 Google 账号或 Gemini API Key 登录，在带已知 Bug 的练习项目里完成提问、修 Bug、审阅 diff 与提交；再用 AGENTS.md 和 .agents/rules 固化项目规矩、写一个 /run-tests 技能，最后用 agy -p 输出 JSON / NDJSON / JSON Schema 结构化结果，以 permissions.allow 精确放权并接入 CI。Gemini CLI 个人登录已于 2026-06-18 停用，本课也是官方推荐的迁移路线。含可抄命令与实测对照结果。
入门·2 课时·50 分钟·图文实操
免费学习无需登录
你将学会
- 用官方安装脚本在 macOS / Linux / Windows 上安装 agy，并用 agy --version、agy --help、agy models 验证
- 用 Google 账号（本机钥匙串或 SSH 授权码）或 Gemini API Key（modelProvider + GEMINI_API_KEY）完成认证
- 在项目目录开启会话：@ 引用文件、! 执行命令，在 default 模式下审阅 diff、批准命令，用 /diff 复查并提交 Git
- 掌握执行模式（default / accept-edits / plan）与 /permissions、/model、/usage、/rewind、/resume 等常用命令
- 用 AGENTS.md、.agents/rules/*.md（四种 trigger）和 .agents/skills/ 固化项目规则与流程，并了解 Gemini CLI 的迁移差异
- 用 agy -p 无头运行：text / json / stream-json、--json-schema、--continue、--model、permissions.allow 与退出码，写出可用于 CI 的脚本
适合谁
- 想在终端里用 AI 编程智能体读代码、改代码、跑测试的开发者
- 原来用 Gemini CLI 个人账号登录、需要迁移到 Antigravity 的用户
- 需要把 AI 智能体接入脚本、构建流程或 CI 的工程师
课前准备
- 年满 18 岁的 Google 账号（免费账号即可，AI Pro / Ultra 配额更高），或 Google AI Studio 的 Gemini API Key（按 API 计费）
- 位于 Antigravity 官方支持的国家和地区（2026-10-08 核对：中国大陆、香港、澳门不在列表中），可联网
- macOS、Linux、Googlebook 或 Windows（PowerShell / CMD）
- 已安装 git 与 python3；课时 2 的 JSON 示例需要 jq
课程目录
2 课时 · 50 分钟- 01安装登录与第一次任务：提问、修 Bug、审阅 diff、提交按官方 Installation and auth、Modes 与 CLI reference：安装 agy → 验证版本与帮助 → Google 账号或 Gemini API Key 登录 → 在练习项目中提问、修复 mean()/median() 边界 Bug、审阅 diff 与 /diff、提交；认识执行模式、常用斜杠命令与快捷键、模型与配额。图文25 分钟开始本课
- 02AGENTS.md 规则、技能与 agy -p 无头自动化按官方 Rules、Skills、Headless mode 与 Permissions 文档：写 AGENTS.md 与 glob 规则并验证加载、写 /run-tests 技能、Gemini CLI 迁移要点；agy -p 的 JSON 信封、JSON Schema 结构化输出、stream-json 事件、软拒绝与 permissions.allow、--continue / --model / --print-timeout，以及可放进 CI 的脚本。图文25 分钟开始本课