Trải nghiệm khi dùng Gemini CLI
Bạn cài Gemini CLI bằng npm hoặc Homebrew, vào thư mục dự án và gõ gemini. Công cụ hỏi cách đăng nhập: bằng tài khoản Google (nếu tổ chức bạn có giấy phép Code Assist, kèm project Google Cloud), bằng khoá Gemini API, hoặc qua Vertex AI. Sau đó bạn trò chuyện trong Terminal như với một đồng nghiệp biết code.
Bạn có thể nhờ giải thích dự án, tóm tắt thay đổi hôm qua, tạo ứng dụng mới từ mô tả hoặc từ PDF, ảnh phác thảo nhờ khả năng đa phương thức. Chế độ không tương tác cho phép chạy trong script, ví dụ gemini với tuỳ chọn -p để hỏi một câu và lấy kết quả dạng văn bản hoặc JSON.
Điều cần biết trước khi bắt đầu: README đầu trang cảnh báo công cụ không dành cho gói miễn phí hay gói Google AI Pro, Ultra nữa, và chưa tối ưu cho dòng Gemini 4 trở lên. Nếu bạn là cá nhân, hãy xem Antigravity CLI mà README đề xuất thay thế.
Tính năng nổi bật
Agent trong Terminal
Gõ gemini trong thư mục dự án để hỏi đáp, sửa code và gỡ lỗi bằng ngôn ngữ thường.
Chế độ không tương tác
Dùng -p để chạy một lần trong script, kèm đầu ra văn bản, JSON hoặc luồng sự kiện JSON.
Hỗ trợ MCP
Kết nối thêm khả năng qua MCP server, ví dụ sinh ảnh, video hay nhạc bằng các công cụ của Google.
Nhiều cách đăng nhập
Đăng nhập bằng Google (với giấy phép Code Assist), khoá Gemini API hoặc Vertex AI.
Nhiều kênh phát hành
Bản stable hàng tuần, preview và nightly để bạn chọn mức ổn định mong muốn.
Giấy phép Apache-2.0
Mã nguồn mở, có tài liệu đầy đủ tại geminicli.com/docs.
Tận dụng Gemini CLI vào việc gì?
Nhóm kỹ thuật doanh nghiệp
Làm việc trong tổ chức dùng Google Cloud
Công ty đã có Gemini Code Assist Standard hoặc Enterprise có thể dùng Gemini CLI với tài khoản của tổ chức.
Lập trình viên
Tóm tắt và giải thích mã nguồn
Nhờ tóm tắt thay đổi mới trong repo hoặc giải thích kiến trúc một dự án lạ.
Kỹ sư DevOps
Tự động hoá trong script và CI
Chạy gemini -p trong script để lấy câu trả lời dạng JSON phục vụ các bước tự động.
Người làm sản phẩm, freelancer
Tạo bản dựng đầu tiên từ phác thảo
Cung cấp mô tả hoặc ảnh phác thảo để Gemini gợi ý bản code khởi đầu.
Cần chuẩn bị gì?
- Node.js (README hướng dẫn cài qua npm, hoặc dùng Homebrew, MacPorts, Anaconda).
- Giấy phép Gemini Code Assist Standard hoặc Enterprise, hoặc khoá Gemini API hay Vertex AI cho các lựa chọn còn lại.
- Kết nối Internet, vì mô hình chạy trên hạ tầng của Google.
- Windows, macOS hoặc Linux có Terminal.
Hướng dẫn cài đặt chi tiết
Cài trên npm (mọi hệ điều hành)
Cài Node.js nếu chưa có. Sau đó chạy thử ngay không cần cài đặt bằng npx.
npx @google/gemini-cliHoặc cài toàn cục để gọi bằng lệnh gemini ở mọi nơi.
npm install -g @google/gemini-cliMuốn bản ổn định theo tuần dùng thẻ latest, muốn thử bản mới dùng thẻ preview hoặc nightly (có thể có lỗi).
npm install -g @google/gemini-cli@latest
Cài trên macOS / Linux
Cài bằng Homebrew.
brew install gemini-cliTrên macOS cũng có MacPorts.
sudo port install gemini-cliTrong môi trường hạn chế, README gợi ý tạo môi trường Anaconda có nodejs rồi cài bằng npm bên trong môi trường đó.
Dùng thử lần đầu
Quyết định cách đăng nhập. Với tổ chức có Code Assist, đặt biến chỉ dự án Google Cloud rồi chạy gemini (thay YOUR_PROJECT_ID bằng ID dự án của bạn).
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID" geminiNếu dùng khoá API lấy ở Google AI Studio, thay YOUR_API_KEY bằng khoá của bạn, đặt biến môi trường GEMINI_API_KEY rồi chạy gemini (trên Windows PowerShell dùng $env:GEMINI_API_KEY).
export GEMINI_API_KEY="YOUR_API_KEY" geminiTrong thư mục dự án, hỏi một câu chỉ đọc để làm quen.
gemini -p "Explain the architecture of this codebase"Mở chế độ chat bằng gemini và thử yêu cầu thật, ví dụ viết bot Discord trả lời câu hỏi từ một file FAQ.md mà bạn cung cấp.
Mẹo dùng hay
- Đọc khung cảnh báo ở đầu README trước khi cài vì chính sách và đối tượng dùng đã thay đổi.
- Nếu bạn là cá nhân hoặc dùng gói Google AI Pro hay Ultra, xem Antigravity CLI mà README đề xuất.
- Dùng --include-directories để cho agent đọc thêm thư mục ngoài thư mục hiện tại.
- Dùng đầu ra JSON khi muốn xử lý kết quả trong script.
Lưu ý và hạn chế
- README nêu rõ không còn gói miễn phí cho cá nhân và không dành cho Google AI Pro, Ultra; đối tượng chính là khách hàng Code Assist Standard hoặc Enterprise.
- Công cụ chưa được tối ưu cho dòng Gemini 4 trở lên và README khuyên không dùng nó để đo điểm benchmark mô hình.
- Khoá API bị tính phí theo lượng dùng; đừng để lộ khoá trong file chia sẻ hoặc kho mã.
Câu hỏi thường gặp
Gemini CLI còn miễn phí không?
Theo README hiện tại thì không: truy cập miễn phí cho cá nhân và gói Google AI Pro, Ultra đã chuyển sang Antigravity CLI. Công cụ mã nguồn mở nhưng cần giấy phép doanh nghiệp hoặc khoá API trả phí.
Tôi nên dùng Gemini CLI hay Antigravity CLI?
README chỉ rõ Antigravity CLI là lựa chọn cho tài khoản miễn phí, Google AI Pro hoặc Ultra và mô hình mới. Gemini CLI dành cho tổ chức có Code Assist Standard hoặc Enterprise.
Có gõ yêu cầu bằng tiếng Việt được không?
Được, mô hình Gemini hiểu tiếng Việt; giao diện và tài liệu công cụ chủ yếu là tiếng Anh.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/google-gemini/gemini-cli.gitRepo tương tự nên xem
Claude Code
anthropics / claude-code
Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường
Codex CLI
openai / codex
Trợ lý AI viết code của OpenAI chạy nhẹ trong Terminal, đăng nhập bằng tài khoản ChatGPT hoặc khoá API
OpenCode
anomalyco / opencode
Trợ lý AI viết code mã nguồn mở, chạy trong Terminal hoặc app desktop, nối được nhiều nhà cung cấp mô hình