Tới nội dung chính

Tự động hoá · 9 phút đọc · 2026-11-13

Gemini CLI có miễn phí không? Hạn mức, cách cài và gỡ sạch

Từ 18/06/2026 Gemini CLI thôi phục vụ tài khoản Google cá nhân miễn phí và gói Google AI Pro, Ultra; lối miễn phí chuyển sang Antigravity CLI. Bài nói ai còn dùng được, cách cài trên Windows và cách gỡ sạch mà không đụng cấu hình Antigravity.

Gemini CLI có miễn phí không? Với tài khoản Google cá nhân thì không, kể từ ngày 18/06/2026: đăng nhập Gmail miễn phí và hai gói Google AI Pro, Google AI Ultra đã chuyển sang Antigravity CLI. Gemini CLI vẫn là mã nguồn mở và vẫn cài được, nhưng muốn dùng thì cần giấy phép tổ chức, API key Gemini trả phí hoặc Vertex AI có thanh toán. Mình đọc lại tài liệu chính thức của Google ngày 13/11/2026, và nhiều trang trên mạng, kể cả một bảng còn sót trong chính bộ tài liệu, vẫn ghi hạn mức miễn phí cũ.

Điều kiện cần trước khi cài

Trang cài đặt chính thức khuyến nghị cấu hình sau. Thiếu cách đăng nhập hợp lệ thì vẫn cài được, nhưng không gọi được model.

  • Hệ điều hành: Windows 11 bản 24H2 trở lên (hoặc macOS 15+, Ubuntu 20.04+).
  • RAM: 4GB trở lên cho dùng nhẹ, 16GB trở lên cho phiên dài hoặc kho mã lớn.
  • Node.js: bản 20.0.0 trở lên.
  • Shell: PowerShell, Bash hoặc Zsh, có kết nối Internet.
  • Vị trí: bạn phải ở nơi Gemini Code Assist có hỗ trợ.
  • Cách đăng nhập: giấy phép Gemini Code Assist Standard hoặc Enterprise của tổ chức, API key Gemini trả phí, hoặc dự án Vertex AI trên Google Cloud.

Gemini CLI có miễn phí không sau ngày 18/06/2026

Ngày 19/05/2026, blog Google Developers đăng bài "An important update: Transitioning Gemini CLI to Antigravity CLI". Theo bài đó, từ 18/06/2026 Gemini CLI và tiện ích Gemini Code Assist cho IDE ngừng phục vụ người dùng Google AI Pro, Google AI Ultra và người dùng miễn phí qua Gemini Code Assist for individuals. Antigravity CLI mở cho mọi người ngay từ ngày đăng bài.

README của kho google-gemini/gemini-cli có khung "Read before installing" ghi thẳng: "No free tier or Google AI plans". Mọi trang trên geminicli.com cũng có một dải thông báo: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026."

Chỗ dễ nhầm nằm ở trang Quotas and pricing. Ngay dưới dải thông báo đó, trang vẫn in bảng hạn mức cũ, có cả dòng cho tài khoản cá nhân và API key tầng miễn phí. Bảng này mâu thuẫn với dải thông báo phía trên nó và với README. Con số lượt miễn phí mỗi ngày bạn thấy trên các bài cũ là mức trước 18/06/2026.

Trang đó cũng ghi Google AI Plus không được Gemini CLI hỗ trợ.

Ai còn dùng Gemini CLI được, bằng cách nào

  • Tài khoản Google cá nhân miễn phí — không còn dùng được — chuyển sang Antigravity CLI.
  • Google AI Pro hoặc Google AI Ultra — không còn dùng được — chuyển sang Antigravity CLI.
  • Tổ chức có Gemini Code Assist Standard hoặc Enterprise — vẫn dùng được — hạn mức 1.500 (Standard) hoặc 2.000 (Enterprise) lượt mỗi người mỗi ngày.
  • Gemini Code Assist for GitHub qua Google Cloud — không bị ảnh hưởng theo blog Google.
  • API key Gemini trả phí — vẫn dùng được — trả theo token.
  • Vertex AI — vẫn dùng được — tính theo dự án Google Cloud của bạn.

Còn API key tầng miễn phí của AI Studio thì sao? Blog và README chỉ nói key trả phí; mình chưa thấy trang chính thức nào xác nhận key miễn phí còn chạy, nên đừng dựa vào nó.

Cách cài Gemini CLI trên Windows

Phần này dành cho bạn đã có cách đăng nhập hợp lệ, hoặc chỉ muốn cài để đọc mã. Thông tin gói @google/gemini-cli trên npm ngày 13/11/2026 ghi bản stable là 0.68.0, yêu cầu Node.js 20 trở lên. Hai lệnh dưới đây chỉ đọc thông tin gói, không cài gì:

powershell
npm view @google/gemini-cli version
npm view @google/gemini-cli engines
  1. Kiểm Node.js bằng lệnh node -v trong PowerShell. Đã xong khi số hiện ra từ 20 trở lên. Nếu số nhỏ hơn hoặc PowerShell báo không nhận lệnh, cài bản Node.js mới hơn rồi mở lại cửa sổ PowerShell.
  2. Chạy npm install -g @google/gemini-cli. Đã xong khi npm chạy hết mà không báo lỗi. Nếu chưa muốn cài toàn cục, chạy thẳng npx @google/gemini-cli, cách này không cần cài.
  3. Chạy gemini --version. Đã xong khi màn hình in ra số phiên bản. Nếu PowerShell báo không tìm thấy lệnh gemini, lỗi thường nằm ở PATH của npm; bài về Claude Code có phần xử lý đúng lỗi này.
  4. Chạy gemini để mở phiên đầu tiên. Đã xong khi màn hình hiện ba lựa chọn đăng nhập. Nếu bạn chọn nhầm, vào phiên rồi gõ /auth để chọn lại.
bash
npm install -g @google/gemini-cli
gemini --version
gemini

Kênh mặc định là stable (thẻ latest), ra bản mới hằng tuần vào thứ Ba. Muốn cập nhật, FAQ chính thức dùng lệnh:

bash
npm install -g @google/gemini-cli@latest

Đăng nhập và cách đặt Gemini CLI API key

Lần đầu chạy gemini, bạn thấy ba lựa chọn: Sign in with Google, Use Gemini API key và Vertex AI. Chi tiết nằm ở trang Authentication.

Sign in with Google mở trình duyệt để bạn đăng nhập, thông tin được lưu trên máy cho lần sau. Sau 18/06/2026, cách này chỉ còn dùng được với giấy phép tổ chức. Khi đó bạn phải khai dự án Google Cloud bằng biến GOOGLE_CLOUD_PROJECT (hoặc GOOGLE_CLOUD_PROJECT_ID; CLI đọc GOOGLE_CLOUD_PROJECT trước).

Use Gemini API key cần key lấy ở Google AI Studio, đặt vào biến GEMINI_API_KEY. Nhớ là chỉ key trả phí được nêu là còn dùng được.

Vertex AI có ba đường: đăng nhập gcloud (ADC), tệp khoá service account qua biến GOOGLE_APPLICATION_CREDENTIALS, hoặc API key Google Cloud qua biến GOOGLE_API_KEY. Cả ba đều cần GOOGLE_CLOUD_PROJECT và GOOGLE_CLOUD_LOCATION. Nếu dùng ADC, bạn phải bỏ hai biến key đã đặt trước đó.

Đặt key cho phiên PowerShell hiện tại, lưu lâu dài qua $PROFILE, và bỏ biến key khi chuyển sang ADC:

powershell
# Replace YOUR_GEMINI_API_KEY with the key from AI Studio
$env:GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

# Lưu lâu dài: thêm dòng vào profile của PowerShell rồi nạp lại
Add-Content -Path $PROFILE -Value '$env:GEMINI_API_KEY="YOUR_GEMINI_API_KEY"'
. $PROFILE

# Chuyển sang Vertex AI bằng ADC: bỏ hai biến key
Remove-Item Env:\GOOGLE_API_KEY, Env:\GEMINI_API_KEY -ErrorAction Ignore

Thay vì sửa profile, bạn có thể tạo tệp .gemini/.env trong thư mục dự án hoặc trong thư mục người dùng. CLI đọc tệp .env đầu tiên nó tìm thấy. Ví dụ trong tài liệu chỉ có dòng GOOGLE_CLOUD_PROJECT và nhắc thêm các biến khác như GEMINI_API_KEY khi cần; dòng thứ hai dưới đây viết theo cùng khuôn đó:

text
GOOGLE_CLOUD_PROJECT="your-project-id"
GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

Giữ key như mật khẩu, đừng đưa tệp .env có key lên GitHub. Tài liệu cũng cảnh báo: key trong tệp khởi động shell thì mọi tiến trình mở từ shell đó đều đọc được.

Theo FAQ chính thức, dùng phần mềm bên thứ ba như Claude Code, OpenClaw hay OpenCode để dùng ké phiên đăng nhập OAuth của Gemini CLI là vi phạm điều khoản, tài khoản có thể bị khoá.

Dấu hiệu đã cài và đăng nhập xong

  • gemini --version hoặc gemini -v in ra số phiên bản.
  • npm list -g @google/gemini-cli liệt kê gói trong danh sách cài toàn cục.
  • Trong phiên, lệnh /about hiện phiên bản đang chạy.
  • Lệnh /stats model hiện số token đã dùng và hạn mức còn lại.
  • Gặp API error: 429 - Resource exhausted nghĩa là bạn đã vượt hạn mức.

Thoát phiên bằng /quit hoặc /exit. Tài liệu lệnh không có lệnh đăng xuất riêng; muốn đổi tài khoản hay đổi cách đăng nhập thì dùng /auth.

Gỡ cài đặt Gemini CLI cho sạch

