Chuyển đến nội dung

google-gemini / gemini-cli

Gemini CLI

Agent AI mã nguồn mở của Google chạy trong Terminal, nay chủ yếu dành cho khách hàng Code Assist doanh nghiệp

Gemini CLI là agent chạy trong Terminal đưa mô hình Gemini vào việc đọc, sửa code và tự động hoá. Lưu ý quan trọng: theo README hiện tại, nó được duy trì cho người dùng Gemini Code Assist Standard hoặc Enterprise trên Google Cloud, còn gói miễn phí và Google AI Pro, Ultra đã chuyển sang Antigravity CLI từ 18/6/2026. Vì vậy hãy đọc kỹ trước khi cài.

  • 108.851 sao
  • 14.957 fork
  • TypeScript
  • Cập nhật hôm nay
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Dòng lệnh (CLI)
Chạy trên
Windows, macOS, Linux, Node.js
Chi phí
Miễn phí (trả phí API AI nếu dùng)

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)

  1. Cài Node.js nếu chưa có. Sau đó chạy thử ngay không cần cài đặt bằng npx.

    Terminal
    npx @google/gemini-cli
  2. Hoặc cài toàn cục để gọi bằng lệnh gemini ở mọi nơi.

    Terminal
    npm install -g @google/gemini-cli
  3. Muố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).

    Terminal
    npm install -g @google/gemini-cli@latest

Cài trên macOS / Linux

  1. Cài bằng Homebrew.

    Terminal
    brew install gemini-cli
  2. Trên macOS cũng có MacPorts.

    Terminal
    sudo port install gemini-cli
  3. Trong 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

  1. 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).

    Terminal
    export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
    gemini
  2. Nế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).

    Terminal
    export GEMINI_API_KEY="YOUR_API_KEY"
    gemini
  3. Trong thư mục dự án, hỏi một câu chỉ đọc để làm quen.

    Terminal
    gemini -p "Explain the architecture of this codebase"
  4. 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.

Terminal
git clone https://github.com/google-gemini/gemini-cli.git

Repo tương tự nên xem

AI hỗ trợ lập trình156K

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

VừaWindowsmacOSLinux
AI hỗ trợ lập trình135K

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

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình227K

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

VừaWindowsmacOSLinuxNode.js

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: AI hỗ trợ lập trình

AI hỗ trợ lập trình325K

Matt Pocock Skills

mattpocock / skills

Bộ skill nhỏ gọn giúp trợ lý AI viết code hỏi kỹ yêu cầu, viết test trước và giữ code gọn gàng

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình318K

Superpowers

obra / superpowers

Bộ kỹ năng biến trợ lý AI thành người làm phần mềm bài bản: hỏi ý, lập kế hoạch, viết test, rồi mới code

VừaWindowsmacOSLinux
AI hỗ trợ lập trình304K

ECC (Everything Claude Code)

affaan-m / ECC

Kho agent, skill, hook và quy tắc dựng sẵn để trợ lý AI lập trình làm việc có quy trình và có kiểm tra

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình233K

Karpathy-Inspired Claude Code Guidelines

multica-ai / andrej-karpathy-skills

Một file CLAUDE.md gồm bốn nguyên tắc giúp Claude Code bớt đoán mò, bớt làm phức tạp và sửa đúng chỗ cần sửa

DễWindowsmacOSLinux
AI hỗ trợ lập trình195K

Anthropic Agent Skills

anthropics / skills

Kho skill mẫu chính thức của Anthropic: dạy Claude làm Word, Excel, PDF, PowerPoint và việc chuyên biệt

DễWindowsmacOSLinuxWeb+1
AI hỗ trợ lập trình150K

Spec Kit

github / spec-kit

Bộ công cụ của GitHub giúp trợ lý AI code theo đặc tả: viết spec rõ ràng, lập kế hoạch, chia việc rồi mới làm

KhóWindowsmacOSLinuxPython

Xem cả 30 repo AI hỗ trợ lập trình Về Kho Repo