Bỏ qua tới nội dung
Ông T.vn

Gemini CLI: trợ lý AI Gemini ngay trong terminal — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật
Gemini CLI: trợ lý AI Gemini ngay trong terminal — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Gemini CLI là công cụ dòng lệnh mã nguồn mở của Google, đưa AI Gemini vào terminal để hỏi đáp về code, sửa code và chạy tự động hoá. Cài bằng một lệnh npm, cần Node 20 trở lên. Điểm cần biết trước: README nói repo này nay dành cho Gemini Code Assist Standard/Enterprise, tài khoản miễn phí đã chuyển sang Antigravity CLI.

Gemini CLI là một AI agent mã nguồn mở của Google, chạy ngay trong cửa sổ terminal. Bạn gõ lệnh gemini, rồi trò chuyện bằng ngôn ngữ thường: nhờ nó giải thích một dự án, tìm lỗi, viết thêm code hay chạy giúp một số việc lặp đi lặp lại. Repo viết bằng TypeScript, giấy phép Apache-2.0, hiện có khoảng 108.807 sao và 14.941 fork trên GitHub.

Ai nên đọc bài này? Lập trình viên mới muốn có một "người phụ" ngay trong dòng lệnh. Người làm văn phòng hoặc kinh doanh có người trong nhóm kỹ thuật và muốn hiểu công cụ này làm được gì. Đặc biệt là các tổ chức đang dùng Google Cloud.

Có một điều mình muốn nói thẳng ngay từ đầu, vì nó quyết định bạn có dùng được hay không. README hiện ghi rõ: repo này dành cho tổ chức có giấy phép Gemini Code Assist Standard / Enterprise hoặc Code Assist for GitHub trên Google Cloud (kèm các khoá API trả phí / Vertex kiểu cũ). Truy cập miễn phí cho cá nhân và gói Google AI Pro / Ultra đã chuyển sang một công cụ khác tên là Antigravity CLI. Nếu bạn là cá nhân dùng tài khoản miễn phí, hãy đọc kỹ phần "Cần chuẩn bị gì" và "Có nên dùng không" trước khi cài.

CLI

google-gemini/gemini-cli

Gemini CLI là AI agent mã nguồn mở chạy trong terminal, giúp đọc, sửa code và tự động hoá việc bằng Gemini. Nay nhắm tới khách hàng Code Assist doanh nghiệp.

★ 109kTypeScriptApache-2.0
Xem repo trên GitHub

I.Gemini CLI làm được gì

Dưới đây là các khả năng chính theo README, kèm lợi ích thực tế.

  • Hỏi và sửa trên cả dự án lớn. Bạn không phải copy từng đoạn code vào khung chat. Mở terminal trong thư mục dự án, chạy gemini, rồi hỏi "dự án này cấu trúc thế nào". Công cụ đọc file giúp bạn.
  • Sinh ứng dụng từ PDF, ảnh hoặc bản phác thảo. Nhờ khả năng đa phương thức, bạn có thể đưa một tài liệu hay hình vẽ tay làm đầu vào. Hợp với người có ý tưởng nhưng chưa biết bắt đầu viết từ đâu.
  • Gỡ lỗi bằng ngôn ngữ tự nhiên. Thay vì đọc log dài, bạn mô tả triệu chứng và nhờ nó lần ra nguyên nhân.
  • Tự động hoá việc vận hành. README nêu ví dụ như truy vấn pull request hoặc xử lý các thao tác rebase phức tạp.
  • Nối thêm công cụ qua MCP. MCP là chuẩn để gắn thêm "tay chân" cho AI, ví dụ GitHub, Slack, cơ sở dữ liệu, hoặc tạo ảnh/video/nhạc. Bạn khai báo trong file ~/.gemini/settings.json.
  • Chạy không cần ngồi trước màn hình. Chế độ không tương tác (cờ -p) cho phép đưa Gemini CLI vào script, và có thể xuất kết quả dạng JSON để chương trình khác đọc.
  • Ghi nhớ bối cảnh bằng file GEMINI.md, lưu và tiếp tục hội thoại (checkpointing), tự tạo lệnh riêng (custom commands), và có chế độ sandbox cùng "thư mục tin cậy" để hạn chế rủi ro khi chạy lệnh.

