Antigravity CLI

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 đặtSao chép liên kết neo

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

macOS / LinuxSao chép liên kết neo

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

Windows (PowerShell)Sao chép liên kết neo

irm https://antigravity.google/cli/install.ps1 | iex

Windows (CMD)Sao chép liên kết neo

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Kiểm tra cài đặtSao chép liên kết neo

agy --version

Cấu hìnhSao chép liên kết neo

Bật chế độ API KeySao chép liên kết neo

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

{
  "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ườngSao chép liên kết neo

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 minhSao chép liên kết neo

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ặpSao chép liên kết neo

• 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 ýSao chép liên kết neo

• 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 quanSao chép liên kết neo

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