Gemini CLI là gì?
Gemini CLI là agent viết code mã nguồn mở của Google chạy trong terminal: đọc dự án, sửa file, chạy lệnh, dùng công cụ qua MCP, nhớ quy ước dự án trong file GEMINI.md. Công cụ ra mắt năm 2025 và từng được nhiều người dùng vì đăng nhập bằng tài khoản Google cá nhân là có hạn mức miễn phí. Từ giữa năm 2026, Google dồn phát triển sang dòng Antigravity, nên chuyện ai còn dùng được Gemini CLI đã đổi hẳn.
Thay đổi từ 18/06/2026
Theo thông báo của Google ngày 19/05/2026 và trang ngừng hỗ trợ của Gemini Code Assist:
- Từ 18/06/2026, Gemini CLI và extension Gemini Code Assist cho IDE ngừng phục vụ request của tài khoản cá nhân: bản miễn phí Gemini Code Assist for individuals và người dùng gói Google AI Pro, Google AI Ultra.
- Lựa chọn đăng nhập bằng Google (Login with Google) không còn dùng được cho các tài khoản này.
- Gemini Code Assist for GitHub cũng không nhận cài mới trên tổ chức GitHub từ ngày đó, và ngừng phục vụ request trong các tuần sau.
- Google đưa ra Antigravity CLI cho mọi người từ 19/05/2026 để thay thế.
- README của Gemini CLI còn ghi công cụ chưa được tối ưu cho Gemini 4 Argon; muốn dùng Gemini 4 Argon thì dùng Antigravity.
Ai còn dùng được Gemini CLI?
Theo Google, tổ chức dùng Gemini CLI hay extension IDE qua giấy phép Gemini Code Assist Standard, Enterprise, hoặc Gemini Code Assist for GitHub qua Google Cloud, vẫn dùng như cũ và tiếp tục được cập nhật model. Gemini CLI cũng vẫn chạy bằng API key trả phí của Gemini API và qua Vertex AI trên Google Cloud. Trên Cloud Shell và Cloud Workstations, Gemini CLI được cài sẵn và tự xác thực bằng tài khoản Google Cloud.
Cài Gemini CLI
Gemini CLI cần Node.js 20 trở lên, chạy trên macOS 15+, Windows 11 24H2+ hoặc Ubuntu 20.04+, cần kết nối internet và ở vị trí Gemini Code Assist hỗ trợ; dùng nhẹ cần từ 4 GB RAM, dự án lớn nên có 16 GB. Cài bằng npm hoặc Homebrew, hoặc chạy thử không cài bằng npx, rồi gõ gemini để mở.
npm install -g @google/gemini-cli
# hoặc: brew install gemini-cli
# hoặc chạy thử không cài: npx @google/gemini-cli
geminiĐăng nhập bằng API key Gemini hoặc Vertex AI
Với tài khoản cá nhân, đường còn lại là API key. Lấy key ở Google AI Studio, đặt vào biến GEMINI_API_KEY rồi chọn Use Gemini API key khi mở Gemini CLI. Dùng Vertex AI thì đặt GOOGLE_CLOUD_PROJECT và GOOGLE_CLOUD_LOCATION (đăng nhập bằng gcloud hoặc file khoá service account), hoặc dùng API key của Google Cloud trong GOOGLE_API_KEY kèm GOOGLE_GENAI_USE_VERTEXAI=true. Biến môi trường để lâu dài được trong file .gemini/.env ở thư mục dự án hay thư mục home. Cách lấy key Gemini có ở bài cách lấy API key.
# Gemini API (key từ Google AI Studio)
export GEMINI_API_KEY="KEY_CUA_BAN"
# Hoặc Vertex AI
export GOOGLE_CLOUD_PROJECT="ID_DU_AN"
export GOOGLE_CLOUD_LOCATION="us-central1"
geminiChuyển sang Antigravity CLI
Antigravity CLI là công cụ terminal mới của Google, dùng chung phần lõi với ứng dụng Antigravity. Khi cài, nó tự tìm thư mục Gemini CLI trên máy và chép sang skill, máy chủ MCP, cấu hình agent, vẫn đọc file gemini.md để giữ bộ nhớ dự án. Hạn mức và gói của Antigravity theo trang giá của Antigravity; chi tiết ở bài Google Antigravity là gì.
# macOS, Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iexLỗi hay gặp với Gemini CLI
Các tình huống tài liệu và thông báo của Google nhắc tới:
- Tài khoản cá nhân đăng nhập bằng Google không còn được phục vụ: chuyển sang API key Gemini, Vertex AI, hoặc dùng Antigravity CLI.
- Báo “API keys are not supported by this API” khi dùng key Google Cloud với Vertex AI: tổ chức có thể chặn dùng API key, đổi sang đăng nhập bằng gcloud hoặc service account.
- Đã đặt GOOGLE_API_KEY hay GEMINI_API_KEY trước đó thì phải xoá hai biến này mới dùng được đăng nhập gcloud cho Vertex AI.
- Dùng công cụ bên thứ ba “ké” đăng nhập OAuth của Gemini CLI để gọi model là vi phạm điều khoản và có thể bị khoá tài khoản; công cụ khác muốn dùng Gemini thì dùng key Google AI Studio hay Vertex AI.
Coding agent khác trong terminal
Nếu bạn cần agent trong terminal mà không phụ thuộc gói của Google: Claude Code, Codex, GitHub Copilot CLI, Cline CLI hay OpenCode; nhiều công cụ trong số này nhận API key riêng qua endpoint tương thích OpenAI hoặc Anthropic.
Câu hỏi thường gặp
Gemini CLI còn miễn phí không?
Không còn cho tài khoản cá nhân: từ 18/06/2026 Google ngừng phục vụ bản miễn phí Gemini Code Assist for individuals và cả người dùng Google AI Pro, Ultra trên Gemini CLI. Google chuyển người dùng sang Antigravity CLI.
Còn cách nào dùng Gemini CLI không?
Còn, bằng API key trả phí của Gemini API, qua Vertex AI trên Google Cloud, hoặc qua giấy phép Gemini Code Assist Standard, Enterprise của tổ chức. Trên Cloud Shell, Gemini CLI được cài sẵn.
Antigravity CLI khác Gemini CLI thế nào?
Antigravity CLI là công cụ terminal mới thay Gemini CLI cho tài khoản cá nhân, dùng chung lõi với ứng dụng Antigravity và chạy được Gemini 4 Argon. Khi cài, nó tự chép skill, máy chủ MCP, agent từ Gemini CLI sang và vẫn đọc gemini.md.
Cài Gemini CLI bằng lệnh gì?
Chạy npm install -g @google/gemini-cli (cần Node.js 20 trở lên) hoặc brew install gemini-cli, rồi gõ gemini. Muốn thử không cài thì chạy npx @google/gemini-cli.
Đặt API key cho Gemini CLI thế nào?
Lấy key ở Google AI Studio, đặt vào biến GEMINI_API_KEY (hoặc ghi vào file .gemini/.env), mở gemini và chọn Use Gemini API key. Với Vertex AI, đặt GOOGLE_CLOUD_PROJECT và GOOGLE_CLOUD_LOCATION.