---
url: /antigravity/cli-install.md
description: 学习如何在 macOS/Linux/Windows 上安装 Antigravity CLI，并管理钥匙串静默登录及远程 SSH 身份验证流程。
---

# 安装与身份验证 (Installation & Auth)

安装 Antigravity CLI、配置企业级要求并建立受保护的经过身份验证的会话。

## 安装 (Installation)

Antigravity CLI 原生运行在 macOS、Linux 和 Windows 上。使用下面各平台对应的安装脚本来在您的系统上安装或升级该二进制文件。

### macOS 和 Linux

执行原生安装脚本以将可执行文件下载并安装到 `~/.local/bin/agy`：

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

### Windows

安装脚本会将 `agy` 二进制文件注册到您的本地用户目录：`C:\Users\<Username>\AppData\Local\agy\bin`（其中 `<Username>` 代表您活动的 Windows 用户配置文件名）。

* **PowerShell**：打开 PowerShell 并执行以下安装脚本：
  ```powershell
  irm https://antigravity.google/cli/install.ps1 | iex
  ```
* **CMD 命令行**：打开标准命令提示符并执行：
  ```cmd
  curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```

### 安装参数 (Installation flags)

执行安装脚本时，您可以附加以下自定义参数：

* `--skip-aliases`：跳过 Shell 配置中的别名清理（防止脚本清除或更新旧版的 `agy` 或 `antigravity` Shell 别名）。
* `--skip-path`：跳过 Shell 配置中追加 `PATH` 路径（防止脚本修改您的 Shell 配置中的动态环境变量）。

## 身份验证流程 (Authentication workflows)

Antigravity CLI 使用受保护的凭证和 Token 配置文件来与共享的 Agent 框架进行通信。

### 本地钥匙串静默登录 (Local silent keyring sign-in)

在本地机器上启动 `agy` 时，CLI 会尝试访问您操作系统的原生安全钥匙串（如 Apple Keychain、Linux Secret Service/dbus 或 Windows 凭据管理器）。如果找到有效的 Token 配置文件，CLI 将静默验证您的会话而无需打开浏览器。

如果未找到已保存的会话：

1. CLI 会自动启动您本地的默认浏览器。
2. 使用您经批准的账户凭据进行登录。

### 远程 SSH OAuth 流程 (Remote SSH OAuth flow)

当通过 SSH 运行时，CLI 会检测远程连接环境。由于无法启动本地网页浏览器，CLI 将发起手动的 URL 交互循环：

1. 在您的远程终端会话中启动 `agy`。
2. CLI 检测到 SSH 环境，并打印出一个唯一且安全的授权 URL。
3. 复制此 URL，并将其粘贴到本地机器的网页浏览器中。
4. 使用您经批准的凭据进行登录，完成身份验证。
5. 浏览器将显示一个唯一的字母数字授权码。
6. 复制此授权码，返回您的远程 SSH 终端，并将其粘贴进提示符中。

## 会话管理 (Managing your session)

终止会话将清除活动凭证和本地缓存目录。

### 注销登录

要断开您的账户并从操作系统的钥匙串中清除已保存的身份验证配置文件，请在 CLI 提示框中运行以下命令：

```
/logout
```

## 后续步骤 (Next steps)

完成安装和身份验证后，即可开始与您的本地 Agent 进行交互：

* **教程**：与 Agent 一起创建并运行一个基础的 Python 项目。
* **Prompting & 交互**：探索多行文本编辑、中断命令以及在终端粘贴多媒体内容。
* **权限与沙箱**：配置受保护的文件系统目录和命令限制。