# Antigravity CLI

Nguồn: https://docs.aicentos.com/vi/clients/antigravity-cli

Language: vi

> Dùng aicentos trong Antigravity CLI —— kết nối qua chế độ API Key

Antigravity CLI là công cụ dòng lệnh do Google phát hành, hỗ trợ kết nối các dịch vụ tương thích Gemini API qua chế độ API Key. Tài liệu này giới thiệu cách cấu hình Antigravity CLI để dùng endpoint API tùy chỉnh.

## Cài đặt

Chọn cách cài tương ứng theo hệ điều hành:

### 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
```

### Kiểm tra cài đặt

```bash
agy --version
```

## Cấu hình

### Bật chế độ API Key

Sửa `~/.gemini/antigravity-cli/settings.json`, thêm vào JSON hiện có:

```json
{
  "modelProvider": "gemini"
}
```

⚠️ **Lưu ý**: chỉ đặt `GEMINI_API_KEY` sẽ không chuyển cách xác thực. `modelProvider` bắt buộc đặt là `"gemini"` chữ thường.

### Thiết lập biến môi trường

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
```

**Lưu ý quan trọng:**

* `GOOGLE_GEMINI_BASE_URL` điền địa chỉ gốc dịch vụ, đừng kèm đường dẫn API cụ thể. Endpoint bắt buộc phải tương thích Gemini API.
* `GEMINI_API_KEY` điền API Key của bạn.
* Chạy các lệnh trên trong cùng shell khởi động `agy`. CLI không đọc `.env` hay `GOOGLE_API_KEY`.

Khi cần hiệu lực vĩnh viễn, ghi hai dòng `export` vào `~/.zshrc` hoặc `~/.bashrc`.

## Khởi động và xác minh

```bash
agy --model gemini-2.0-flash
```

Sau khi trên cùng hiển thị `Gemini API key`, mở một hội thoại.

### Xử lý sự cố thường gặp

* **Vẫn yêu cầu đăng nhập**: kiểm tra `"modelProvider": "gemini"`, thoát và khởi động lại `agy`.
* **Khởi động báo thiếu Key**: đặt lại `GEMINI_API_KEY` trong shell hiện tại.
* **Yêu cầu thất bại**: kiểm tra API Key, địa chỉ gốc dịch vụ và quyền truy cập của mô hình đã chọn.

## Lưu ý

* Bắt buộc đặt đồng thời mục cấu hình `modelProvider` và biến môi trường mới dùng được chế độ API Key bình thường
* Biến môi trường cần đặt trong phiên shell khởi động CLI, hoặc ghi vào file cấu hình shell để có hiệu lực vĩnh viễn
* Endpoint dịch vụ bắt buộc phải tuân thủ chuẩn Gemini API

## Liên kết liên quan

* Tài liệu chính thức: [https://docs.aicentos.com/clients/antigravity-cli.html](https://docs.aicentos.com/clients/antigravity-cli.html)