Gemini CLI: hướng dẫn cài đặt và sử dụng miễn phí

Thử hình dung chị kế toán có một thư mục 300 hóa đơn PDF, tên file lộn xộn, tháng nào cũng có. Sếp cần xếp lại theo tháng trước buổi họp chiều nay. Làm tay thì mất cả buổi sáng, nhờ IT thì IT đang bận.

Từ ngày 25/06/2025, chị có thể mở terminal, gõ một câu tiếng Việt và để Gemini CLI đề xuất cách làm. Không thẻ tín dụng, chỉ cần tài khoản Google.

Gemini CLI là agent AI mã nguồn mở của Google, chạy trong terminal, dùng để hỏi đáp về code, sửa file, chạy lệnh và tự động hóa việc lặp lại trên máy tính. Google công bố Gemini CLI ngày 25/06/2025 ở dạng preview, giấy phép Apache 2.0.

Đọc nhanh trong 30 giây

• Gemini CLI là agent AI mã nguồn mở (Apache 2.0) của Google, chạy trong terminal, công bố ngày 25/06/2025.
• Đăng nhập tài khoản Google cá nhân là dùng được Gemini 2.5 Pro, theo Google là 60 lượt mỗi phút và 1.000 lượt mỗi ngày.
• Cài bằng npm install -g @google/gemini-cli, cần Node.js 18 trở lên.
• Hợp để làm quen với agent AI; bản miễn phí chưa hợp với dữ liệu nhạy cảm.

Gemini CLI là gì, dùng vào việc gì?

Gemini CLI là chương trình dòng lệnh: anh chị gõ yêu cầu bằng tiếng thường, Gemini đọc thư mục hiện tại, đề xuất việc cần làm, rồi gọi công cụ để đọc file, sửa file hoặc chạy lệnh. Theo bài công bố, người dùng miễn phí được cửa sổ ngữ cảnh 1 triệu token, đủ để nạp cả một codebase lớn.

Cửa sổ ngữ cảnh giống mặt bàn làm việc: bàn càng rộng, càng trải được nhiều hồ sơ ra cùng lúc để đối chiếu, khỏi phải cất vào lấy ra.

Bốn con số khiến Gemini CLI được chú ý ngay ngày đầu.

Theo README ngày ra mắt, anh chị có thể:

• Hỏi và sửa codebase lớn trong và vượt khỏi cửa sổ 1 triệu token.
• Tạo ứng dụng mới từ file PDF hoặc bản phác thảo.
• Tự động hóa việc vận hành như xem pull request, xử lý rebase phức tạp.
• Gắn thêm công cụ qua MCP server.
• Tra cứu thông tin mới bằng Google Search có sẵn.

Người không viết code cũng dùng được. README có ví dụ đổi đuôi toàn bộ ảnh trong thư mục sang PNG, hay xếp hóa đơn PDF theo tháng chi tiêu.

Cài Gemini CLI trong 3 phút

Gemini CLI cài bằng npm và đăng nhập bằng tài khoản Google, không cần khóa API cho lần dùng đầu.

Một lệnh cài, một lần đăng nhập là bắt đầu được.

1. Cài Node.js bản 18 trở lên (README ngày ra mắt ghi yêu cầu này).
2. Chạy thử không cần cài:

npx https://github.com/google-gemini/gemini-cli

Hoặc cài hẳn vào máy rồi gõ gemini:

npm install -g @google/gemini-cli
gemini

3. Chọn giao diện màu.
4. Đăng nhập bằng tài khoản Google cá nhân khi được hỏi.

Cần chọn model cụ thể hoặc hạn mức cao hơn thì tạo khóa ở Google AI Studio rồi đặt biến môi trường:

export GEMINI_API_KEY="YOUR_API_KEY"

Tài khoản Google Workspace dùng cách đăng nhập riêng, xem trang hướng dẫn authentication trong repo.

Thử ngay với hai việc thật

Việc 1: đọc hiểu một hệ thống lạ. Vào thư mục dự án, gõ gemini rồi hỏi:

> Describe the main pieces of this system's architecture.
> What security mechanisms are in place?

Anh chị hỏi bằng tiếng Việt cũng được, ví dụ "Tóm tắt kiến trúc hệ thống này cho người không biết code".

Việc 2: dọn việc giấy tờ. Chị kế toán ở đầu bài mở terminal trong thư mục hóa đơn và gõ:

> Sắp xếp các hóa đơn PDF trong thư mục này vào từng thư mục con theo tháng chi tiêu.

Gemini CLI sẽ đề xuất các lệnh cần chạy và hỏi trước khi thực hiện.

Mẹo

