Gemini CLI: Trợ Lý AI Cho Terminal
google-gemini/gemini-cli
Gemini CLI đưa một agent chạy bằng Gemini thẳng vào terminal của bạn, với lệnh shell, chỉnh sửa file, và Google Search grounding được tích hợp sẵn chứ không phải gắn thêm. Chọn công cụ này nếu bạn đã có tài khoản Google và muốn một trợ lý coding miễn phí, chạy ngay trong terminal; bỏ qua nếu bạn cần hỗ trợ đa nhà cung cấp model hoặc bộ nhớ phiên tự lưu mà không cần checkpoint thủ công.
Đưa Gemini Vào Terminal Của Bạn
Gemini CLI là agent mã nguồn mở viết bằng TypeScript của Google, chạy như một lệnh terminal — gemini — đưa một trợ lý AI chạy bằng Gemini thẳng vào shell của bạn. Nó đọc và chỉnh sửa file, thực thi lệnh shell, lấy nội dung từ web, và neo câu trả lời vào kết quả Google Search thời gian thực, tất cả trong cùng phiên terminal bạn vẫn dùng cho git và npm.
Tính Năng Cốt Lõi Và Công Cụ Tích Hợp Sẵn
- ✓Gói OAuth miễn phí: 60 request/phút và 1.000 request/ngày với tài khoản Google cá nhân, kèm quyền truy cập model Gemini 3 và cửa sổ ngữ cảnh 1M token — không cần quản lý API key.
- ✓Thực thi shell, thao tác file system, và lấy nội dung web được tích hợp sẵn, nên Gemini CLI có thể đọc một file, chạy test, và hành động theo kết quả mà không cần rời khỏi terminal.
- ✓Google Search grounding đưa kết quả tìm kiếm thời gian thực vào câu trả lời thay vì chỉ dựa vào dữ liệu huấn luyện.
- ✓Hỗ trợ MCP client và server cho phép gắn thêm công cụ tùy chỉnh — README có ví dụ các lệnh như @github, @slack, và @database sau khi cấu hình server trong ~/.gemini/settings.json.
- ✓File GEMINI.md lưu ngữ cảnh và hướng dẫn riêng cho từng project, tồn tại xuyên suốt phiên làm việc.
- ✓Checkpoint hội thoại cho phép lưu và khôi phục một phiên làm việc, hữu ích khi một lần debug không xong trong một lần ngồi.
- ✓Gemini CLI GitHub Action chạy review pull request, phân loại issue, và hỗ trợ theo yêu cầu khi ai đó nhắc @gemini-cli trong issue hoặc pull request.
- ✓Ba kênh phát hành — nightly, preview, và stable — ra mắt theo lịch cố định hàng tuần thay vì tùy hứng.
Ứng Dụng Thực Tế Trong Phát Triển Phần Mềm
- •Truy vấn và chỉnh sửa một codebase lớn bằng ngôn ngữ tự nhiên thay vì grep thủ công qua từng file.
- •Tạo một app mới từ bản phác thảo, PDF, hoặc hình ảnh nhờ khả năng đa phương thức (multimodal) của Gemini.
- •Tự động hóa các việc vận hành — README nêu cụ thể việc truy vấn pull request đang mở và xử lý rebase phức tạp.
- •Chạy Gemini CLI ở chế độ non-interactive trong script CI với gemini -p "..." --output-format json để lấy output có cấu trúc mà pipeline parse được.
- •Gắn thêm MCP server cho các tác vụ ngoài công cụ tích hợp sẵn, như tạo media qua Imagen, Veo, hoặc Lyria thông qua một server đã kết nối.
Cách Cài Đặt Gemini CLI
Chạy npx @google/gemini-cli để dùng thử mà không cần cài đặt, hoặc npm install -g @google/gemini-cli để có lệnh toàn cục. Người dùng macOS và Linux cũng có thể chạy brew install gemini-cli, và macOS còn có đường cài qua MacPorts: sudo port install gemini-cli. Với môi trường hạn chế không có quyền truy cập npm, có cách dùng Anaconda — tạo một môi trường conda với nodejs, rồi npm install -g @google/gemini-cli bên trong đó. Để chốt một kênh phát hành cụ thể thay vì bản stable mặc định, cài kèm tag rõ ràng: npm install -g @google/gemini-cli@preview hoặc @nightly. Bản preview ra hàng tuần vào thứ Ba lúc 23:59 UTC, bản stable đưa nguyên bản preview tuần trước (cộng thêm bản vá) vào lúc 20:00 UTC cùng ngày, còn bản nightly build lại từ nhánh main mỗi ngày lúc 00:00 UTC.
Tương Tác Cơ Bản Và Viết Script
Gõ gemini trong thư mục project để bắt đầu phiên tương tác, hoặc thêm --include-directories ../lib,../docs để đưa thêm thư mục khác vào ngữ cảnh. Chọn model bằng -m gemini-2.5-flash. Với script, bỏ qua hoàn toàn chế độ tương tác: gemini -p "Explain the architecture of this codebase" trả về văn bản thuần, thêm --output-format json để có output có cấu trúc mà script parse được, hoặc --output-format stream-json để stream các sự kiện dạng newline-delimited JSON khi một tác vụ dài đang chạy.
Các Phương Thức Xác Thực Phù Hợp Với Từng Nhu Cầu
Nhà phát triển cá nhân đăng nhập bằng tài khoản Google dùng OAuth: không cần quản lý API key, model tự động cập nhật, và cùng gói miễn phí (60 request/phút, 1.000 request/ngày) như mọi người khác trên đường này. Nhà phát triển muốn chọn một model Gemini cụ thể hoặc chuyển sang thanh toán theo mức sử dụng nên dùng API key — đường này cũng có gói miễn phí 1.000 request/ngày với hỗn hợp model Gemini 3 flash và pro. Đội ngũ enterprise chạy workload production nên dùng Vertex AI, đánh đổi việc thiết lập đơn giản hơn để lấy billing qua Google Cloud, rate limit cao hơn, và các tính năng tuân thủ.
Điểm mạnh
- ✓Miễn phí ngay từ đầu: đăng nhập OAuth bằng tài khoản Google cá nhân không tốn phí, không cần thẻ tín dụng, không cần thiết lập API key.
- ✓Mọi thứ diễn ra trong terminal — không cần chuyển qua tab trình duyệt để copy-paste code qua lại.
- ✓Hỗ trợ MCP nghĩa là bạn không bị giới hạn ở các công cụ tích hợp sẵn; kết nối một server GitHub, Slack, hoặc database và gọi nó bằng cú pháp @ mention.
- ✓Google Search grounding nghĩa là câu trả lời có thể trích dẫn kết quả thời gian thực thay vì dữ liệu huấn luyện đã cũ.
- ✓GitHub Action mang cùng agent này vào review pull request và phân loại issue mà không cần một tích hợp riêng biệt.
- ✓Ba kênh phát hành (nightly, preview, stable) cho phép chọn mức độ rủi ro đổi lấy mức độ mới của code.
Hiểu Về Các Mức Sử Dụng Và Độ Ổn Định Của Bản Phát Hành
- △Mọi đường xác thực đều đi qua Google — OAuth cần tài khoản Google, API key lấy từ Google AI Studio, còn Vertex AI cần một project Google Cloud. Không có đường dùng API key từ nhà cung cấp thứ ba.
- △Checkpoint hội thoại phải được kích hoạt và khôi phục thủ công — Gemini CLI không tự giữ bộ nhớ phiên làm việc sau khi khởi động lại.
- △Giới hạn 60 request/phút và 1.000 request/ngày của gói OAuth miễn phí có thể nhanh chóng trở nên chật hẹp trong một monorepo lớn hoặc một pipeline CI bận rộn.
- △Nó chạy lệnh shell và chỉnh sửa file trực tiếp, nên một phiên làm việc chỉ an toàn tương ứng với mức độ tin tưởng bạn đặt vào nó; Trusted Folders giới hạn phạm vi này nhưng cần thêm cấu hình để thiết lập.
- △Cần có Node.js mới chạy được — môi trường hạn chế không có quyền truy cập npm phải dùng cách Anaconda thay vì cài trực tiếp.
Các Công Cụ AI Dòng Lệnh Tương Tự
Câu Hỏi Thường Gặp
Gemini CLI miễn phí qua đăng nhập OAuth với tài khoản Google cá nhân, giới hạn ở 60 request mỗi phút và 1.000 request mỗi ngày — không cần thẻ tín dụng hay API key để bắt đầu.
Gemini CLI cho người dùng OAuth và API key quyền truy cập model Gemini 3, bao gồm cửa sổ ngữ cảnh 1M token; đường API key dùng hỗn hợp model Gemini 3 flash và pro ở gói miễn phí.
Chạy npx @google/gemini-cli để dùng thử không cần cài đặt, npm install -g @google/gemini-cli để có lệnh toàn cục, hoặc brew install gemini-cli trên macOS và Linux.
Gemini CLI hỗ trợ chạy script không tương tác: gemini -p "prompt của bạn" chạy ở chế độ headless và trả về văn bản, thêm --output-format json hoặc stream-json để có output mà script parse được.
Hỗ trợ MCP (Model Context Protocol) cho phép Gemini CLI kết nối tới server bên ngoài để dùng công cụ tùy chỉnh — cấu hình trong ~/.gemini/settings.json, rồi gọi bằng cú pháp @ mention như @github hoặc @slack.
Gemini CLI phát hành theo giấy phép Apache-2.0, một giấy phép mã nguồn mở permissive, áp dụng cho toàn bộ dự án Gemini CLI trên GitHub.
Vấn đề mà nó giải quyết
Coding trong terminal thường có nghĩa là chuyển qua lại giữa một tab trình duyệt để hỏi AI và một shell để làm việc thật — copy một đoạn code ra, paste câu trả lời vào, mất ngữ cảnh file mỗi lần như vậy. Cách Gemini CLI giải quyết là chạy agent như một lệnh shell đã có sẵn quyền truy cập file system, shell, và web-fetch, nên model đọc đúng repo của bạn và chạy lệnh thay vì bạn phải chuyển tiếp ngữ cảnh qua lại bằng tay.