Antigravity CLI 试用教程：安装、登录授权与常见命令 ​

Google Antigravity 不只有桌面 IDE，也提供了命令行版本 Antigravity CLI。如果你平时更习惯在终端、SSH、服务器或轻量编辑器里工作，CLI 会更直接：进入项目目录，启动代理，把需求交给它，然后在终端里持续对话、审阅 diff、运行命令。

这篇文章按一次真实试用的顺序来写：安装 → 登录授权 → 第一次启动 → 常见命令 → 配置与排错。

官方入口：https://antigravity.google/product/antigravity-cli

一、Antigravity CLI 适合谁 ​

Antigravity CLI 的核心定位是：在终端里使用 Google 的 agentic coding 能力。

它比较适合这些场景：

• 你主要在终端、Vim、Neovim、SSH 或远程服务器里开发。
• 你希望 AI 直接理解当前仓库，而不是反复复制粘贴代码。
• 你想让代理执行多步骤任务，比如修 bug、补测试、跑构建、解释报错。
• 你需要在轻量环境里使用 Antigravity，而不是每次都打开完整 IDE。

简单理解：Antigravity IDE 更像完整工作台，Antigravity CLI 更像随手可召唤的终端代理。

二、安装 Antigravity CLI ​

官方提供了一键安装脚本。macOS / Linux 可以直接运行：

curl -fsSL https://agentrunner.googleapis.com/install.sh | bash

Windows CMD 可以运行：

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

安装完成后，重新打开一个终端窗口，或者按安装脚本提示刷新 shell 环境。

然后检查命令是否可用：

agy --version

如果能看到版本号，说明安装成功。

如果提示 command not found: agy，通常是 PATH 没刷新。可以先重开终端；如果还是不行，检查安装脚本输出里提示加入 PATH 的目录，并把它写入 ~/.zshrc 或 ~/.bashrc。

三、登录与授权 ​

第一次启动 Antigravity CLI 时，通常会进入登录授权流程：

agy

CLI 会在终端里提示你打开浏览器完成 Google 账号授权。按提示操作即可：

1. 复制终端里给出的登录链接，或等待它自动打开浏览器。
2. 选择要使用的 Google 账号。
3. 同意 Antigravity CLI 所需权限。
4. 回到终端，等待 CLI 显示授权完成。

如果你是在远程服务器或没有浏览器的环境里登录，CLI 一般会给出可复制的授权链接。把链接复制到本地浏览器完成授权，再回到终端继续即可。

授权成功后，CLI 会把本地配置和会话数据写入用户目录。常见位置包括：

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

后续如果遇到账号、组织、模型、快捷键或权限相关问题，可以优先检查这些配置文件，或者在 CLI 里用 /config、/keybindings 调整。

四、第一次使用：在项目目录里启动 ​

Antigravity CLI 最推荐的使用方式，是在你的项目根目录里启动：

cd ~/your-project
agy

进入交互界面后，你可以直接描述任务，例如：

帮我阅读这个项目结构，并说明本地如何启动

或者更具体一点：

修复当前测试失败的问题，先定位原因，再给我看修改计划

CLI 会读取当前目录上下文，根据你的授权范围决定是否运行命令、编辑文件或请求确认。实际使用时，建议第一次先让它做“阅读和解释”类任务，确认它理解项目结构后，再交给它修改代码。

五、常见命令和快捷键 ​

Antigravity CLI 的交互里支持一组 slash commands，也就是以 / 开头的命令。官方也支持用 ? 直接查看帮助和当前版本的完整命令列表。

1. 启动命令 ​

最常见的启动方式：

agy

如果你想在启动时覆盖当前会话的配置，可以加参数。例如跳过权限确认：

agy --dangerously-skip-permissions

这个参数的意思很直接：让代理在当前会话里尽量不再反复请求人工确认。它适合临时脚本、小型本地项目、一次性批量修改等低风险场景；不建议在生产目录、敏感仓库或包含密钥的环境里随手使用。

如果只是想开启终端沙箱，可以用：

agy --sandbox

更推荐的日常做法，是进入 CLI 后用 /permissions 调整自主等级。

2. 权限与“无需人工确认” ​

/permissions

这个命令用来选择 agent 的自主级别。官方文档里提到的典型选项包括：

如果你说的“无需人工确认”是指命令名，那重点记住两个：

/permissions -> always-proceed

以及启动参数：

agy --dangerously-skip-permissions

我的建议是：平时用 /permissions 切到 always-proceed，只有非常确定当前目录安全时，才用 --dangerously-skip-permissions。

3. 核心 slash commands ​

会话较多时，/rename <name> 很实用。例如：

/rename 修复登录页构建失败

之后再用 /resume 找回来会清楚很多。

4. 配置类命令 ​