II.Cần chuẩn bị gì

Theo tư liệu, bạn cần:

  • Node.js từ phiên bản 20.0.0 trở lên (package.json yêu cầu >=20.0.0).
  • Một terminal. README hướng dẫn cài qua npm, Homebrew (macOS/Linux), MacPorts (macOS) hoặc Anaconda. README không có mục riêng nói về Windows, nên nếu dùng Windows hãy xem trang cài đặt chính thức mà README dẫn tới.
  • Một cách đăng nhập hợp lệ. README liệt kê ba lựa chọn:
    • Đăng nhập bằng tài khoản Google, dùng với giấy phép Code Assist trả phí của tổ chức (cần đặt thêm biến GOOGLE_CLOUD_PROJECT).
    • Khoá Gemini API lấy từ Google AI Studio (có tính phí theo mức dùng).
    • Vertex AI, dành cho đội ngũ doanh nghiệp.
  • Phần cứng: README không nêu yêu cầu cụ thể. Mô hình chạy trên dịch vụ của Google chứ không chạy trên máy bạn, nhưng tư liệu cũng không nói rõ về GPU. Trang cài đặt chính thức có phần "recommended system specifications" nếu bạn cần chi tiết.

Khoá API và tên dự án Google Cloud là thông tin nhạy cảm. Đừng dán vào ảnh chụp màn hình, tin nhắn nhóm hay commit lên GitHub. Dùng API key hoặc Vertex còn phát sinh chi phí theo mức sử dụng, hãy xem bảng giá và đặt giới hạn trước khi cho cả nhóm dùng.

III.Cài đặt từng bước

  1. Kiểm tra NodeĐảm bảo máy có Node.js 20 trở lên
  2. Chọn cách càiChạy thử bằng npx, hoặc cài hẳn bằng npm / Homebrew / MacPorts / Anaconda
  3. Chọn cách đăng nhậpTài khoản Google (Code Assist), khoá Gemini API hoặc Vertex AI
  4. Chạy geminiMở terminal trong thư mục dự án rồi gõ gemini

A.Kiểm tra Node.js

README không có lệnh kiểm tra phiên bản, nhưng package.json yêu cầu Node 20 trở lên. Lệnh dưới đây là lệnh phổ thông của Node, bạn mở terminal và chạy để xem phiên bản đang có:

Terminal
node -v

Nếu ra số nhỏ hơn 20 (ví dụ v18.x), hãy nâng cấp Node trước khi cài tiếp.

B.Chọn một cách cài

Cách 1: chạy thử ngay, không cần cài. Phù hợp để dùng thử vì không đụng gì vào máy:

Terminal
# Using npx (no installation required)
npx @google/gemini-cli

Cách 2: cài toàn cục bằng npm. Cài một lần, sau đó gõ gemini ở bất kỳ đâu:

Terminal
npm install -g @google/gemini-cli

Cách 3: Homebrew (macOS/Linux):

Terminal
brew install gemini-cli

Cách 4: MacPorts (macOS):

Terminal
sudo port install gemini-cli

Cách 5: Anaconda, dành cho môi trường bị hạn chế quyền cài đặt. Lệnh này tạo một môi trường riêng có Node, rồi cài bên trong đó:

Terminal
# Create and activate a new environment
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli

Với người mới, mình gợi ý cách 1 hoặc cách 2. Lưu ý: -g nghĩa là cài toàn cục, nên nếu máy công ty chặn quyền cài, hãy hỏi bộ phận IT hoặc dùng cách Anaconda.

C.Chọn kênh phát hành (không bắt buộc)

Repo có ba kênh. Người mới nên dùng bản ổn định:

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

Bản preview ra hằng tuần nhưng chưa kiểm định kỹ, có thể có lỗi. Bản nightly ra hằng ngày, chứa mọi thay đổi mới nhất và càng dễ lỗi hơn:

Terminal
npm install -g @google/gemini-cli@preview
npm install -g @google/gemini-cli@nightly

D.Chọn cách đăng nhập

Dưới đây là các lệnh README đưa ra. Chúng viết theo kiểu macOS/Linux (export). Nếu dùng PowerShell trên Windows, cú pháp đặt biến khác, ví dụ $env:GEMINI_API_KEY = "...", nhưng README không hướng dẫn riêng cho Windows.

Đăng nhập bằng tài khoản Google với giấy phép Code Assist của tổ chức. Bạn phải đặt dự án Google Cloud trước khi chạy:

Terminal
# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

Thay YOUR_PROJECT_ID bằng mã dự án thật của tổ chức. Hỏi quản trị viên Google Cloud nếu bạn không biết.

Dùng khoá Gemini API. Lấy khoá tại trang Google AI Studio (https://aistudio.google.com/apikey):

Terminal
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

Dùng Vertex AI:

Terminal
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

Với tài khoản Google Workspace và các cách khác, README dẫn tới trang hướng dẫn xác thực chính thức trên geminicli.com.

E.Chạy lần đầu

Mở terminal trong thư mục dự án bạn muốn làm việc (đây là chỗ người mới hay quên, vì Gemini CLI làm việc trên thư mục hiện tại), rồi gõ:

Terminal
gemini

IV.Kiểm tra đã chạy được chưa

README không đưa ra một lệnh kiểm tra riêng. Cách kiểm tra thực tế là chạy gemini: nếu mở ra giao diện hội thoại trong terminal và bạn gửi được một câu hỏi, nhận được câu trả lời, nghĩa là cài và đăng nhập đã ổn. Bạn có thể thử hỏi một câu đơn giản về thư mục hiện tại.

Trong giao diện, gõ /help để xem danh sách các lệnh gạch chéo (README có nhắc /help và /chat). Nếu có lỗi, /bug cho phép báo lỗi thẳng từ công cụ.

Kiểm tra thêm chế độ không tương tác, một lệnh gọn để thử:

Terminal
gemini -p "Explain the architecture of this codebase"

Bạn sẽ nhận một câu trả lời dạng văn bản rồi lệnh tự thoát, không mở giao diện hội thoại.

V.Dùng vào việc thật

Các tình huống dưới đây bám theo ví dụ và khả năng được README nêu. Câu lệnh mẫu mang tính minh hoạ, bạn tự đổi nội dung cho hợp việc của mình.

A.Dev mới tiếp quản một dự án lạ

Bạn vừa được giao một dự án cũ, không ai còn nhớ cấu trúc. Hãy mở terminal tại thư mục dự án và hỏi:

Terminal
gemini -p "Explain the architecture of this codebase"

Nếu muốn gộp thêm thư mục khác (thư viện dùng chung, tài liệu), README có cờ --include-directories và dùng dấu phẩy để ngăn cách:

Terminal
gemini --include-directories ../lib,../docs

Kết quả: bạn có bản tóm tắt kiến trúc trong vài phút, đủ để biết nên đọc file nào trước.

Việc tốn thời gian nhất với người mới là hiểu code của người khác, và đó là chỗ một trợ lý trong terminal có ích nhất.

Ông T

B.Chủ shop muốn có bot trả lời câu hỏi thường gặp

Chủ cửa hàng online có sẵn file FAQ.md (giờ mở cửa, chính sách đổi trả). Với sự hỗ trợ của một bạn lập trình, họ làm theo ví dụ trong README: tạo thư mục mới, chạy gemini và mô tả điều mình muốn:

Terminal
cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

Bạn có thể viết yêu cầu bằng tiếng Việt cũng được, miễn là mô tả rõ. Kết quả là một bộ khung bot do Gemini viết. Hãy đọc kỹ code và thử ở nơi an toàn trước khi cho khách dùng thật.

C.Nhân viên kỹ thuật theo dõi thay đổi hằng ngày

Trưởng nhóm muốn biết hôm qua cả nhóm đã sửa gì. Theo ví dụ trong README, tải dự án về, vào thư mục rồi hỏi:

Terminal
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday

(Ở đây README dùng chính repo gemini-cli làm ví dụ. Bạn thay bằng repo của nhóm mình.) Kết quả là bản tóm tắt các thay đổi, đỡ phải đọc từng commit.

D.Nối GitHub, Slack hoặc cơ sở dữ liệu qua MCP

Bạn muốn ra lệnh kiểu "liệt kê pull request của tôi" mà không phải mở trình duyệt. README cho biết cấu hình MCP server trong file ~/.gemini/settings.json, sau đó dùng các câu như:

text
> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

README không đưa nội dung mẫu của file settings.json, vì vậy hãy xem hướng dẫn tích hợp MCP trên trang tài liệu của dự án (geminicli.com, mục MCP Server Integration) để biết cách khai báo từng server. Với thao tác ghi dữ liệu như gửi Slack hay truy vấn database, hãy kiểm tra kỹ quyền trước khi cho chạy.

Ngoài ra, muốn dùng trong script tự động và đọc kết quả bằng chương trình, README có hai dạng đầu ra có cấu trúc:

Terminal
gemini -p "Explain the architecture of this codebase" --output-format json
gemini -p "Run tests and deploy" --output-format stream-json

Dạng đầu cho một kết quả JSON, dạng sau trả về từng sự kiện theo dòng, tiện theo dõi tác vụ chạy lâu.

VI.Lỗi hay gặp và cách xử lý

Báo lỗi hoặc không chạy vì Node cũ. Gói yêu cầu Node 20 trở lên. Chạy node -v, nếu nhỏ hơn 20 thì nâng cấp Node rồi cài lại.

Gõ gemini báo không tìm thấy lệnh. Rất hay gặp sau khi cài toàn cục: terminal đang mở chưa nhận lệnh mới. Hãy đóng terminal, mở lại rồi thử. Nếu vẫn không được, kiểm tra thư mục cài đặt toàn cục của npm có nằm trong PATH không. Trong lúc chờ, npx @google/gemini-cli vẫn chạy được mà không cần cài.

Lỗi quyền khi npm install -g. Máy công ty thường chặn ghi vào thư mục hệ thống. Đừng vội dùng quyền quản trị để ép cài. Hỏi IT, hoặc dùng cách Anaconda mà README gợi ý cho môi trường bị hạn chế: cài trong môi trường riêng.

Đăng nhập được nhưng không dùng được, hoặc bị từ chối truy cập. Do README nêu rõ repo này hướng tới giấy phép Code Assist Standard/Enterprise, tài khoản cá nhân miễn phí hay gói Google AI Pro/Ultra sẽ không còn thuộc phạm vi này. Hãy kiểm tra bạn đã đặt GOOGLE_CLOUD_PROJECT đúng với giấy phép của tổ chức chưa. Nếu bạn là cá nhân, xem công cụ Antigravity CLI mà README chỉ sang, hoặc dùng khoá API riêng.

Dùng khoá API mà bị tính phí ngoài dự tính. Khoá Gemini API tính phí theo mức dùng. Hãy đặt giới hạn chi tiêu ở phía Google, tránh để script tự động chạy vô hạn, và không chia sẻ khoá. Nếu lỡ lộ khoá, hãy thu hồi và tạo khoá mới.

VII.Có nên dùng không

Điểm mạnh. Mã nguồn mở theo Apache-2.0, cài đơn giản bằng npm, có tài liệu đầy đủ và còn được cập nhật trong ba tháng gần đây. Công cụ có chế độ không tương tác, đầu ra JSON, hỗ trợ MCP, file ngữ cảnh GEMINI.md, sandbox và thư mục tin cậy. Nếu tổ chức bạn đã trả tiền cho Gemini Code Assist trên Google Cloud, đây là lựa chọn hợp lý và chính thức.

Giới hạn. Theo README hiện tại:

  • Repo nhắm tới khách hàng Code Assist Standard / Enterprise. 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ụ không được tối ưu cho dòng Gemini 4 trở đi, và README khuyên không dùng nó để đo điểm benchmark mô hình.
  • Bản preview và nightly có thể có lỗi.

Khi nào chọn cách khác. Nếu bạn là cá nhân dùng tài khoản miễn phí, hoặc dùng gói Google AI Pro / Ultra, hay muốn dùng Gemini 4, README chỉ bạn sang Antigravity CLI (lệnh agy). Nếu bạn chỉ cần một công cụ không lưu trạng thái, gọi trực tiếp API Gemini từ script hoặc CI, README giới thiệu Gemini API CLI (lệnh gemini-api). Còn nếu tổ chức bạn đã có giấy phép Code Assist, Gemini CLI vẫn là lựa chọn đúng chỗ. Bài này không so sánh sâu với các công cụ khác vì tư liệu không có số liệu đối chiếu.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

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

Mã nguồn dùng giấy phép Apache-2.0 nên bạn tải và dùng thoải mái. Nhưng README ghi rõ truy cập miễn phí cho cá nhân đã chuyển sang Antigravity CLI. Repo này nay dành cho giấy phép Gemini Code Assist Standard/Enterprise, hoặc khoá API/Vertex trả phí kiểu cũ.

Gemini CLI cần Node phiên bản nào?

package.json yêu cầu Node từ 20.0.0 trở lên. Bạn có thể cài bằng npm (`npm install -g @google/gemini-cli`), hoặc chạy thử không cần cài bằng `npx @google/gemini-cli`.

Có cần GPU hay máy cấu hình mạnh không?

README không nêu yêu cầu GPU. Công cụ gọi mô hình Gemini qua dịch vụ của Google chứ không thấy nói chạy mô hình trên máy bạn. Về cấu hình khuyến nghị, README dẫn tới trang cài đặt chính thức trên geminicli.com.

Chạy được trên Windows không?

README liệt kê npm, Homebrew, MacPorts và Anaconda, nhưng không có mục riêng về Windows. Các lệnh đặt biến môi trường trong README viết kiểu `export`. Thông tin chi tiết hơn bạn nên xem trang cài đặt chính thức trên geminicli.com.

Đăng nhập bằng cách nào?

README nêu ba cách: đăng nhập tài khoản Google với giấy phép Code Assist của tổ chức (kèm biến GOOGLE_CLOUD_PROJECT), dùng khoá Gemini API (biến GEMINI_API_KEY), hoặc dùng Vertex AI (biến GOOGLE_API_KEY và GOOGLE_GENAI_USE_VERTEXAI). Với Google Workspace và cách khác, README dẫn tới trang hướng dẫn xác thực.

Dữ liệu và code của tôi có an toàn không?

Tư liệu không nêu chi tiết về cách xử lý dữ liệu. README có dẫn tới các trang Terms & Privacy, Sandboxing & Security và Trusted Folders trên trang tài liệu. Bạn nên đọc các trang đó, và không đưa khoá API hay dữ liệu bí mật vào câu lệnh khi chưa rõ chính sách.

Gemini CLI khác gì Antigravity CLI và Gemini API CLI?

Theo README, Antigravity CLI (`agy`) là terminal lập trình đa agent tương tác, dành cho Gemini 4, tài khoản miễn phí và Google AI Pro/Ultra. Gemini API CLI (`gemini-api`) là công cụ API không lưu trạng thái cho script và CI. Gemini CLI (`gemini`, repo này) dành cho tổ chức có Code Assist Standard/Enterprise.

Chuyển nhanh tới mục

  1. I.Gemini CLI làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Node.js
    2. B.Chọn một cách cài
    3. C.Chọn kênh phát hành (không bắt buộc)
    4. D.Chọn cách đăng nhập
    5. E.Chạy lần đầu
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới tiếp quản một dự án lạ
    2. B.Chủ shop muốn có bot trả lời câu hỏi thường gặp
    3. C.Nhân viên kỹ thuật theo dõi thay đổi hằng ngày
    4. D.Nối GitHub, Slack hoặc cơ sở dữ liệu qua MCP
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.