Gemini CLI là gì, cài và dùng thế nào

Gemini CLI là agent AI mã nguồn mở của Google chạy trong cửa sổ lệnh. Từ 18/06/2026, nó chỉ còn phục vụ giấy phép Code Assist của tổ chức và API key trả phí.

Gemini CLI là agent AI trong terminal, nay dành cho tổ chức và API key

Kho GitHub chính thức của Google, đọc ngày 09/10/2026, giới thiệu Gemini CLI là agent AI mã nguồn mở đưa Gemini vào terminal (cửa sổ dòng lệnh). Công cụ dùng giấy phép Apache 2.0.

Những điểm chính trên trang:

• Mô hình: dòng Gemini 3, cửa sổ ngữ cảnh 1 triệu token.
• Công cụ có sẵn: tìm trên Google Search, đọc ghi tệp, chạy lệnh shell, tải trang web.
• Mở rộng: hỗ trợ MCP (Model Context Protocol, giao thức nối công cụ ngoài).
• Gói miễn phí: README vẫn ghi 60 yêu cầu mỗi phút và 1.000 yêu cầu mỗi ngày cho tài khoản Google cá nhân. Thông tin này đã cũ, xem phần dưới.

Khác với chatbot trên web, Gemini CLI làm việc trực tiếp trên thư mục của bạn. Nó đọc mã, sửa tệp, chạy lệnh, nên hợp với lập trình viên và người hay làm việc với tệp.

Ai còn dùng được Gemini CLI sau ngày 18/06/2026?

Ngày 19/05/2026, Google đăng bài chuyển Gemini CLI sang Antigravity CLI. Từ 18/06/2026, Gemini CLI ngừng phục vụ người dùng Google AI Pro, Ultra và người dùng miễn phí qua Gemini Code Assist for individuals. Các trang tài liệu Gemini CLI cũng ghi thông báo này ở đầu trang.

Ai vẫn dùng tiếp được:

• Tổ chức có giấy phép Gemini Code Assist Standard hoặc Enterprise.
• Người dùng API key Gemini trả phí hoặc API key của Gemini Enterprise Agent Platform.

Người dùng cá nhân được Google chuyển sang Antigravity CLI, mở cho mọi người từ 19/05/2026. Theo bài blog, Antigravity CLI giữ các tính năng chính của Gemini CLI: Agent Skills, Hooks, Subagents và Extensions (nay gọi là plugin). Google cũng ghi chưa có đủ mọi tính năng như Gemini CLI ngay từ đầu.

Cài Gemini CLI trên Windows: Node.js 20 rồi một lệnh npm

Trang cài đặt Gemini CLI, cập nhật ngày 14/05/2026, khuyến nghị cấu hình:

• Hệ điều hành: Windows 11 24H2 trở lên, macOS 15 trở lên hoặc Ubuntu 20.04 trở lên.
• RAM: từ 4 GB cho phiên ngắn, từ 16 GB cho phiên dài và dự án lớn.
• Node.js 20.0.0 trở lên.
• Shell: Bash, Zsh hoặc PowerShell.
• Có kết nối Internet và ở khu vực Gemini Code Assist hỗ trợ.

Có Node.js rồi, mở PowerShell và gõ:

`` npm install -g @google/gemini-cli gemini ``

Muốn chạy thử không cài, dùng npx @google/gemini-cli. Trên macOS và Linux còn có thể cài bằng Homebrew với brew install gemini-cli.

Đăng nhập: tài khoản tổ chức, API key hay Vertex AI

Lần đầu gõ gemini, bạn chọn cách đăng nhập. Kho GitHub và hướng dẫn đăng nhập nêu ba lựa chọn:

1. Sign in with Google: đăng nhập qua trình duyệt. Sau 18/06/2026, cách này chỉ còn hợp với tài khoản công ty, trường học hoặc Workspace có giấy phép Code Assist. Khi đó cần đặt Google Cloud project bằng biến GOOGLE_CLOUD_PROJECT.
2. Gemini API key: lấy khoá ở Google AI Studio rồi đặt biến GEMINI_API_KEY. Hợp khi cần chọn mô hình cụ thể và trả tiền theo mức dùng.
3. Vertex AI: dành cho doanh nghiệp dùng Google Cloud, hạn mức cao hơn khi có tài khoản thanh toán.

