Gemini CLI là gì? Cách cài đặt và dùng AI agent Gemini trong Terminal

Tóm tắt nhanh:

• Gemini CLI là AI agent mã nguồn mở của Google Gemini, chạy trực tiếp trong Terminal.
• Công cụ phù hợp khi bạn muốn hỏi đáp codebase, phân tích file, chạy workflow dev, xử lý log hoặc tự động hóa tác vụ kỹ thuật.
• Cách thử nhanh chính thức là npx @google/gemini-cli; nếu dùng lâu dài có thể cài bằng npm install -g @google/gemini-cli hoặc brew install gemini-cli.
• Gemini CLI cần Node.js 20.0.0+ theo tài liệu cài đặt chính thức.
• Với lệnh có thể sửa file/chạy shell, bạn nên dùng repo test, Git và sandbox để giảm rủi ro.

Gemini CLI là gì?

Gemini CLI là một AI agent mã nguồn mở đưa sức mạnh của Gemini vào thẳng Terminal. Thay vì mở trình duyệt, copy log rồi dán qua chatbot, bạn có thể làm việc ngay trong thư mục dự án: hỏi kiến trúc codebase, tóm tắt file, xử lý log, viết lệnh hỗ trợ dev hoặc chạy workflow tự động.

Theo README chính thức, Gemini CLI có các khả năng như Google Search grounding, thao tác file, chạy shell command, web fetching và hỗ trợ MCP (Model Context Protocol) để mở rộng thêm công cụ. Dự án được phát hành theo giấy phép Apache 2.0.

Khi nào nên dùng Gemini CLI?

Bạn nên cân nhắc Gemini CLI nếu:

• Bạn thường làm việc trong Terminal và muốn hỏi AI ngay tại project.
• Bạn cần đọc/tóm tắt codebase, README, log hoặc tài liệu kỹ thuật.
• Bạn muốn chạy câu hỏi một lần trong script bằng chế độ non-interactive.
• Bạn muốn thử workflow AI agent có thể dùng file, shell command và web fetch.
• Bạn đang tìm một lựa chọn mã nguồn mở, có tài liệu cài đặt và authentication rõ ràng.

Không nên dùng Gemini CLI một cách “thả ga” trên thư mục quan trọng nếu bạn chưa hiểu quyền của tool, sandbox và phạm vi file mà agent có thể thao tác.

Cần chuẩn bị gì trước khi cài?

Theo tài liệu cài đặt chính thức, bạn nên chuẩn bị:

• Node.js 20.0.0+.
• Terminal dùng Bash, Zsh hoặc PowerShell.
• RAM tối thiểu nên có 4GB+ cho nhu cầu nhẹ; 16GB+ nếu làm việc với codebase lớn hoặc phiên dài.
• Một phương thức xác thực: đăng nhập Google, Gemini API key, hoặc Vertex AI tùy trường hợp.
• Một thư mục test hoặc Git repo có thể rollback trước khi cho AI sửa file/chạy lệnh.

Nếu bạn dùng tài khoản Google cá nhân, tài liệu chính thức khuyến nghị bắt đầu bằng cách chạy Gemini CLI rồi chọn đăng nhập Google. Với tài khoản công ty/trường học/Google Workspace hoặc một số license tổ chức, bạn có thể cần cấu hình Google Cloud Project.

Cách cài đặt hoặc chạy thử Gemini CLI

Chạy nhanh bằng npx

Nếu bạn chỉ muốn thử nhanh, README chính thức đưa ra lệnh:

npx @google/gemini-cli

Cách này không cần cài cố định global package, phù hợp để thử giao diện và luồng đăng nhập ban đầu.

Cài global bằng npm

Nếu bạn dùng thường xuyên, có thể cài global bằng npm:

npm install -g @google/gemini-cli

Sau khi cài, bạn có thể chạy:

gemini

Cài bằng Homebrew trên macOS/Linux

Tài liệu chính thức cũng liệt kê Homebrew:

brew install gemini-cli

Cài bằng MacPorts trên macOS

