---
url: /antigravity/cli-using.md
description: 了解 Antigravity CLI（agy）的配置系统、快捷操作技巧以及默认按键绑定，实现高效的终端 TUI 键盘流操作。
---

# 使用 Antigravity CLI (Using AGY CLI)

## 设置 (Settings)

Antigravity CLI 提供了一个灵活的配置系统，用以自定义工作空间行为、安全限制、编辑器偏好、视觉风格和性能表现。

* **配置文件**：存储在纯 JSON 文件 `~/.gemini/antigravity-cli/settings.json` 中。
* **设置面板**：输入 `/config` 或 `/settings` 打开全屏覆盖菜单，其中列出了所有可用选项。
  * 选择某项设置以打开其选项列表或文本输入框。
  * 修改后将立即保存到磁盘，并返回到主列表。
* **命令行覆盖 (Overrides)**：某些设置可以在启动时通过 CLI 参数进行覆盖（例如 `--sandbox` 或 `--dangerously-skip-permissions`）。
  * 设置菜单中会显示一个指示器，标明覆盖参数的来源（例如：`Sandbox Mode on overridden by --sandbox`）。
  * 您仍然可以修改磁盘上的持久化设置，但当前会话将强制执行命令行覆盖，直到重启。

## 快捷技巧 (Quick Tips)

| 操作/功能 (Action/Feature) | 技巧/命令 (Tip/Command) |
| :--- | :--- |
| **自动补全文件路径** | 输入 `@` 触发路径建议建议 |
| **清空 Prompt** | 输入 `esc esc` 清空您的 Prompt 输入框（在没有活跃的流式输出时） |
| **执行终端命令** | 在 Prompt 最开头使用 `!` 以直接运行终端命令 |
| **帮助** | 输入 `?` 获取帮助并列出所有斜杠命令 |
| **减少工具调用产生的噪音** | 在 `/config` 中将详细程度 (verbosity) 设置为 `low`，以尽量减少来自大量工具调用的输出 |
| **管理权限** | 通过 `/config` 或 `/permissions` 控制权限 |
| **回退对话历史** | 使用 `/rewind` 或 `/undo` 回退对话历史记录 |
| **分支对话 (Fork)** | 使用 `/fork` 启动一个独立的工作空间，并从先前的某个时间点分支对话 |
| **清空对话** | 使用 `/clear` 清空输入框并开始一个新的对话会话 |
| **恢复对话** | 使用 `/resume` 列出并恢复以前的对话日志 |
| **自动保存恢复** | 当您关闭 CLI 时，它会自动打印出恢复该特定会话所需的精准命令 |

## 按键绑定 (Keybindings)

AGY CLI 允许自定义按键绑定。您可以通过输入 `/keybindings` 或直接修改 JSON 文件来进行编辑。

* **文件路径**：`~/.gemini/antigravity-cli/keybindings.json`。
* **重置默认**：要重置为默认值，只需删除 `keybindings.json` 文件即可。

### 默认按键绑定 (Default Keybindings)

| 操作/命令 (Action/Command) | 按键 (Keys) | 用途 (Purpose) |
| :--- | :--- | :--- |
| **清空 TUI 屏幕** | `ctrl+l` | 清除终端输出 |
| **回车 / 提交** | `enter` | 提交 Prompt 或确认选择 |
| **Escape / 取消** | `ctrl+c`, `esc` | 停止流式输出、关闭菜单或清空输入框 |
| **退出 CLI** | `ctrl+d` | 终止 CLI TUI 会话 |
| **挂起 CLI** | `ctrl+z` | 将 CLI 会话推送到终端后台运行 |
| **编辑命令** | `e` | 打开编辑器以编辑提议的终端命令 |
| **确认否定 (No)** | `n` | 拒绝终端命令的执行 |
| **确认肯定 (Yes)** | `y` | 批准终端命令的执行 |
| **打开外部编辑器** | `ctrl+g` | 在您默认的 Shell 编辑器中编辑 Prompt |
| **粘贴文本** | `ctrl+v` | 从剪贴板粘贴文本 |
| **重做文本编辑** | `ctrl+shift+z` | 重做上一次撤销的文本修改 |
| **撤销文本编辑** | `ctrl+_`, `ctrl+shift+-` | 撤销上一次文本修改 |
| **复制 (Yank)** | `ctrl+y` | 复制选中的文本 |
| **向下导航** | `down` | 在菜单列表中向下滚动 |
| **跳转至底部** | `ctrl+end` | 将 TUI 视图直接跳转至最底部 |
| **跳转至顶部** | `ctrl+home` | 将 TUI 视图直接跳转至最顶部 |
| **向左导航** | `left` | 向左移动 Prompt 光标 |
| **向下翻页** | `pgdown`, `shift+down` | 在 TUI 中向下翻页滚动 |
| **向上翻页** | `pgup`, `shift+up` | 在 TUI 中向上翻页滚动 |
| **向右导航** | `right` | 向右移动 Prompt 光标 |
| **Tab / 聚焦** | `tab` | 自动补全选择项或切换组件焦点 |
| **向上导航** | `up` | 在菜单列表中向上滚动 |
| **插入换行** | `alt+enter`, `ctrl+j`, `shift+enter` | 在 Prompt 中增加换行而不提交 |

您可以在 JSON 文件中将单个操作映射到多个按键绑定。若要禁用按键绑定，请将列表设置为空（例如 `[]`）。如果文件格式错误，CLI 将使用有效的部分，并在损坏的操作上回退到默认设置。

> \[!WARNING]
> **重要提示**：按键绑定 `cli.exit` 和 `cli.enter` 无法被禁用。