Trang Uninstall chính thức chỉ nói cách gỡ gói, không nhắc thư mục cấu hình hay biến môi trường. Cách gỡ cài đặt Gemini CLI dưới đây dọn cả phần đó mà không làm hỏng cấu hình Antigravity.

  1. Gỡ gói bằng npm uninstall -g @google/gemini-cli. Đã xong khi npm list -g @google/gemini-cli không còn liệt kê gói. Nếu bạn chỉ từng chạy bằng npx, xoá bộ nhớ đệm _npx bằng lệnh bên dưới, nhưng lệnh đó xoá luôn mọi gói khác bạn từng chạy bằng npx.
  2. Mở $PROFILE bằng trình soạn thảo, xoá các dòng GEMINI_API_KEY hoặc GOOGLE_CLOUD_PROJECT đã thêm, rồi xoá các tệp .gemini/.env. Đã xong khi mở PowerShell mới và biến không còn giá trị.
  3. Với thư mục .gemini trong thư mục người dùng, chỉ xoá cả thư mục nếu bạn KHÔNG dùng Antigravity CLI. Antigravity dùng chung thư mục này cho GEMINI.md, cấu hình MCP, skill và thư mục antigravity-cli. Muốn giữ thư mục thì chỉ xoá settings.json của Gemini CLI.
  4. Xem lại thư mục .gemini trong từng dự án (settings, skills) trước khi xoá, vì có thể còn skill bạn muốn giữ.
  5. Máy do tổ chức quản lý có thể có cấu hình hệ thống trong C:\ProgramData\gemini-cli; hỏi người quản trị trước khi xoá.
powershell
npm uninstall -g @google/gemini-cli

# Chỉ khi từng chạy bằng npx. Lệnh này xoá mọi gói npx khác.
Remove-Item -Path (Join-Path $env:LocalAppData "npm-cache\_npx") -Recurse -Force

Muốn xoá cả phiên đăng nhập Google, bạn có thể tìm mục gemini-cli-oauth trong trình quản lý thông tin đăng nhập của Windows; đây là gợi ý theo mã nguồn, tài liệu không ghi.

Gemini CLI vs Antigravity: nên chọn công cụ nào

  • Lệnh chạy — Gemini CLI là gemini; Antigravity CLI là agy.
  • Cách cài — Gemini CLI qua npm, cần Node.js 20+; Antigravity CLI qua script cài trên trang tải chính thức.
  • Miễn phí cho cá nhân — Gemini CLI không; Antigravity CLI có gói For Individuals $0/month với "Basic weekly rate limits".
  • Đăng nhập — Gemini CLI cần giấy phép tổ chức, API key trả phí hoặc Vertex AI; Antigravity CLI dùng tài khoản Google cá nhân qua trình duyệt.
  • API key riêng — Gemini CLI nhận; Antigravity CLI không hỗ trợ BYOK để tăng hạn mức.
  • Nền tảng — Gemini CLI là gói npm chạy trên Node.js, mã nguồn mở Apache 2.0; Antigravity CLI viết bằng Go theo blog Google.

Theo trang Plans, người không có Google AI Pro hay Ultra nhận "A meaningful quota, refreshed weekly". Hạn mức tính theo lượng việc agent làm chứ không theo số lời nhắn, và Google không công bố con số cụ thể. Trang tải ngày 13/11/2026 ghi Antigravity CLI bản v1.5.7.

Antigravity CLI giữ các tính năng chính của Gemini CLI như Agent Skills, Hooks, Subagents và Extensions (nay gọi là plugin), dù blog Google nói lúc đầu chưa đủ một đổi một. Lần đầu chạy agy, nếu máy còn cấu hình Gemini CLI cũ, nó tự phát hiện và cho bạn chọn mang gì sang.

powershell
irm https://antigravity.google/cli/install.ps1 | iex
agy
agy plugin import gemini

Lệnh agy plugin import gemini chuyển extension cũ thành plugin. Skill theo dự án chuyển từ .gemini/skills/ sang .agents/skills/, phải tự đổi tên thư mục. GEMINI.md và AGENTS.md vẫn dùng như cũ.

Kiểm lại

  • Câu trả lời cho "gemini cli có miễn phí không" tính tới 13/11/2026: không, với tài khoản cá nhân và gói Google AI Pro, Ultra.
  • Có giấy phép Code Assist Standard, Enterprise, key trả phí hoặc Vertex AI: cài bằng npm, kiểm bằng gemini --version và /stats model.
  • Muốn công cụ miễn phí của Google: cài Antigravity CLI, chạy agy để chuyển cấu hình cũ.
  • Đã gỡ: gemini --version báo không tìm thấy lệnh, và thư mục .gemini chỉ còn phần Antigravity cần.

Nếu thứ bạn cần chỉ là một trợ lý lập trình chạy trong terminal trên Windows, bài Claude Code trên Windows so được thêm một lựa chọn.