Mr.Nine 的技术笔记

Appearance

安装与准备 ​

Antigravity CLI 是 Google 官方的 AI 编程助手命令行工具，基于 Gemini 模型，使用 Go 编写的原生二进制程序。

⚠️ 前置条件（必须满足） ​

在开始安装之前，请确保您已具备以下条件：

系统要求 ​

  • 操作系统：
    • macOS 12 (Monterey) 或更高版本（不支持 x86 架构）
    • Windows 10 (64-bit) 或更高版本
    • Linux（glibc >= 2.28，glibcxx >= 3.4.25，如 Ubuntu 20、Debian 10、Fedora 36、RHEL 8）

账号准备 ​

  • Google 账号：支持免费版、Pro、Ultra 或 Code Assist Standard/Enterprise

网络环境 ​

  • 可访问 antigravity.google（下载安装脚本）
  • 可访问 accounts.google.com（Google 账号登录）
  • 或配置了可用的代理服务器

重要提醒

如果您无法满足上述任何一个条件，请先解决相关问题再继续安装。

快速安装 ​

macOS / Linux ​

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

Windows PowerShell（以管理员身份运行） ​

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

Windows CMD ​

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

安装器会自动检测系统环境，将二进制文件（命令名为 agy）安装到：

  • Unix 系统：~/.local/bin/
  • Windows 系统：%LOCALAPPDATA%\Antigravity\

如果安装目录不在 PATH 中，安装器会提示需要添加的环境变量配置。

验证安装 ​

重启终端后，执行以下命令验证安装：

bash
agy --version

如果显示版本号，说明安装成功。

命令名称

Antigravity CLI 的命令名是 agy，不是 antigravity。

认证与登录 ​

首次使用需要通过 Google 账号登录：

bash
agy auth login

该命令会打开浏览器，引导您完成 Google OAuth 登录流程。认证信息会自动保存，后续使用无需重复登录。

启动 ​

完成登录后，在任意项目目录中启动 Antigravity CLI：

bash
agy

可用模型 ​

模型特点
gemini-3.5-flash快速响应，适合日常任务
gemini-3.1-pro强大能力，适合复杂任务
bash
# 指定模型
agy --model gemini-3.1-pro

常用参数 ​

参数说明
--model指定使用的模型
--continue继续最近的会话
--conversation <id>恢复指定会话
--dangerously-skip-permissions跳过权限确认（谨慎使用）

查看完整参数列表：

bash
agy --help

MCP 服务配置 ​

Antigravity CLI 支持 Model Context Protocol (MCP)，通过编辑配置文件添加 MCP 服务器。

配置文件位置 ​

  • 全局配置：~/.gemini/antigravity-cli/mcp_config.json
  • 项目配置：<项目根目录>/.agents/mcp_config.json

配置格式 ​

json
{
  "mcpServers": {
    "服务器名称": {
      "command": "可执行文件路径",
      "args": ["参数1", "参数2"],
      "env": {
        "环境变量名": "值"
      }
    }
  }
}

配置示例 ​

stdio 传输方式 ​

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

HTTP 传输方式 ​

json
{
  "mcpServers": {
    "deepwiki": {
      "serverUrl": "https://mcp.deepwiki.com/mcp"
    }
  }
}

字段说明

  • stdio 传输：使用 command、args、env（可选）、cwd（可选）
  • HTTP 传输：使用 serverUrl、headers（可选）、authProviderType（可选）
  • 不支持旧版字段 url 或 httpUrl，必须使用 serverUrl

查看已连接的 MCP 服务 ​

在 Antigravity CLI 会话中输入：

/mcp

相关链接 ​