Vài lệnh nên nhớ trong phiên: /memory xem luật đã nạp từ GEMINI.md, /mcp xem MCP server đang kết nối, /stats xem lượt dùng, @tên-file đưa một file vào câu hỏi, !lệnh chạy lệnh shell.

Luật riêng cho dự án đặt trong file GEMINI.md, giống mảnh giấy dặn dò dán ở bàn làm việc: ai ngồi vào cũng đọc trước. Cấu hình chung để ở ~/.gemini/settings.json, cấu hình theo dự án để ở .gemini/settings.json, MCP server khai báo trong mục mcpServers của file này.

Gemini CLI khác gì Claude Code?

Gemini CLI và Claude Code cùng là agent lập trình trong terminal, khác nhau chủ yếu ở model, giấy phép và chi phí.

Khác biệt lớn nhất: Gemini CLI có đường dùng miễn phí bằng tài khoản Google.

Thông tin Claude Code lấy theo bài Claude Code chính thức ra mắt ngày 22/05/2025.

Miễn phí thì đổi lại cái gì?

Bản miễn phí của Gemini CLI đổi lại bằng dữ liệu. Giống wifi miễn phí ở quán cà phê: dùng thoải mái, nhưng nên biết mình đang để lại gì.

Lưu ý

• Dữ liệu khi dùng miễn phí: trang Terms of Service và Privacy Notice trong repo ghi rõ, khi đăng nhập tài khoản Google cá nhân, câu lệnh, câu trả lời và code liên quan được thu thập và có thể dùng để cải thiện sản phẩm, gồm cả huấn luyện model. Khóa Gemini API miễn phí cũng vậy. Khóa trả phí, Vertex AI, gói Gemini Code Assist Standard hay Enterprise thì không dùng để huấn luyện.
• Đang preview: bài công bố gọi đây là bản preview, tính năng có thể thay đổi.
• Hạn mức: 60 lượt mỗi phút và 1.000 lượt mỗi ngày là hạn mức Google công bố ngày 25/06/2025 cho giai đoạn preview.
• Agent chạy lệnh thật: luôn đọc lệnh trước khi đồng ý, nhất là lệnh xóa hay di chuyển file.

Nhận xét của chuyên gia

Gemini CLI kéo rào cản thử agent AI xuống gần bằng không: không thẻ tín dụng, không khóa API, chỉ cần tài khoản Google. Với doanh nghiệp Việt, đây là công cụ tốt để nhân viên làm quen với cách làm việc cùng agent trước khi công ty quyết định trả tiền cho công cụ nào.

Hợp với ai: lập trình viên cá nhân, sinh viên, nhân viên văn phòng muốn tự động hóa việc sắp xếp file, đội IT cần đọc nhanh hệ thống lạ.

Chưa hợp với ai: dự án có code hay dữ liệu khách hàng nhạy cảm nếu dùng bản miễn phí, vì điều khoản cho phép Google dùng dữ liệu để huấn luyện.

Cách bắt đầu của tôi: tuần đầu dùng tài khoản cá nhân trên thư mục không nhạy cảm để học cách ra lệnh. Khi đưa vào việc thật, chuyển sang khóa trả phí hoặc Vertex AI, viết một file GEMINI.md ghi quy ước của công ty.

Một câu để nhớ: Gemini CLI miễn phí là sân tập rất tốt, còn việc thật của công ty thì nên chơi trên sân có hợp đồng.

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

Gemini CLI có miễn phí không?

Có. Đăng nhập bằng tài khoản Google cá nhân để nhận giấy phép Gemini Code Assist miễn phí, theo Google là 60 lượt mỗi phút và 1.000 lượt mỗi ngày trong giai đoạn preview.

Gemini CLI có dùng được trên Windows không?

README ngày ra mắt chỉ yêu cầu Node.js bản 18 trở lên và cài bằng npm, không giới hạn hệ điều hành. Lệnh đặt biến môi trường export trong README là cú pháp của macOS và Linux.

Gemini CLI có dùng code của tôi để huấn luyện không?

Tùy cách đăng nhập. Tài khoản Google cá nhân và khóa Gemini API miễn phí thì có thể; khóa trả phí, Vertex AI và gói Gemini Code Assist Standard, Enterprise thì không, theo trang điều khoản trong repo.

Gemini CLI kết nối MCP thế nào?

Khai báo MCP server trong mục mcpServers của file settings.json, rồi gõ /mcp trong phiên để xem các server đang kết nối.

Theo dõi các mốc khác trong chuỗi dòng thời gian AI.

Nguồn: Google, Gemini CLI: your open-source AI agent, 25/06/2025.