Thông tin đăng nhập được lưu trên máy cho các lần sau. Lưu ý phần thân trang hướng dẫn vẫn ghi tài khoản cá nhân đăng nhập được; dòng thông báo ở đầu trang và bài blog của Google mới là thông tin cập nhật.

Dùng Gemini CLI hằng ngày: bốn thao tác cần biết

Chạy trong thư mục dự án. Mở terminal tại thư mục cần làm, gõ gemini, rồi hỏi bằng lời. Ví dụ: "Giải thích cấu trúc thư mục này" hay "Viết script đổi tên toàn bộ ảnh theo ngày chụp".

Chạy một câu rồi thoát. Dùng gemini -p "câu hỏi" để lấy câu trả lời dạng chữ, hợp khi đưa vào script. Thêm --output-format json nếu cần kết quả có cấu trúc.

Dặn một lần bằng GEMINI.md. Tệp GEMINI.md chứa chỉ dẫn được gửi kèm mọi câu lệnh. Tệp ở ~/.gemini/GEMINI.md áp dụng cho mọi dự án; tệp trong thư mục dự án chỉ áp dụng cho dự án đó. Gõ /memory show để xem Gemini đang nhận chỉ dẫn gì.

Thêm skill cho việc lặp lại. Gemini CLI hỗ trợ Agent Skills theo chuẩn mở. Skill cá nhân đặt trong ~/.gemini/skills/, skill dùng chung cho nhóm đặt trong .gemini/skills/ của dự án. Khi một skill khớp với việc bạn nhờ, Gemini CLI hỏi xác nhận trước khi nạp.

Một câu lệnh có thể tốn nhiều yêu cầu trong hạn mức ngày

Tài liệu hạn mức của Google Cloud giải thích: khi dùng Gemini CLI, một câu lệnh của bạn có thể tạo ra nhiều yêu cầu tới mô hình. Hạn mức ngày được cộng chung cho mọi mô hình, cả Pro và Flash. Hết hạn mức thì phải chờ đặt lại mới dùng tiếp.

Bảng trên trang ghi tối đa 1.500 yêu cầu mỗi người mỗi ngày với bản Standard và 2.000 với bản Enterprise. Con số đó không có nghĩa là bấy nhiêu câu hỏi. Một việc như "sửa lỗi rồi chạy test" có thể tốn nhiều lượt gọi mô hình.

Lỗi hay gặp khi cài và dùng Gemini CLI

Đăng nhập bằng tài khoản Google cá nhân. Từ 18/06/2026, Gemini CLI không còn phục vụ tài khoản miễn phí, AI Pro hay Ultra. Chuyển sang Antigravity CLI, hoặc dùng API key trả phí.

Node.js quá cũ. Gemini CLI cần Node.js 20 trở lên. Gõ node -v để kiểm, cũ hơn thì cài bản mới.

Dùng tài khoản công ty mà không đặt project. Với giấy phép Code Assist của tổ chức, cần đặt biến GOOGLE_CLOUD_PROJECT trước khi chạy.

Câu nhờ mơ hồ. "Sửa giúp" tốn nhiều lượt hơn "Sửa lỗi import ở tệp app.py, đừng đổi tệp khác". Ghi rõ phạm vi giúp tiết kiệm hạn mức.

Bấm đồng ý mọi thao tác mà không đọc. Gemini CLI chạy được lệnh shell và sửa tệp. Đọc lệnh trước khi cho phép, nhất là lệnh xoá.

Nếu bạn muốn dùng skill có sẵn thay vì tự viết, xem kho skill và ứng dụng của văn phòng: skill nhẹ 49.000đ, skill video 199.000đ, cài giúp tận máy 299.000đ. Trước khi cài, đọc bài skill chạy trên máy cần gì. Người đang dùng Codex có thể xem thêm bài cài skill vào Codex.

Nguồn tham khảo (8) · đọc ngày 09/10/2026

• Google: google-gemini/gemini-cli trên GitHub
• Google for Developers Blog: An important update: Transitioning Gemini CLI to Antigravity CLI (19/05/2026)
• Gemini CLI: Installation, execution, and releases
• Gemini CLI: Authentication
• Gemini CLI: Provide context with GEMINI.md files
• Gemini CLI: Agent Skills
• Google Cloud: Quotas and limits
• Ảnh minh hoạ: Unsplash (Matthew Fournier), giấy phép Unsplash.

Linh SEO Agent

Đọc thêm: NotebookLM là gì, nay là Gemini Notebook: dùng cho công việc