Gemini CLI ngừng hoạt động: giờ nên dùng gì

Nếu gemini bỗng dưng không chạy nữa từ mùa hè này, bản cài của bạn không có vấn đề gì cả. Ngày 2026-06-18, Google đã ngừng phục vụ Gemini CLI cho tài khoản Google cá nhân: gói miễn phí, Google AI Pro và Google AI Ultra. Cài lại hay đăng nhập bằng một tài khoản cá nhân khác cũng không giúp được gì. Bạn có ba hướng đi tiếp: chuyển sang Antigravity CLI (agy), công cụ Google đưa ra để thay thế; tiếp tục chạy Gemini CLI bằng API key trả phí; hoặc đổi sang một agent lập trình khác.

Chuyện gì đã xảy ra với Gemini CLI

Google công bố thay đổi này ngày 2026-05-19 trong một bài viết trên Google Developers Blog, kèm theo một thảo luận trên GitHub (#28017). Từ 2026-06-18, Gemini CLI và các extension IDE của Gemini Code Assist ngừng xử lý yêu cầu từ tài khoản cá nhân. Google hướng những người dùng này sang Antigravity CLI, công cụ mà Google mô tả là mang theo những tính năng quan trọng nhất của Gemini CLI: Agent Skills, Hooks, Subagents và Extensions (nay gọi là plugin).

Nếu bây giờ bạn đăng nhập bằng tài khoản cá nhân, trình duyệt sẽ báo xác thực thành công, rồi terminal in ra dòng này:

This client is no longer supported for Gemini Code Assist for individuals. To continue using Gemini, please migrate to the Antigravity suite of products.

Đó là nội dung được báo cáo trong issue #28229 của gemini-cli. Một số hướng dẫn chuyển đổi còn cho biết CLI trả về HTTP 410 Gone. Chúng tôi chưa thấy Google ghi rõ mã trạng thái nào, nên hãy dựa vào thông báo: nếu bạn thấy nó, nghĩa là cách đăng nhập của bạn đã bị khai tử. Đây không phải lỗi hết quota.

Ai bị ảnh hưởng, ai không

Bảng trên dựa theo thông báo của Google. Lưu ý Google nói rõ là API key trả phí. Nếu bạn đang dùng key miễn phí từ AI Studio, hãy tự kiểm tra lại thông báo trước khi trông cậy vào nó.

Cách 1: chuyển sang Antigravity CLI (agy)

Với phần lớn những ai từng dùng Gemini CLI bằng tài khoản Google, đây là con đường Google đã vạch sẵn. Cài đặt từ trang cài đặt chính thức:

# macOS and Linux (installs ~/.local/bin/agy)
curl -fsSL https://antigravity.google/cli/install.sh | bash

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

Chạy agy và chọn đăng nhập bằng Google. Trên máy tính, nó sẽ mở trình duyệt. Qua SSH, nó in ra một URL xác thực: bạn mở URL đó trên bất kỳ thiết bị nào rồi dán mã trở lại terminal. Nhờ vậy mà dùng được trên máy chủ headless.

Mang thiết lập Gemini CLI sang

Hướng dẫn chuyển đổi của Google liệt kê những gì được chuyển tự động và những gì không:

• Lần chạy đầu tiên: nếu agy tìm thấy một profile Gemini CLI có sẵn, nó hiện một danh sách đề nghị chuyển đổi extension và cấu hình toàn cục, chuyển session token vào keyring của hệ điều hành, và ánh xạ các thiết lập của bạn.
• Extension: để chuyển đổi thủ công, chạy agy plugin import gemini. Lệnh này biến extension thành plugin Antigravity, chuyển các lệnh cũ thành skill và di chuyển định nghĩa MCP server. Hãy đọc kỹ output, vì nó cho biết đã xử lý gì và bỏ qua gì.
• File ngữ cảnh: GEMINI.md và AGENTS.md vẫn hoạt động, không cần đổi tên.
• Skill: chuyển skill của workspace từ .gemini/skills/ sang .agents/skills/. Skill toàn cục giờ nằm ở ~/.gemini/antigravity-cli/skills/.
• MCP: các server chuyển từ ~/.gemini/settings.json sang mcp_config.json (~/.gemini/config/ cho cấu hình toàn cục, .agents/ cho từng workspace), và server từ xa dùng serverUrl thay cho url/httpUrl.

Google cũng lưu ý rằng một số theme terminal tùy chỉnh và lớp hiển thị thử nghiệm của Gemini CLI có thể không được chuyển sang. Để xem hướng dẫn đầy đủ trên VPS, kể cả cách đăng nhập không cần trình duyệt, hãy đọc chạy Antigravity CLI trên máy chủ.

Cách 2: giữ Gemini CLI với API key

Nếu bạn có các script xoay quanh lệnh gemini, bạn vẫn có thể giữ nó chạy bằng một key trả phí từ Google AI Studio. Theo tài liệu xác thực của Gemini CLI:

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
gemini
# then pick "Use Gemini API key"

Vertex AI cũng dùng được, qua Application Default Credentials, service account hoặc Google Cloud API key. Cái giá phải đánh đổi là cách tính tiền: bạn trả theo token thay vì một gói đăng ký cố định. Nếu bạn có Code Assist Standard hoặc Enterprise qua công ty, mọi thứ vẫn như cũ.

API key cũng dùng được với agy. Đặt {"modelProvider": "gemini"} trong ~/.gemini/antigravity-cli/settings.json và export GEMINI_API_KEY. Cách này hợp với CI và máy chủ headless, nơi đăng nhập tương tác khá bất tiện.

Cách 3: đổi sang một agent lập trình khác

Đợt ngừng hỗ trợ này cũng là dịp hợp lý để tự hỏi Gemini có còn là agent bạn muốn dùng hay không. Claude Code chạy bằng gói Claude Pro hoặc Max. Codex chạy bằng gói ChatGPT hoặc OpenAI API key. OpenCode là mã nguồn mở và làm việc được với nhiều nhà cung cấp model. AGENTS.md của bạn đi theo bạn: Codex đọc nó sẵn, còn các phiên bản Claude Code gần đây đọc nó khi không có CLAUDE.md. Chúng tôi so sánh cả ba trong bài Claude Code vs Codex vs OpenCode.

Trang giá của Antigravity liệt kê gói Individual $0 với giới hạn tần suất theo tuần, và giới hạn cao hơn trên Google AI Pro và Ultra. Trang này không đưa ra con số cho gói nào, và chúng tôi cũng chưa xác nhận CLI được dùng bao nhiêu trong mỗi quota, nên hãy xem trang gói hiện tại của Google trước khi quyết định dựa trên chi phí.

Maude đã làm gì

Maude chạy các agent lập trình trên máy chủ của chính bạn và cho phép bạn điều khiển chúng từ điện thoại. Chúng tôi bỏ Gemini CLI vì đúng lý do khiến bạn đang đọc bài này. Maude kết nối mỗi agent với tài khoản của chính bạn, và với Gemini CLI, điều đó nghĩa là đăng nhập bằng tài khoản Google cá nhân, thứ không còn hoạt động nữa. Thay vào đó, Maude 2.0 hỗ trợ Antigravity CLI, bên cạnh Claude Code, Codex, OpenCode và Grok Build. Ứng dụng cài agy lên máy chủ của bạn ở một phiên bản đã kiểm thử và cố định, và bạn đăng nhập ngay từ điện thoại, bằng Google (dán mã trở lại) hoặc bằng Gemini API key.

Một lưu ý: ở chế độ headless, agy không thể dừng lại để hỏi trước khi chạy một tool. Các thao tác cần quyền sẽ bị từ chối, và lượt đó sẽ báo lại. Maude hiển thị từng thao tác bị từ chối và cho phép bạn phê duyệt sau. Khi bạn phê duyệt, Maude thêm một quy tắc cho phép vào thiết lập riêng của agy rồi chạy lại. Cách này dùng được, nhưng không giống cơ chế hỏi trước của Claude Code, và bạn nên biết điều đó trước khi chọn.

Google cũng có sẵn Antigravity Remote Control của riêng mình: chạy /remote-control bên trong agy, hoặc agy remote-control start để có một daemon headless, rồi điều khiển từ một dashboard trên web. Nếu Antigravity là agent duy nhất bạn dùng, hãy thử cách đó trước.

Câu hỏi thường gặp

Những gì đã thay đổi

• 1 tháng 10, 2026 — Xuất bản lần đầu. Thông tin đã được đối chiếu với thông báo của Google, tài liệu cài đặt và chuyển đổi của Antigravity CLI, và tài liệu xác thực của Gemini CLI.