Gemini CLI: Hướng Dẫn Cài Đặt, Thiết Lập và Sử Dụng Miễn Phí

Gemini CLI của Google đưa Gemini 2.5 Pro trực tiếp vào cửa sổ terminal — miễn phí với quota 1.000 yêu cầu mỗi ngày. Nếu việc chuyển qua lại giữa trình duyệt và IDE làm chậm nhịp làm việc của bạn, CLI này giải quyết điều đó bằng cách cho phép query và chỉnh sửa codebase lớn ngay trong môi trường terminal quen thuộc.

Trạng thái: Miễn phí với giới hạn sử dụng cao · Nguồn gốc: Mã nguồn mở từ Google · Cài đặt: npm install -g · Mục đích chính: Xây dựng, debug và deploy mã · Tích hợp: Terminal và VSCode

Gemini CLI là gì?

Gemini CLI là công cụ dòng lệnh (command-line interface) mã nguồn mở từ Google, đưa mô hình AI Gemini trực tiếp vào terminal của nhà phát triển. Khác với việc truy cập Gemini qua trình duyệt, CLI này cho phép bạn query và chỉnh sửa codebase lớn ngay trong môi trường làm việc quen thuộc. QuanTriMang.com nhận định đây là bước tiến quan trọng giúp developer tiếp cận AI coding mà không cần rời bỏ terminal.

Tính năng chính

• Query codebase lớn: Gemini CLI hỗ trợ cửa sổ ngữ cảnh lên đến 1 triệu token với Gemini 2.5 Pro, cho phép phân tích toàn bộ dự án trong một lần gửi yêu cầu.
• Tạo ứng dụng từ hình ảnh hoặc PDF: Bạn có thể mô tả giao diện hoặc tải lên tài liệu, Gemini CLI sẽ tạo code tương ứng.
• Tự động hóa workflow: Tích hợp với các công cụ terminal, hỗ trợ viết script và deployment trực tiếp.
• Khác với Gemini Code Assist (extension cho IDE), Gemini CLI chạy độc lập trên terminal và có thể tương tác với nhiều workspace cùng lúc.

So sánh với các CLI khác

Gemini CLI cung cấp lightweight access đến Gemini mà không yêu cầu cài đặt phức tạp hay đăng ký dịch vụ trả phí.

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

Có, Gemini CLI miễn phí với tier miễn phí generous dành cho developer cá nhân. Theo Google Codelabs, quota miễn phí bao gồm 60 yêu cầu mỗi phút và 1.000 yêu cầu mỗi ngày khi sử dụng Gemini 2.5 Pro. Quota này phù hợp với hầu hết nhu cầu học tập và dự án cá nhân.

Giới hạn sử dụng miễn phí

• 60 requests mỗi phút — đủ cho các tác vụ coding thông thường
• 1.000 requests mỗi ngày — bao gồm cả việc query lớn với Gemini 2.5 Pro
• Cửa sổ ngữ cảnh 1 triệu token — cho phép phân tích codebase quy mô lớn

Quota miễn phí này cao hơn đáng kể so với nhiều công cụ AI coding trả phí khác trên thị trường.

Quotas và pricing

Theo GeminiCLI.com, Gemini CLI là mã nguồn mở và miễn phí sử dụng. Tuy nhiên, chi phí thực tế phát sinh từ việc sử dụng API của Google. Cụ thể:

• Cá nhân sử dụng tài khoản Google thường — quota miễn phí áp dụng
• Doanh nghiệp cần quota cao hơn — nâng cấp qua Google AI Studio hoặc Vertex AI
• Gemini Code Assist và CLI chia sẻ hạn mức sử dụng trên cùng tài khoản Google

Cách thiết lập Gemini CLI?

Việc cài đặt Gemini CLI yêu cầu Node.js phiên bản 20 trở lên và npm. Quá trình thiết lập bao gồm ba bước chính: cài đặt Node.js, cài đặt Gemini CLI, và xác thực tài khoản Google.

Cài đặt qua npm

Cách nhanh nhất để cài đặt Gemini CLI là thông qua npm với lệnh toàn cục:

Sau khi cài đặt thành công, bạn có thể chạy Gemini CLI bằng lệnh gemini trong terminal. Google Codelabs khuyến nghị sử dụng fnm (Fast Node Manager) để quản lý Node.js trên Linux, nhưng bạn có thể dùng bất kỳ phương pháp nào quen thuộc.

Trên macOS và Windows, bạn có thể tải Node.js từ trang chính thức hoặc sử dụng các trình quản lý phiên bản khác.

Xác thực authentication

Sau khi cài đặt, Gemini CLI sẽ yêu cầu bạn đăng nhập bằng tài khoản Google. Google Codelabs lưu ý rằng bạn nên sử dụng tài khoản cá nhân thay vì Google Workspace — điều này giúp tránh xung đột permission trong môi trường lab và đảm bảo quota miễn phí được áp dụng đúng cách.

Quá trình xác thực sẽ mở trình duyệt để bạn đăng nhập và cấp quyền cho Gemini CLI truy cập tài khoản Google của mình.

Cách sử dụng Gemini CLI?

Sau khi thiết lập, bạn có thể bắt đầu sử dụng Gemini CLI cho các tác vụ coding. Google Codelabs cung cấp các ví dụ hands-on cụ thể từ việc query codebase đến tạo ứng dụng từ hình ảnh.

