Cài đặt Google Antigravity trên macOS, Windows, Linux từng bước

TL;DR: Cài đặt Google Antigravity mất chưa tới 10 phút trên máy sạch: tải bộ cài đúng hệ điều hành từ antigravity.google/download, chạy installer, đăng nhập tài khoản Google, chấp nhận chính sách dữ liệu, chọn theme là xong. Bài này đi từng bước cho cả macOS, Windows lẫn Linux, kèm yêu cầu cấu hình và cách xử lý mấy lỗi hay gặp lúc đăng nhập.

Ở bài mở đầu series, mình đã nói Antigravity là gì và vì sao Google gọi nó là nền tảng lập trình agent-first. Giờ tới phần thực hành đầu tiên: cài đặt Google Antigravity lên máy của bạn. Nghe thì đơn giản — tải về rồi bấm Next — nhưng có vài điểm đáng lưu ý về cấu hình tối thiểu, quyền truy cập tài khoản Google và lần khởi động đầu tiên. Làm đúng ngay từ đầu sẽ đỡ mất thời gian gỡ cài lại về sau.

Chuẩn bị trước khi cài đặt Google Antigravity

Trước khi tải bộ cài, bạn cần chuẩn bị đúng ba thứ:

• Một tài khoản Google (Gmail) — Antigravity bắt buộc đăng nhập Google để dùng, kể cả gói miễn phí.
• Trình duyệt Chrome — không bắt buộc để cài, nhưng gần như bắt buộc nếu sau này bạn muốn agent tự mở trình duyệt test web (mình nói kỹ ở bài 6 về browser control).
• Kết nối internet ổn định — lần khởi động đầu tiên, ứng dụng cần mạng để xác thực tài khoản và khởi tạo model.

Theo tài liệu công bố, cấu hình tối thiểu cho từng hệ điều hành như sau:

Hệ điều hành	Yêu cầu tối thiểu
macOS	Ventura (13.0) trở lên, chạy native trên cả Intel và Apple Silicon
Windows	Windows 11 64-bit, 8 GB RAM, 2 GB ổ trống, chip x86-64 hoặc ARM64
Linux	Ubuntu 22.04 LTS hoặc distro tương thích; glibc >= 2.28, glibcxx >= 3.4.25 (Debian 10, Fedora 36, RHEL 8 trở lên đều ổn)

Mấy con số này không cao. Máy nào chạy được VS Code thoải mái thì gần như chắc chắn chạy được Antigravity. Điểm cần để ý duy nhất là RAM: 8 GB là mức tối thiểu trên Windows, còn nếu bạn định mở nhiều workspace cho nhiều agent chạy song song thì 16 GB sẽ dễ thở hơn nhiều.

Tải bộ cài từ trang chính thức

Chỉ tải Antigravity từ đúng một nơi: antigravity.google/download. Trang này tự nhận diện hệ điều hành bạn đang dùng và đề xuất bản phù hợp, nhưng bạn vẫn có thể chọn tay:

1. Mở trang download bằng trình duyệt bất kỳ.
2. Chọn hệ điều hành: macOS, Windows hoặc Linux.
3. Với macOS, bản cài dùng chung cho Intel và Apple Silicon nên không phải phân vân chọn chip.
4. Bấm tải và chờ file về máy.

Mình khuyên tránh các trang "mirror" hay link tải lại của bên thứ ba. Antigravity là công cụ có quyền chạy lệnh terminal và đọc ghi file trên máy bạn — cài từ nguồn lạ là tự rước rủi ro không đáng có.

Cài đặt trên macOS

Trên macOS, quy trình giống mọi app Mac khác:

1. Mở file .dmg vừa tải về.
2. Kéo icon Antigravity vào thư mục Applications.
3. Mở app lần đầu — nếu macOS hỏi xác nhận app tải từ internet, bấm Open.
4. Ứng dụng sẽ mở màn hình chào và bắt đầu luồng thiết lập ban đầu.

Trên Apple Silicon (M1 tới M4), app chạy native nên khởi động khá nhanh. Máy Intel cũ hơn vẫn chạy được, miễn là đã lên Ventura 13.0. Nếu bạn còn ở Monterey trở xuống thì phải nâng cấp macOS trước — installer sẽ từ chối chạy.

Cài đặt trên Windows

Với Windows 11:

1. Chạy file .exe vừa tải.
2. Installer sẽ hỏi vị trí cài — mặc định là ổ C, cần khoảng 2 GB trống.
3. Bấm qua các bước như một trình cài Windows thông thường, chờ copy file xong.
4. Mở Antigravity từ Start Menu.

Lưu ý là Antigravity chỉ hỗ trợ Windows 11 64-bit, cả chip x86-64 lẫn ARM64 (dòng Snapdragon). Windows 10 không nằm trong danh sách hỗ trợ chính thức — theo tìm hiểu của mình, có người vẫn chạy được nhưng dễ gặp lỗi lặt vặt, nên tốt nhất đừng kỳ vọng.

Nếu Windows Defender SmartScreen hiện cảnh báo "ứng dụng không xác định", kiểm tra lại đúng là file tải từ antigravity.google rồi chọn More info → Run anyway.

Cài đặt trên Linux

Linux được hỗ trợ chính thức trên Ubuntu 22.04 LTS và các distro tương thích. Điều kiện kỹ thuật là glibc >= 2.28 và glibcxx >= 3.4.25 — Debian 10, Fedora 36, RHEL 8 trở lên đều đạt. Kiểm tra nhanh phiên bản glibc:

ldd --version | head -1

Sau khi tải gói cài từ trang download:

1. Cài gói .deb bằng sudo apt install ./ten-file.deb (Ubuntu/Debian) hoặc dùng trình quản lý gói tương ứng của distro.
2. Mở Antigravity từ menu ứng dụng, hoặc gõ tên app trong terminal.
3. Luồng thiết lập ban đầu giống hệt macOS và Windows.

Nếu bạn chỉ cần agent chạy trong terminal mà không cần giao diện đồ hoạ đầy đủ, có thể cân nhắc Antigravity CLI với binary agy — nhẹ hơn hẳn, cài bằng một dòng lệnh. Nhưng với người mới, mình khuyên bắt đầu bằng bản desktop trước cho dễ hình dung.

Thiết lập lần đầu: đăng nhập và chọn cấu hình

Đây là phần khác biệt nhất so với cài một IDE truyền thống. Lần đầu mở Antigravity, bạn đi qua một luồng onboarding khoảng 5 bước:

1. Đăng nhập Google — app mở trình duyệt để bạn chọn tài khoản Google và cấp quyền. Xong sẽ tự quay về ứng dụng.
2. Chấp nhận Security and Data Use policy — đọc kỹ phần này. Nó nói rõ dữ liệu nào được gửi lên server để model xử lý. Với code nhạy cảm của công ty, bạn nên nắm rõ chính sách trước khi đồng ý.
3. Chọn theme — sáng, tối, hoặc theo hệ thống. Đổi lại sau được, chọn đại cũng không sao.
4. Cài plugin Google Developer Tools (tuỳ chọn) — hữu ích nếu bạn làm việc với Firebase, Google Cloud; người mới có thể bỏ qua.
5. Bấm Finish — vào màn hình chính.

Sau bước này, ứng dụng cần thêm một lúc để khởi tạo model lần đầu — bắt buộc có internet. Từ lần mở thứ hai trở đi thì nhanh hơn nhiều.

Một điểm mình thấy hay: nếu bạn từng dùng VS Code, Antigravity cho phép import setting và keybinding quen thuộc, vì phần Editor vốn xây trên nền tương tự. Dân chuyển từ các công cụ AI coding khác như OpenCode sang cũng sẽ thấy giao diện không quá lạ lẫm.

Xử lý lỗi thường gặp khi cài đặt Google Antigravity

Vài lỗi mình tổng hợp được từ tài liệu và các thảo luận cộng đồng:

Không đăng nhập được Google. Nguyên nhân phổ biến: trình duyệt chặn popup OAuth, đồng hồ hệ thống sai giờ, hoặc mạng công ty chặn domain xác thực của Google. Cách xử lý theo thứ tự: cho phép popup → chỉnh lại giờ hệ thống → thử mạng khác (phát 4G từ điện thoại là cách kiểm tra nhanh nhất). Nếu vẫn kẹt, thoát hẳn app và đăng nhập lại từ đầu.

Installer báo không tương thích. Gần như chắc chắn do hệ điều hành dưới mức tối thiểu: macOS dưới 13.0, Windows 10, hoặc distro Linux có glibc quá cũ. Không có cách lách chính thức — nâng cấp OS là đường duy nhất.

App mở được nhưng khởi tạo model mãi không xong. Kiểm tra kết nối internet; nếu mạng chậm, cứ để app chạy nền vài phút. Trường hợp treo hẳn, thoát app rồi mở lại — quá trình khởi tạo sẽ tiếp tục chứ không làm lại từ đầu.

Máy 8 GB RAM chạy ì ạch. Đóng bớt ứng dụng khác khi dùng, và đừng mở nhiều workspace song song. Antigravity thiết kế để điều phối nhiều agent cùng lúc, nhưng điều đó không có nghĩa máy yếu nên làm vậy.

Lỡ cài bản không phù hợp. Gỡ như một ứng dụng bình thường (kéo vào Trash trên macOS, Uninstall trên Windows, apt remove trên Linux) rồi cài lại bản đúng. Cấu hình tài khoản nằm trên cloud nên đăng nhập lại là khôi phục.

Kiểm tra nhanh sau khi cài

Trước khi sang bài sau, bạn nên xác nhận ba thứ:

• Mở app thấy màn hình chính với khung chat của agent — nghĩa là đăng nhập thành công.
• Góc giao diện hiển thị đúng tài khoản Google của bạn.
• Tạo thử một Project trống (chọn một folder bất kỳ) — nếu app cho tạo và hiện project ở sidebar trái là mọi thứ sẵn sàng.

Nếu cả ba đều ổn, phần cài đặt Google Antigravity coi như xong. Máy bạn giờ đã có đủ hai "mặt tiền" của nền tảng: Editor để code trực tiếp và Agent Manager để điều phối agent — hai khái niệm mình sẽ mổ xẻ ngay ở bài kế tiếp. Ai chưa quen quản lý code bằng Git thì nên đọc thêm bài Git cho người mới trước, vì agent của Antigravity thao tác trên repo Git rất nhiều.

👉 Bài tiếp theo: Làm quen giao diện Antigravity: Editor và Agent Manager — hiểu rõ từng khu vực màn hình trước khi giao task đầu tiên cho agent. Bạn cũng có thể xem toàn bộ series và các cụm bài khác hoặc dạo qua chuyên mục Công nghệ để đọc thêm về AI coding.