sudo port install gemini-cli

Môi trường hạn chế dùng Anaconda

Trong môi trường bị giới hạn, tài liệu chính thức gợi ý tạo môi trường conda có Node.js rồi cài Gemini CLI qua npm:

conda create -y -n gemini_env -c conda-forge nodejs conda activate gemini_env npm install -g @google/gemini-cli

Cách xác thực Gemini CLI

Gemini CLI có nhiều cách xác thực. Với người dùng cá nhân, đường dễ nhất thường là:

1. Chạy gemini hoặc npx @google/gemini-cli. 2. Chọn đăng nhập bằng Google khi CLI hỏi. 3. Hoàn tất luồng xác thực trong trình duyệt.

Nếu bạn muốn dùng Gemini API key từ Google AI Studio, tài liệu chính thức hướng dẫn đặt biến môi trường. Trên macOS/Linux:

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY" gemini

Lưu ý: đừng paste API key vào bài viết, Git repo, screenshot công khai hoặc log chia sẻ cho người khác.

Nếu tài khoản của bạn cần Google Cloud Project, tài liệu xác thực có ví dụ thêm biến vào ~/.gemini/.env:

GOOGLE_CLOUD_PROJECT="your-project-id"

Cách sử dụng cơ bản

Mở chế độ tương tác

gemini

Chế độ này phù hợp khi bạn muốn trò chuyện nhiều lượt, hỏi về project hiện tại hoặc để Gemini CLI đề xuất bước tiếp theo.

Hỏi một câu và thoát

Tài liệu CLI reference liệt kê cú pháp non-interactive:

gemini -p "Explain the architecture of this codebase"

Bạn có thể đổi prompt theo nhu cầu, ví dụ:

gemini -p "Summarize this project and list the main entry points"

Xử lý nội dung pipe từ file/log

CLI reference có pattern pipe nội dung vào Gemini:

cat logs.txt | gemini

Cách này hữu ích khi bạn muốn tóm tắt log, tìm lỗi hoặc nhờ giải thích output dài. Với log có secret/token, hãy lọc hoặc che dữ liệu nhạy cảm trước.

Xuất JSON cho automation

README chính thức có ví dụ output JSON:

gemini -p "Explain the architecture of this codebase" --output-format json

Với tác vụ dài cần theo dõi sự kiện theo thời gian thực, README cũng có ví dụ stream JSON:

gemini -p "Run tests and deploy" --output-format stream-json

Mình khuyên bạn chỉ dùng automation cho tác vụ an toàn, có Git clean state và có bước review kết quả trước khi áp dụng thay đổi quan trọng.

Ví dụ workflow an toàn cho project code

Một workflow thực tế, bền và ít rủi ro:

1. Tạo branch mới trước khi cho AI đụng vào code. 2. Chạy Gemini CLI trong thư mục project. 3. Hỏi phân tích trước, chưa yêu cầu sửa file ngay:

gemini -p "Explain the architecture of this codebase and identify the safest files to inspect first"

4. Nếu cần sửa, yêu cầu Gemini giải thích kế hoạch trước. 5. Sau khi có thay đổi, tự chạy test/lint của project. 6. Review diff bằng Git trước khi commit.

Ví dụ kiểm tra trạng thái Git:

git status git diff

Các lệnh Git này không phải lệnh riêng của Gemini CLI, nhưng là thói quen bắt buộc khi dùng AI agent có khả năng sửa file.

Cách bật sandbox để giảm rủi ro

Tài liệu sandbox của Gemini CLI nói sandboxing giúp cô lập thao tác nguy hiểm như shell command hoặc sửa file khỏi host system. Bạn có thể bật bằng flag:

gemini --sandbox -y -p "your prompt here"

Hoặc dùng biến môi trường:

export GEMINI_SANDBOX=docker gemini -p "build the project"

Các lựa chọn sandbox được tài liệu liệt kê gồm true, docker, podman, sandbox-exec, runsc, lxc. Tùy hệ điều hành và môi trường, lựa chọn phù hợp sẽ khác nhau.

