Google Antigravity — IDE để bạn ra lệnh, AI tự cất cánh
Không cần gõ từng dòng code. Bạn mô tả mục tiêu, các "agent" AI sẽ tự lập kế hoạch, viết code, mở trình duyệt để tự kiểm thử, rồi gửi lại cho bạn ảnh chụp và báo cáo để duyệt. Bài viết này giúp một người bình thường tự cài đặt và chạy được Antigravity ngay lần đầu.
Antigravity là gì?
Một IDE "agent-first": thay vì gõ code, bạn giao việc — AI tự làm hết các bước còn lại.
Google Antigravity ra mắt tháng 11/2025 cùng Gemini 3, được xây trên nền VS Code nhưng thiết kế lại để AI agent là trung tâm thay vì con người gõ từng dòng lệnh.
Khác với các trợ lý gợi ý code kiểu autocomplete, bạn chỉ cần mô tả mục tiêu bằng ngôn ngữ tự nhiên — ví dụ "tạo trang đăng nhập có kết nối cơ sở dữ liệu" — agent sẽ tự lập kế hoạch, viết toàn bộ frontend, backend, validation, mở một trình duyệt thật để kiểm thử, sau đó chụp ảnh và viết báo cáo lại cho bạn duyệt.
Hai hình thái của Antigravity
| Thành phần | Mô tả |
|---|---|
| Antigravity IDE | Bản fork VS Code đầy đủ — có editor code, quản lý agent, xem artifact. Phù hợp khi vừa code vừa giám sát AI. |
| Antigravity 2.0 (Desktop) | Ứng dụng độc lập cho macOS / Linux / Windows, chuyên điều phối nhiều agent song song trên nhiều dự án, không cần mở IDE. |
Sản phẩm hiện ở giai đoạn preview miễn phí, kèm hạn mức sử dụng Gemini 3 Pro khá rộng rãi.
Chuẩn bị tài nguyên ban đầu
Bạn không cần biết lập trình — chỉ cần máy đã có sẵn vài "đồ nghề" để agent mượn dùng.
| Công cụ | Vì sao cần | Cách kiểm tra |
|---|---|---|
| Git | Agent commit code, theo dõi thay đổi, cho bạn "undo" khi agent làm sai. | git --version |
| Node.js + npm | Hầu hết web app hiện đại (React, Next.js…) cần Node để chạy. | node -v / npm -v |
| Python 3 | Nhiều agent dùng Python để viết script, chạy thử nghiệm, xử lý dữ liệu. | python3 --version |
| Chrome | Antigravity mở một Chrome thật để agent tự test web — click nút, điền form, chụp ảnh. | Cài đặt như bình thường |
| Tài khoản Google | Đăng nhập và kích hoạt hạn mức Gemini miễn phí. | Gmail là đủ |
Mẹo cho người không chuyên: bạn không cần "biết" Node hay Python — chỉ cần đã cài đặt sẵn trên máy (bản LTS từ nodejs.org và python.org, cài theo mặc định). Antigravity sẽ tự phát hiện và dùng khi cần.
Cài đặt lần đầu
Tải bộ cài
Truy cập trang chính thức antigravity.google và tải bản dành cho hệ điều hành của bạn.
Đăng nhập Google
Mở ứng dụng và đăng nhập bằng tài khoản Google để kích hoạt hạn mức miễn phí.
Chọn Terminal Policy
Auto: AI tự chạy lệnh phổ biến, không hỏi lại. Agent Decides: AI tự quyết định khi nào cần hỏi xin phép — người mới nên chọn mục này để vừa nhanh vừa an toàn.
Import cấu hình (tuỳ chọn)
Có thể import cấu hình từ VS Code nếu bạn đã từng dùng, hoặc bỏ qua để dùng mặc định.
Những thuật ngữ bạn sẽ gặp ngay
Năm khái niệm cốt lõi giúp bạn đọc hiểu giao diện Antigravity trong 5 phút.
Editor View giống VS Code truyền thống — bạn thấy code, có thể tự sửa tay, theo dõi 1 agent đang làm việc trên 1 project. Manager View là bảng điều khiển trung tâm, hiển thị nhiều agent chạy song song (tối đa khoảng 5) trên nhiều dự án khác nhau — như đang quản lý một nhóm "nhân viên ảo".
Plan Mode: agent lập một "Plan Artifact" chi tiết trước khi làm — phù hợp task phức tạp, nhiều bước, cần bạn duyệt trước. Fast Mode: agent thực thi ngay, phù hợp sửa lỗi nhỏ hoặc thay đổi nhanh không cần giám sát kỹ.
Vì agent làm việc tự động, Antigravity tạo ra các Artifact để bạn kiểm tra mà không cần đọc từng dòng code: danh sách công việc, ảnh chụp màn hình ứng dụng đang chạy, video agent tự test, và báo cáo markdown tóm tắt thay đổi. Bạn chỉ cần xem Artifact để duyệt hoặc yêu cầu sửa lại.
Một agent con chuyên dụng, mở một Chrome thật để tương tác với ứng dụng đang xây — click nút, gõ vào ô input, kiểm tra lỗi console — nhờ vậy agent tự phát hiện và sửa bug UI mà bạn không cần mở DevTools.
Antigravity xây dần một "kho hiểu biết" về codebase của bạn — quy ước đặt tên, cấu trúc thư mục, phong cách code — giúp những lần sau agent hiểu dự án nhanh và chính xác hơn.
Token là gì và vì sao cần quan tâm?
Token là đơn vị đo lượng văn bản AI đọc và viết ra — và cũng là thứ quyết định hạn mức miễn phí của bạn.
Một cách hình dung đơn giản: 1 token ≈ khoảng 3/4 một từ tiếng Anh, và thường ngắn hơn với tiếng Việt có dấu do cách mã hoá ký tự. Mỗi lần agent đọc prompt của bạn, đọc code trong project, suy nghĩ (reasoning), viết code mới, viết báo cáo — tất cả đều tiêu tốn token.
Vì sao quan trọng với người dùng phổ thông?
- Hạn mức miễn phí được tính theo token (hoặc số lượt request quy đổi). Task phức tạp, project lớn → tốn nhiều token hơn → chạm giới hạn nhanh hơn.
- Cửa sổ ngữ cảnh (context window): tổng số token tối đa agent có thể "nhớ" trong một lần làm việc, bao gồm cả toàn bộ code liên quan. Project càng lớn, càng dễ đầy context.
- Mẹo tiết kiệm: chia nhỏ yêu cầu thành các task rõ ràng, cụ thể; dùng Fast Mode cho việc nhỏ; tránh để agent "đọc" toàn bộ project nếu không cần thiết.
Skill và Plugin khác nhau thế nào?
Hai khái niệm dễ nhầm — nhưng chỉ cần một câu để phân biệt.
Là các bộ hướng dẫn/quy trình chuyên biệt mà agent tham khảo trước khi làm một loại việc cụ thể — ví dụ "cách tạo file Word chuẩn", "cách tạo slide PowerPoint", "cách đọc file PDF". Giúp kết quả chuyên nghiệp và đúng chuẩn hơn, thay vì agent "đoán" cách làm. Người dùng nâng cao có thể tự viết Skill riêng để dạy agent quy trình đặc thù của mình.
MCP server giúp agent kết nối với công cụ và dịch vụ bên ngoài: trình duyệt, Git, cơ sở dữ liệu, Slack, Jira, Google Drive… Mỗi MCP cấp cho agent một bộ "công cụ" cụ thể. Bạn có thể bật/tắt tuỳ nhu cầu — bật càng nhiều, agent càng "có tay" để làm nhiều việc, nhưng cần cân nhắc về bảo mật.
Tóm gọn: Skill = agent biết làm như thế nào cho đúng chuẩn. Plugin/MCP = agent có thể làm gì, kết nối tới đâu.
Khi nào dùng IDE, khi nào dùng Manager?
Không phải lúc nào cũng cần mở IDE đầy đủ — hãy chọn theo cách bạn muốn theo dõi công việc.
Dùng Editor View (IDE)
- Bạn muốn xem trực tiếp code đang được viết, sửa tay song song với agent.
- Đang làm một project, một task tại một thời điểm, cần kiểm soát chi tiết.
- Cần xem chi tiết kết quả của một agent cụ thể.
Dùng Manager View / 2.0
- Cần giao nhiều việc cho nhiều agent chạy song song trên nhiều project khác nhau.
- Bạn không biết code, chỉ muốn "ra đề bài" và nhận kết quả, kiểm tra sau.
- Làm việc qua terminal/CI/CD — cân nhắc Antigravity CLI/SDK.
Nguyên tắc đơn giản: IDE phù hợp khi bạn muốn "ngồi cạnh" agent và xem từng bước; Manager phù hợp khi bạn muốn "giao việc rồi quay lại kiểm tra kết quả sau".
Các agent / model miễn phí
Trong giai đoạn preview, Antigravity tích hợp sẵn nhiều model mạnh — không cần thêm API key.
Gemini 3 Pro — model chủ lực, mạnh về suy luận, lập trình và lập kế hoạch dài.
Gemini 3.5 Flash — tối ưu tốc độ, phản hồi nhanh, phù hợp task nhỏ và lặp lại.
Claude Sonnet 4.6 — cân bằng tốc độ và chất lượng, phù hợp công việc hàng ngày.
Claude Opus 4.6 (tuỳ hạn mức) — mạnh hơn cho task phức tạp, đòi hỏi suy luận sâu.
Bạn có thể chuyển đổi qua lại giữa Gemini và Claude ngay trong Antigravity mà không cần thêm API key — vì cả hai đều được tích hợp sẵn trong gói preview.
Hạn mức miễn phí có thể thay đổi theo chính sách của Google — luôn kiểm tra mục Settings/Billing trong app để biết hạn mức hiện tại.
Thêm Claude (API riêng), OpenAI, DeepSeek, Qwen…
Antigravity cho phép kết nối tới bất kỳ provider tương thích chuẩn OpenAI-compatible API.
Bước thực hiện chung
Lấy API Key từ provider
OpenAI tại platform.openai.com · DeepSeek tại platform.deepseek.com · Qwen qua DashScope console · Claude tại console.anthropic.com
Mở Settings → Models / Providers
Chọn "Add Custom Provider" (hoặc "OpenAI-Compatible API").
Điền Base URL, API Key, Model name
Theo mẫu chung bên dưới cho từng provider.
Gửi tin nhắn thử
Nếu nhận phản hồi là đã kết nối thành công. Nếu lỗi xác thực — kiểm tra lại API Key còn hạn mức và Base URL đúng định dạng (thường kết thúc bằng /v1).
Mẫu cấu hình theo provider
Base URL : https://api.deepseek.com/v1 API Key : <DEEPSEEK_API_KEY> Model name: deepseek-chat // bản chat thường deepseek-reasoner // bản có suy luận (reasoning)
Base URL : https://dashscope.aliyuncs.com/compatible-mode/v1 API Key : <DASHSCOPE_API_KEY> Model name: qwen-plus / qwen-max / qwen3-coder...
Base URL : https://api.openai.com/v1 API Key : <OPENAI_API_KEY> Model name: gpt-5 / gpt-5-mini...
Base URL : https://api.anthropic.com API Key : <ANTHROPIC_API_KEY> Model name: claude-sonnet-4-6 / claude-opus-4-6
Lưu ý: tính năng "Custom Provider" có thể thay đổi theo từng phiên bản Antigravity. Một số cộng đồng dùng proxy trung gian (công cụ mã nguồn mở của bên thứ ba) để "ép" Antigravity dùng model ngoài — các công cụ này không do Google chính thức hỗ trợ. Nếu bạn không phải lập trình viên, nên ưu tiên dùng model tích hợp sẵn (Gemini, Claude) để đơn giản và an toàn hơn, chỉ thêm provider ngoài khi đã quen với việc quản lý API key.
Quy tắc an toàn khi dùng
Agent có thể tự chạy lệnh terminal, đọc/sửa file, truy cập internet qua trình duyệt — hãy ghi nhớ vài điều.
Một file văn bản (README, comment trong code…) có thể chứa "lệnh ẩn" đánh lừa agent làm việc ngoài ý muốn. Luôn xem lại Artifact/báo cáo trước khi cho agent tiếp tục với thao tác nhạy cảm.
Trước khi để agent làm việc lớn, hãy tạo một commit ban đầu trong Git. Nếu agent đi sai hướng, bạn có thể revert (hoàn tác) trong vài giây.
Không chia sẻ API key của bạn. Nếu dùng proxy của bên thứ ba, hiểu rằng dữ liệu có thể đi qua máy chủ trung gian.
Với task quan trọng, chọn chế độ yêu cầu agent dừng lại để bạn duyệt trước khi thực thi lệnh terminal hoặc deploy.
Lịch trình bắt đầu — 5 bước
Đi từ T-5 đến cất cánh: từ cài đặt máy đến khi có kết quả đầu tiên trong tay.
Cài đặt
Cài Node.js, Python, Git, Chrome → cài Antigravity từ antigravity.google → đăng nhập Google.
Cấu hình ban đầu
Chọn Terminal Policy = Agent Decides; import hoặc bỏ qua cấu hình VS Code.
Thử việc nhỏ trước
Mở một project mới, dùng Fast Mode, yêu cầu một việc đơn giản — ví dụ "tạo một trang web giới thiệu cá nhân".
Xem Artifact
Kiểm tra ảnh chụp/báo cáo agent tạo ra, duyệt hoặc yêu cầu chỉnh sửa.
Mở rộng dần
Thử Plan Mode cho task phức tạp hơn, chuyển đổi model (Gemini ↔ Claude), và nếu cần — thêm provider khác (DeepSeek, Qwen, OpenAI) qua Custom Provider.
Thêm Claude API / DeepSeek API cho Skill & Agent
Các kỹ năng chạy vòng lặp tự động (ví dụ bình duyệt bài viết, nghiên cứu sâu) thường cần gọi LLM ngoài thông qua một MCP Server trung gian, hoặc qua biến môi trường hệ thống.
Cách 1 — Cấu hình qua MCP Server (khuyên dùng)
Các skill tự động (như auto-review-loop-llm, deep-research) thường gọi API ngoài qua một MCP Server trung gian tên llm-chat. Mở (hoặc tạo mới) tệp cấu hình tại:
C:\Users\Admin\.claude\settings.json
Thêm đoạn sau vào phần mcpServers — ví dụ cho DeepSeek API:
{
"mcpServers": {
"llm-chat": {
"command": "python",
"args": ["C:/Users/Admin/.claude/mcp-servers/llm-chat/server.py"],
"env": {
"LLM_API_KEY": "sk-your-deepseek-api-key",
"LLM_BASE_URL": "https://api.deepseek.com/v1",
"LLM_MODEL": "deepseek-chat"
}
}
}
}
Hoặc cho Claude API (Anthropic):
{
"mcpServers": {
"llm-chat": {
"command": "python",
"args": ["C:/Users/Admin/.claude/mcp-servers/llm-chat/server.py"],
"env": {
"LLM_API_KEY": "sk-ant-your-anthropic-key",
"LLM_BASE_URL": "https://api.anthropic.com/v1",
"LLM_MODEL": "claude-3-5-sonnet-latest"
}
}
}
}
Cách 2 — Thiết lập qua biến môi trường (Environment Variables)
Một số script hoặc tool chạy trực tiếp trong plugin (qua terminal hoặc script Python) sẽ tìm khóa API dưới dạng biến môi trường có sẵn trên hệ thống. Mở PowerShell hoặc Command Prompt và thiết lập biến tạm thời cho phiên làm việc, hoặc cấu hình vĩnh viễn trong System Environment Variables của Windows.
$env:DEEPSEEK_API_KEY="sk-xxx..."
$env:ANTHROPIC_API_KEY="sk-ant-xxx..."
$env:LLM_API_KEY="your-api-key" $env:LLM_BASE_URL="https://api.deepseek.com/v1"
Lưu ý: nếu tệp settings.json chưa tồn tại, bạn có thể tạo mới. Tên trường (LLM_API_KEY, LLM_BASE_URL, LLM_MODEL) cần khớp với những gì server llm-chat hoặc script của bạn mong đợi — hãy kiểm tra tài liệu của từng skill cụ thể. Không chia sẻ API key của bạn cho người khác hoặc commit vào Git.
Lịch sử phát triển — các phiên bản đáng chú ý
Tóm tắt các mốc lớn từ khi ra mắt đến nay. Chỉ liệt kê những bản có ảnh hưởng đáng kể đến cách bạn dùng sản phẩm — không phải bản patch nhỏ.
Ra mắt công khai cùng Gemini 3
Bản preview đầu tiên (desktop Windows & macOS), giới thiệu vòng lặp agent plan → execute → review, đa cửa sổ (multi-window orchestration), lớp Artifact, và bộ extension ban đầu. Đây vẫn là một "trợ lý code thông minh trong giao diện quen thuộc" — phạm vi còn hạn chế so với 2.0.
Ra mắt gói trả phí (paid tier)
Thêm hạn mức chạy/ngày cao hơn, context window lập kế hoạch lớn hơn, chia sẻ Artifact ở cấp tổ chức kèm quyền truy cập, và hàng đợi ưu tiên. Gói miễn phí không bị cắt giảm khi gói trả phí ra mắt — vẫn chạy được nhiều task agent đầy đủ mỗi ngày.
Hỗ trợ Workspace cho doanh nghiệp
Cho phép tổ chức cấu hình ranh giới định danh ở cấp tenant, áp chính sách hạn mức theo nhóm, đặt quy tắc lưu trữ log Artifact, và cấp quyền qua Google Workspace admin. Bổ sung tính năng phân bổ chi phí theo nhóm và định dạng xuất log kiểm toán mới. Cải thiện độ trễ tạo kế hoạch cho task đa cửa sổ thêm ~20% so với v1.3.
Xây lại hoàn toàn — IDE hướng điều phối agent
Antigravity 2.0 là một ứng dụng desktop độc lập, được thiết kế lại từ đầu để tập trung vào điều phối agent (agent orchestration) thay vì chỉ là công cụ gợi ý code tự động. Antigravity 1.0 vẫn còn tồn tại song song, nhưng 2.0 là sản phẩm chủ lực mới — workflow chuyển sang việc bạn chỉ đạo agent, không chỉ prompt một engine autocomplete.
Lưu ý: Antigravity vẫn đang trong giai đoạn preview và cập nhật liên tục — số phiên bản, tên gói, và mốc thời gian có thể thay đổi. Luôn đối chiếu với antigravity.google để biết thông tin mới nhất.
Multi-Agent: điều phối nhiều AI cùng một lúc
Điểm khác biệt lớn nhất của Antigravity so với một trợ lý code thông thường: bạn không nói chuyện với "một AI", mà giao việc cho nhiều agent chạy song song, mỗi agent như một nhân viên có vai trò và phạm vi riêng.
Multi-agent trong Antigravity được vận hành thông qua Agent Manager — màn hình "mission control" cho phép bạn tạo (spawn), theo dõi, đặt tên, chuyển đổi qua lại và lưu trữ nhiều agent. Mỗi agent thường gắn với một workspace/thư mục dự án riêng, có ngữ cảnh và lịch sử hội thoại độc lập, nên các agent không "đụng" vào việc của nhau khi cùng sửa code.
Antigravity còn cho phép gán model khác nhau cho từng agent — ví dụ agent A dùng Gemini 3 Pro để lập kế hoạch phức tạp, agent B dùng Claude cho một module cụ thể. Bộ công cụ AgentKit mở rộng ý tưởng này thành các agent chuyên biệt theo vai trò (frontend, backend, testing, hạ tầng/DevOps…), giúp một dự án lớn được "chia việc" theo đúng chuyên môn thay vì dồn hết cho một agent tổng quát.
Vì mỗi agent vẫn liên tục tạo ra Artifact (kế hoạch, ảnh chụp, báo cáo), bạn có thể lướt qua Agent Manager để nắm tiến độ của cả nhóm mà không cần đọc log thô của từng agent.
Các kiểu sử dụng multi-agent điển hình
Giao mỗi agent một bug riêng từ danh sách issue: tự tái hiện lỗi, viết test, sửa code, rồi báo cáo kết quả. Bạn chỉ cần lần lượt duyệt Artifact của từng agent thay vì sửa tay từng lỗi.
Một agent dựng API backend, một agent dựng UI frontend, một agent viết test tích hợp — cả ba làm song song trên cùng repo nhưng ở các thư mục/module khác nhau, rút ngắn đáng kể thời gian hoàn thành so với làm tuần tự.
Mỗi agent phụ trách một repo hoặc một microservice riêng (ví dụ nâng cấp dependency, đổi API cũ sang mới). Agent Manager hiển thị tiến độ của tất cả repo trên cùng một màn hình, giúp bạn đóng vai "kiến trúc sư" theo dõi toàn cảnh.
Một agent dùng Browser Subagent để đọc tài liệu API/thư viện bên ngoài và tổng hợp báo cáo; agent thứ hai dựa vào báo cáo đó để viết code tích hợp — tách rõ giai đoạn "nghiên cứu" và "thực thi".
Lưu ý hiệu năng: chạy nhiều agent song song nghĩa là nhiều tiến trình theo dõi file, terminal và trình duyệt cùng lúc — máy yếu có thể bị quá tải. Người mới nên bắt đầu với 2–3 agent, theo dõi RAM/CPU, và dùng Review Gate (xem mục 09) cho các agent đang làm việc quan trọng để tránh thay đổi ngoài ý muốn lan rộng.
Antigravity, Codex (OpenAI) và OpenClaw khác nhau ở đâu?
Cả ba đều xoay quanh ý tưởng "agent làm việc, con người định hướng", nhưng mỗi sản phẩm chọn một hình thái và phạm vi rất khác nhau.
| Tiêu chí | Antigravity | Codex (OpenAI) | OpenClaw |
|---|---|---|---|
| Nguồn gốc | Google, ra mắt cùng Gemini 3 | OpenAI, phát triển từ Codex CLI | Mã nguồn mở, do cộng đồng khởi xướng |
| Hình thức chính | Ứng dụng desktop độc lập, fork từ VS Code | CLI, app ChatGPT (web/desktop) và plugin IDE | Gateway tự host (self-hosted), chạy trên máy/server riêng |
| Model AI | Tích hợp sẵn Gemini 3 Pro/Flash và Claude; có thể thêm provider khác qua API | Dòng model GPT-Codex của OpenAI, gắn với hệ sinh thái ChatGPT | Không ràng buộc model — chọn Claude, GPT, Gemini hoặc model chạy local (Ollama) |
| Cách multi-agent hoạt động | Agent Manager spawn nhiều agent theo workspace/dự án; AgentKit chia agent theo vai trò chuyên môn | Quản lý nhiều phiên (session) agent chạy song song trong thời gian dài, theo dõi qua giao diện riêng | Một Gateway định tuyến yêu cầu tới nhiều agent/skill; có thể "bọc" các agent khác (kể cả Codex CLI) làm worker chạy nền |
| Giao diện tương tác | Agent Manager (điều phối) + Editor View (sửa code chi tiết) | Terminal, web ChatGPT, app desktop | Các ứng dụng chat quen dùng: WhatsApp, Telegram, Slack, Discord… — không có IDE riêng |
| Phù hợp với ai | Người mới và dev cá nhân muốn một IDE "ra đề bài rồi xem kết quả" | Người dùng quen ChatGPT/terminal, cần agent quản trị code dài hạn, kèm tính năng quét lỗ hổng bảo mật | Người muốn một trợ lý cá nhân chạy thường trực trên máy riêng, điều khiển từ điện thoại, ưu tiên tự chủ dữ liệu |
Khác biệt về triết lý
- Antigravity đặt trọng tâm vào trải nghiệm IDE kết hợp Manager trực quan — phù hợp khi bạn muốn "thấy" agent làm việc qua Artifact, ảnh chụp và báo cáo.
- Codex gắn liền với hệ sinh thái OpenAI/ChatGPT, nhấn mạnh việc quản lý nhiều phiên agent dài hơi và bổ sung lớp agent chuyên về phát hiện lỗ hổng bảo mật.
- OpenClaw không phải một IDE mà là một lớp điều phối/gateway mã nguồn mở chạy thường trực — nó có thể đứng "phía sau", dùng cả Codex hay các agent coding khác làm worker, nên nhiều khi được xem là công cụ bổ trợ hơn là đối thủ cạnh tranh trực tiếp.
Lưu ý: đây là các sản phẩm thay đổi rất nhanh — tính năng, mô hình giá và model mặc định có thể khác đi chỉ sau vài tuần. Luôn kiểm tra trang chính thức của từng dự án trước khi đưa ra quyết định lựa chọn.
Câu hỏi thường gặp & xử lý tình huống
Tổng hợp các vấn đề người dùng thường gặp khi mới bắt đầu và cách xử lý nhanh.
Antigravity báo lỗi khi đăng nhập bằng tài khoản Google công ty?
Một số tổ chức chặn ứng dụng bên thứ ba qua chính sách Workspace admin. Thử đăng nhập bằng tài khoản Google cá nhân để kiểm tra xem vấn đề có nằm ở chính sách tổ chức không. Nếu cần dùng tài khoản công ty, liên hệ quản trị Workspace để được cấp quyền truy cập (xem mục Workspace tenant ở phiên bản v1.5).
Cài xong nhưng Antigravity không khởi động được trên Linux?
Kiểm tra bạn đang dùng bản 64-bit với glibc 2.28+ và glibcxx 3.4.25+ — đây là
yêu cầu tối thiểu. Bản phân phối Linux quá cũ sẽ không đáp ứng được điều kiện này; hãy cập nhật hệ
thống hoặc dùng máy khác đáp ứng yêu cầu.
Agent dừng giữa chừng và báo hết hạn mức (quota) phải làm sao?
Gói miễn phí vẫn chạy được nhiều task đầy đủ mỗi ngày nhưng có giới hạn — hạn mức sẽ reset theo ngày. Nếu công việc gấp, có thể: (1) chờ reset hạn mức, (2) chuyển sang model khác (Gemini ↔ Claude) nếu model hiện tại đang nghẽn, hoặc (3) xem xét gói trả phí (từ v1.3) để có hạn mức cao hơn và hàng đợi ưu tiên.
Agent đi sai hướng, sửa nhầm file hoặc xóa mất code — khôi phục thế nào?
Đây là lý do nên commit Git trước khi giao task lớn (xem mục 09 — An toàn). Nếu đã có
commit gần nhất, dùng git checkout hoặc git revert để hoàn tác. Nếu chưa commit
và file đã bị ghi đè, kiểm tra xem editor/IDE có giữ lịch sử file tạm (local history) không trước khi
thử các công cụ khôi phục khác.
Agent treo (không phản hồi) giữa một task dài?
Với task đa cửa sổ phức tạp, thời gian lập kế hoạch có thể khá lâu — đợi thêm vài phút trước khi hủy. Nếu vẫn treo, hủy task, kiểm tra kết nối mạng/trình duyệt (vì agent có thể đang chờ một tác vụ duyệt web), rồi thử lại với yêu cầu nhỏ hơn hoặc bật Review Gate để theo dõi từng bước.
Thêm Custom Provider (DeepSeek/Claude/OpenAI) nhưng báo lỗi xác thực?
Kiểm tra ba điều: API Key còn hạn mức/chưa bị revoke, Base URL đúng định dạng (thường kết thúc bằng
/v1), và tên model đúng chính xác như provider yêu cầu (phân biệt hoa/thường). Xem lại
bảng mẫu cấu hình ở mục 08.
Cấu hình MCP Server llm-chat nhưng skill tự động không gọi được API ngoài?
Kiểm tra: (1) đường dẫn tệp settings.json đúng vị trí, (2) cú pháp JSON hợp lệ (không thiếu
dấu phẩy/ngoặc), (3) đường dẫn args tới server.py tồn tại trên máy, và (4) đã
khởi động lại Antigravity sau khi sửa cấu hình. Xem chi tiết ở mục 11.
Agent đọc một file lạ rồi bỗng làm việc ngoài yêu cầu của tôi?
Đây có thể là dấu hiệu prompt injection — một file (README, comment code, trang web...) chứa chỉ dẫn ẩn đánh lừa agent. Hủy task ngay, không cho agent tiếp tục thao tác nhạy cảm (terminal, deploy, gửi dữ liệu), và xem lại Artifact/log để biết agent đã thực hiện gì.
Nghi ngờ API key bị rò rỉ hoặc bị dùng sai mục đích?
Vào console của provider (console.anthropic.com, platform.deepseek.com...) để revoke key cũ và tạo key
mới ngay. Cập nhật lại key trong settings.json hoặc biến môi trường, và tránh commit key
vào Git hoặc chia sẻ qua kênh chat không mã hóa.