如果工具调用输出太吵，可以进入：

/config

把 verbosity 调低。这样代理跑很多命令时，终端不会被过程日志刷屏。

5. 工具与监控命令 ​

例如打开某个文件：

/open src/main.ts

或者查看正在跑的后台任务：

/tasks

如果子代理在等你批准工具调用，可以用：

/agents

进入面板逐个查看，也可以用快捷键快速批准。

6. 输入技巧 ​

比如你想让它重点看某个文件，可以输入：

请检查 @src/auth/login.ts 里的登录逻辑

想直接运行命令，可以输入：

!npm test

7. 默认快捷键 ​

Antigravity CLI 的快捷键可以用 /keybindings 修改，也可以直接编辑：

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

常见默认快捷键如下：

还有一个很有用的子代理快捷键：

ctrl+j

当子代理等待你批准时，它可以把你从主对话直接带到下一个等待审批的子代理详情页。注意：ctrl+j 在普通输入框里也可能用于插入换行，具体行为取决于你当前所在的界面。

六、常见使用姿势 ​

1. 让它先读项目 ​

第一次进入一个陌生仓库，不要一上来就让它改文件。可以先问：

请阅读这个仓库，告诉我技术栈、启动命令、主要目录和测试方式

这样你能快速判断代理是否理解项目。

2. 让它先给计划 ​

对有风险的任务，可以要求先出计划：

我想把登录页改成邮箱验证码登录。先不要改代码，先给我实现计划和涉及文件。

确认方案后，再让它执行。

3. 让它边改边验证 ​

对 bugfix 或重构任务，建议明确要求验证：

修复这个报错，修改后运行相关测试或构建，并告诉我验证结果。

这样能减少“代码看起来对，但其实没跑过”的情况。

4. 用它处理终端型任务 ​

Antigravity CLI 很适合这些任务：

• 排查构建失败
• 解释测试报错
• 批量补充文档
• 梳理项目结构
• 生成脚本
• 查找无用代码
• 给已有代码补测试

它不只是聊天工具，更像一个能读仓库、跑命令、改文件的终端工作伙伴。

七、配置文件与更新 ​

Antigravity CLI 的配置和会话数据通常在：

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

其中快捷键配置可以直接看：

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

你可能会在这些目录里看到账号、授权、工具、快捷键或运行环境相关配置。一般不建议手动乱改，除非官方文档或错误信息明确要求。

如果后续需要更新 CLI，可以重新运行官方安装脚本：

curl -fsSL https://agentrunner.googleapis.com/install.sh | bash

然后再次检查版本：

agy --version

八、常见问题 ​

1. agy 命令找不到 ​

先重开终端，再执行：

agy --version

如果仍然找不到，检查安装脚本输出的安装目录是否已经加入 PATH。zsh 用户通常需要检查：

~/.zshrc

bash 用户通常检查：

~/.bashrc

2. 登录后终端没有反应 ​

先确认浏览器授权页面是否已经完成。如果远程环境无法自动回跳，可以回到终端看是否需要手动粘贴授权码或重新打开链接。

3. 代理没有看到某些文件 ​

可以用 /context 检查上下文，或者在提问中明确指出文件路径：

请重点阅读 src/auth/login.ts 和 tests/auth/login.test.ts

4. 命令执行权限太激进 ​

如果你担心代理直接执行高风险命令，可以在任务开始时明确限制：

这次任务先只读代码，不要修改文件，也不要运行破坏性命令。

或者使用 /mode 调整执行模式。

5. 远程服务器无法打开浏览器 ​

复制 CLI 给出的授权链接，在本地浏览器完成登录。授权完成后，再回到远程终端继续。

九、我的试用建议 ​

如果你是第一次试 Antigravity CLI，建议按这个顺序来：

1. 安装并运行 agy --version。
2. 在一个小项目里运行 agy。
3. 先让它总结项目结构。
4. 再让它修一个低风险问题，比如补 README、解释报错、添加小测试。
5. 熟悉 /help、/context、/mode、/agents 之后，再交给它更复杂的任务。

终端 AI 代理最舒服的地方是：它离你的真实开发现场很近。你不需要把问题搬到另一个网页里，它就在项目目录里，能读文件、看报错、跑命令、改代码。

Antigravity CLI 的体验重点不是“问答”，而是“让代理进入你的开发流”。只要你给它清晰目标、约束和验证标准，它就能成为一个相当顺手的命令行开发助手。

参考资料 ​

• Antigravity CLI 产品页：https://antigravity.google/product/antigravity-cli
• Antigravity CLI Getting Started：https://antigravity.google/docs/cli-getting-started
• Using AGY CLI：https://antigravity.google/docs/cli-using
• Antigravity CLI Features：https://antigravity.google/docs/cli-features