> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Antigravity (thử nghiệm)

> Dùng Antigravity CLI của Google trong AI dock: cài đặt, đăng nhập, giới hạn đã biết và cách sửa lỗi.

> [!WARNING]
>
> Hỗ trợ Antigravity đang ở giai đoạn thử nghiệm. Tính năng có thể thay đổi hoặc ngừng hoạt động giữa các bản phát hành của CoClip và Antigravity. Với các dự án chính, hãy ưu tiên [Claude Code](/docs/vi/ai-agents/claude-code.md), [Codex](/docs/vi/ai-agents/codex.md) hoặc [OpenCode](/docs/vi/ai-agents/opencode.md).

Antigravity CLI (`agy`) là agent dòng lệnh của Google. Trong CoClip, Antigravity chạy trong một tab **Antigravity** của [AI dock](/docs/vi/ai-agents/ai-dock.md), kèm công cụ, skill và vai trò agent của CoClip.

## Cài đặt và đăng nhập

CoClip cần Antigravity CLI **1.4.7** trở lên. CoClip không bao giờ cài hay cập nhật Antigravity. Lệnh cài do Google cung cấp; hãy xem [trang chính thức của Antigravity](https://antigravity.google) để có hướng dẫn mới nhất. Không có gói npm.

**1. Cài Antigravity CLI**

> [tab] Windows
>
> Mở PowerShell và chạy:
>
> ```powershell theme={null}
> irm https://antigravity.google/cli/install.ps1 | iex
> ```

> [tab] macOS
>
> Mở Terminal và chạy:
>
> ```bash theme={null}
> curl -fsSL https://antigravity.google/cli/install.sh | bash
> ```

**2. Đăng nhập Google một lần**

Chạy `agy` và đăng nhập bằng tài khoản Google của bạn.

**3. Mở tab Antigravity**

Trong CoClip, bấm **+** trong AI dock và chọn **Antigravity**.

Antigravity không có lựa chọn thiết lập trong **Settings**. Mọi phiên chỉ dùng công cụ, skill và agent của CoClip.

## Giới hạn đã biết

* **Giữ chế độ mặc định luôn hỏi trước.** Ở chế độ mặc định của Antigravity, mọi lệnh đều hỏi bạn trước. Đừng chuyển sang chế độ Auto hoặc sandbox: ở đó, lệnh có thể đọc các thư mục thật trong thư mục người dùng của bạn, như SSH key và cài đặt.
* **Thư mục home riêng.** CoClip chạy Antigravity trong một thư mục home Antigravity riêng, dùng chung cho mọi phiên Antigravity của CoClip. Cài đặt, MCP server, skill và agent Antigravity của riêng bạn không bao giờ được nạp hay bị thay đổi. Đăng nhập và các màn hình chạy lần đầu chỉ diễn ra một lần ở đó.
* **Công cụ đọc thư mục home sẽ bắt đầu trống.** Lệnh mà Antigravity chạy vẫn giữ tên và email git của bạn, nhưng các công cụ như `gh`, cấu hình npm và `gcloud` chạy mà không có cài đặt riêng của bạn.
* **Telemetry** theo cài đặt trong tài khoản Google của bạn.
* **Tệp trong dự án có thể tắt Antigravity.** Một số tệp agent trong thư mục dự án (hoặc thư mục cha), như hook, plugin hay tệp MCP, hoặc agent và skill đặt tên giống của CoClip, sẽ cho phép Antigravity chạy mã từ dự án. Khi đó tab báo **Antigravity is turned off for this project** và liệt kê tên các tệp đó. Hãy xoá hoặc đổi tên chúng để dùng Antigravity trong dự án. Các phiên AI khác của bạn vẫn hoạt động.
* **Bản chính mới hơn chưa được kiểm thử.** Antigravity 2.x trở lên vẫn khởi động, kèm một thông báo ở dòng đầu tiên của tab.

## Thông báo và cách sửa

| Bạn thấy gì | Cách sửa |
| - | - |
| **Antigravity CLI is not installed on this PC** (hoặc Mac) | Chạy lệnh cài ở trên, chạy `agy` một lần để đăng nhập Google, rồi bấm **Open Antigravity again**. Trình cài đặt đặt `agy` vào thư mục mà CoClip đã tự kiểm tra. |
| **Antigravity CLI … is too old for CoClip** | Chạy lại lệnh cài. Lệnh này luôn cài bản mới nhất. |
| **CoClip could not read the Antigravity CLI version** | Chạy `agy --version` trong terminal. Nếu lệnh lỗi, hãy chạy lại lệnh cài. |
| **CoClip has not been tested with Antigravity …** (dòng đầu của tab) | Phiên vẫn chạy. Nếu có lỗi, hãy dùng agent khác cho tới khi CoClip hỗ trợ phiên bản đó. |
| **Antigravity is turned off for this project** | Xoá hoặc đổi tên các tệp được liệt kê, rồi mở lại tab. |
| **Antigravity support is incomplete in this build of CoClip** | Cài lại CoClip. Xem [Cài đặt](/docs/vi/get-started/install.md). |
| Đã cài mà vẫn không tìm thấy Antigravity | Khởi động lại CoClip. |

## Trang liên quan

* [Dùng Antigravity bên ngoài editor](/docs/vi/ai-agents/outside-the-editor.md#antigravity)
* [AI log và hoàn tác](/docs/vi/ai-agents/ai-log-and-undo.md)
* [Khắc phục sự cố](/docs/vi/reference/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.