---
url: /antigravity/cli-tutorial.md
description: 通过快速入门教程，学习如何使用 Antigravity CLI（agy）与自主 Agent 协作创建 Python 脚本、进行代码审查和运行终端测试。
---

# Antigravity CLI 基础教程 (Tutorial)

学习如何启动 Antigravity CLI，与自主本地 Agent 协同工作，审查生成的文件，并执行终端测试命令。

## 概述 (Overview)

本指南将引导您完成快速入门练习。您将指挥一个自主 Agent 创建一个 Python 实用工具脚本，审查其更改并验证其执行结果。

## 逐步指南 (Step-by-step)

### 1. 创建干净的项目目录并启动 Antigravity TUI

```bash
mkdir agy-demo && cd agy-demo
agy
```

> \[!NOTE]
> **首次启动**：如果首次运行 `agy`，请按照终端指令完成静默验证。如果遇到问题，请参阅 [安装与身份验证 (Installation & Auth)](/antigravity/cli-install) 以获取故障排除详情。

### 2. 提示 Agent 生成一个 Python 爬取脚本

在屏幕底部的 Prompt 输入框中输入以下指令并按回车键：

```
Write a simple python script to fetch web page text
```

Agent 会读取工作空间，确定没有任何文件存在，并制定一个创建脚本的计划。随着 Agent 进行推理并安排操作，您将看到实时的状态更新。

### 3. 打开 Artifact 审查屏幕以检查提议的代码

一旦 Agent 完成文件的生成，终端将出现通知提示。按 `Ctrl + R` 进入 Artifact Review 审查屏幕。

1. 使用 `↑/↓` 键导航到新创建 of the `main.py`。
2. 审查完整的文件内容和代码差异（diff）。
3. 按 `y` 批准创建 `main.py`。
4. 按 `Esc` 关闭审查面板并返回主对话界面。

### 4. 与 Agent 一起执行测试命令以验证输出

指示 Agent 运行 Python 脚本以验证其行为。在输入框中输入以下命令并按回车键：

```
Run the python script and show me the output
```

Agent 将提议运行 `python3 main.py`。按 `y` 确认并执行命令。Agent 会在本地运行该脚本，并将标准输出直接流式传输到您的终端屏幕中。

### 5. 退出 Antigravity 会话

完成任务后，在输入框中按 `Ctrl + D`（或输入 `/exit`）关闭 TUI 并恢复您原始的 Shell 会话。

## 后续步骤 (Next steps)

Now that you have executed your first agent-assisted workflow, learn how to configure the CLI and master core concepts:

* [安装与身份验证 (Installation & Auth)](/antigravity/cli-install)：关于安装 `agy` 和设置 SSH 配置文件的详细说明。
* **Prompting & 交互**：多行输入、粘贴媒体文件和主动中断控制的最佳实践。
* **审查 Artifacts**：深入了解“基于透明度的信任 (Trust through Transparency)”架构模式。