Quan trọng: sandbox giảm rủi ro nhưng không loại bỏ hoàn toàn rủi ro. Bạn vẫn nên chạy trong project test, có Git, không để secret lung tung trong thư mục làm việc, và không auto-approve lệnh bạn chưa hiểu.

Cách kiểm tra đã hoạt động

Sau khi cài và xác thực, bạn có thể kiểm tra theo các bước an toàn:

gemini -p "Say hello and explain what folder you are currently in"

Nếu CLI trả lời được và không báo lỗi xác thực, phần cài đặt cơ bản đã ổn.

Nếu muốn kiểm tra chế độ xử lý file/log, tạo một file test không có dữ liệu nhạy cảm rồi pipe vào:

printf "error: demo log line" > demo-log.txt cat demo-log.txt | gemini

Không dùng log thật có token, cookie, private key, access key hoặc thông tin khách hàng nếu bạn chưa có quy trình xử lý dữ liệu rõ ràng.

Một vài lỗi thường gặp

Lỗi Node.js quá cũ

Tài liệu cài đặt yêu cầu Node.js 20.0.0+. Nếu lệnh cài hoặc chạy CLI lỗi vì runtime, hãy kiểm tra phiên bản Node.js và nâng cấp trước.

node --version

Không đăng nhập được bằng tài khoản công ty hoặc Workspace

Tài liệu xác thực nêu rằng tài khoản công ty/trường học/Google Workspace có thể cần Google Cloud Project. Nếu gặp lỗi auth, hãy kiểm tra phần cấu hình project trong tài liệu chính thức và quyền của tài khoản.

API key không nhận

Nếu dùng API key, hãy kiểm tra biến môi trường GEMINI_API_KEY đã được đặt trong đúng shell session. Đừng lưu API key vào file public.

Sandbox thiếu quyền hoặc thiếu command

Tài liệu sandbox ghi nhận các lỗi như “Operation not permitted”, thiếu command trong container hoặc network issue. Hướng xử lý là kiểm tra sandbox profile, mount cần thiết, proxy/network hoặc custom image nếu project cần dependency riêng.

Agent muốn chạy lệnh bạn không hiểu

Dừng lại và đọc lệnh. Với lệnh có thể xóa file, ghi đè dữ liệu, gửi network request, deploy hoặc thay đổi cấu hình hệ thống, bạn nên từ chối hoặc yêu cầu giải thích trước.

Lưu ý an toàn và pháp lý

• Không đưa API key, token, cookie, private key, dữ liệu khách hàng hoặc file nhạy cảm vào prompt nếu bạn chưa có quyền và chính sách phù hợp.
• Không yêu cầu Gemini CLI bypass license, phá DRM, lấy dữ liệu trái phép hoặc truy cập hệ thống không thuộc quyền của bạn.
• Luôn review diff trước khi commit.
• Ưu tiên sandbox và thư mục test khi thử command có side effect.
• Với môi trường công ty, hãy kiểm tra chính sách AI, dữ liệu và Google Cloud trước khi triển khai.

FAQ

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

README chính thức nhắc đến free tier với tài khoản Google cá nhân: 60 requests/min và 1.000 requests/day. Tuy nhiên quota, điều khoản và billing có thể thay đổi theo tài khoản, khu vực, license hoặc Google Cloud setup, nên bạn nên kiểm tra tài liệu quota chính thức trước khi dùng lâu dài.

Gemini CLI có phải mã nguồn mở không?

Có. Repository chính thức công bố giấy phép Apache 2.0.

Có cần cài Node.js không?

Có, tài liệu cài đặt chính thức yêu cầu Node.js 20.0.0+.

Có thể dùng Gemini CLI trong script không?

Có. README và CLI reference có ví dụ gemini -p "query", --output-format json và --output-format stream-json cho workflow non-interactive/automation.

Có nên cho Gemini CLI tự sửa file production không?

Không nên làm trực tiếp. Hãy dùng branch riêng, Git clean state, sandbox nếu phù hợp, chạy test và review diff trước khi merge.