Lệnh cơ bản

Gemini CLI hoạt động ở chế độ interactive — bạn nhập prompt và nhận phản hồi trực tiếp trong terminal:

• Chạy gemini để bắt đầu phiên tương tác
• Sử dụng @file để tham chiếu đến file trong codebase
• Prompt bằng ngôn ngữ tự nhiên để mô tả tác vụ cần thực hiện
• Gemini CLI sẽ đọc file, phân tích code, và đề xuất giải pháp hoặc tạo code mới

Ví dụ, bạn có thể hỏi “Tóm tắt chức năng chính của thư mục src” và Gemini CLI sẽ phân tích toàn bộ codebase rồi trả về tóm tắt chi tiết.

Tích hợp VSCode

Để sử dụng Gemini trong VSCode một cách liền mạch, bạn cần cài đặt Gemini Code Assist từ VS Code Marketplace. Extension này bổ sung các tính năng AI coding trực tiếp vào trình soạn thảo, bao gồm:

• Inline code completion trong khi gõ
• Giải thích code được chọn
• Tạo unit tests tự động
• Refactoring suggestions

Lưu ý rằng Gemini Code Assist và Gemini CLI chia sẻ quota từ cùng tài khoản Google. Nếu bạn sử dụng cả hai, hãy theo dõi tổng số requests để tránh vượt quá giới hạn hàng ngày.

Gemini CLI vs Claude Code: Nên chọn cái nào?

Cả hai công cụ đều là AI agent mạnh mẽ cho coding, nhưng có những khác biệt quan trọng về chi phí và tính năng. Apidog và các nguồn khác đã phân tích chi tiết để giúp bạn đưa ra quyết định phù hợp.

Bảng so sánh

Hai công cụ này có mô hình pricing và tính năng khác nhau đáng kể.

Gemini CLI có lợi thế rõ rệt về chi phí cho developer cá nhân và dự án nhỏ, trong khi Claude Code phù hợp hơn cho doanh nghiệp cần hỗ trợ chuyên sâu và SLA.

Khi nào chọn Gemini CLI

• Bạn là developer cá nhân hoặc nhóm nhỏ với ngân sách hạn chế
• Cần phân tích codebase lớn (hơn 100K token)
• Muốn tùy chỉnh và contribute vào mã nguồn mở
• Đang học và thực hành AI coding mà không muốn đầu tư trả phí

Ưu nhược điểm cho Python

Gemini 2.5 Pro hỗ trợ tốt các tác vụ Python như tạo script automation, debug, và refactoring. Tuy nhiên, Apidog nhận định rằng Claude Code có lịch sử mạnh hơn trong việc xử lý các project Python phức tạp với nhiều dependencies và cấu trúc module đa dạng.

Giải pháp thay thế

Ngoài Claude Code, bạn có thể thử Open Codex CLI — một công cụ mã nguồn mở hỗ trợ Gemini, cài đặt bằng npm install -g open-codex. Apidog cho biết Open Codex CLI có thể được cấu hình qua biến môi trường hoặc file ~/.codex/config.json để sử dụng API Gemini của bạn.

Thông số kỹ thuật

Bảy yếu tố kỹ thuật chính quyết định cách Gemini CLI hoạt động trong môi trường phát triển của bạn.

Những thông số này cho thấy Gemini CLI phù hợp với hầu hết môi trường phát triển hiện đại mà không cần cấu hình phức tạp.

Ưu điểm và nhược điểm

Các bước thiết lập nhanh

Để bắt đầu với Gemini CLI, bạn cần hoàn thành năm bước cài đặt cơ bản.

1. Kiểm tra phiên bản Node.js: Chạy node -v để đảm bảo bạn có Node.js 20 trở lên. Nếu chưa, tải và cài đặt từ nodejs.org hoặc sử dụng fnm trên Linux.
2. Cài đặt Gemini CLI: Chạy npm install -g @google/gemini-cli trong terminal. Quá trình cài đặt sẽ tự động hoàn tất trong vài phút.
3. Xác thực tài khoản Google: Chạy lệnh gemini và làm theo hướng dẫn trên màn hình để đăng nhập qua trình duyệt. Sử dụng tài khoản Google cá nhân, không phải Google Workspace.
4. Bắt đầu phiên làm việc: Gõ gemini trong terminal và bắt đầu nhập prompt. Gemini CLI sẽ phản hồi trực tiếp trong cửa sổ terminal.
5. Thử nghiệm với codebase: Sử dụng @file để tham chiếu đến các file trong dự án, ví dụ: “Giải thích chức năng của @src/main.py” để Gemini CLI phân tích code.

“Gemini CLI gives you direct access to Gemini for coding” — Tài liệu chính thức từ Google Codelabs

“Lightweight access to Gemini” — Mã nguồn chính thức trên GitHub của Google

Tóm tắt

Gemini CLI là lựa chọn mạnh mẽ cho developer Việt Nam muốn tiếp cận AI coding mà không tốn chi phí. Với quota miễn phí 60 req/phút và 1.000 req/ngày từ Google, bạn có thể phân tích codebase lớn, debug, và tạo code mới ngay trong terminal. Với developer cá nhân và nhóm nhỏ, bắt đầu với Gemini CLI giúp bạn tiết kiệm chi phí đầu tư ban đầu mà vẫn tiếp cận được sức mạnh của Gemini 2.5 Pro miễn phí.

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