Gemini CLI

Thiết lập Gemini CLI với CometAPI: cài đặt qua npm hoặc Homebrew, cấu hình GEMINI_API_KEY và GOOGLE_GEMINI_BASE_URL, rồi bắt đầu sử dụng các model Gemini trong terminal.

Sử dụng hướng dẫn này để chạy Gemini CLI với CometAPI làm API endpoint.

Tài liệu tham khảo chính thức:

• Gemini CLI GitHub
• Gemini CLI Authentication

Khả năng hỗ trợ model thay đổi theo thời gian. Hãy kiểm tra trang Models của CometAPI để xem các model Gemini hiện đang khả dụng.

​

Điều kiện tiên quyết

Yêu cầu	Chi tiết
Node.js	22+ (khuyến nghị LTS)
OS	macOS, Linux hoặc Windows
CometAPI key	Từ CometAPI Dashboard của bạn (bắt đầu bằng sk-)

​

Thiết lập

1. Cài đặt Gemini CLI

   npm install -g @google/gemini-cli
   

   Hoặc qua Homebrew (macOS / Linux):

   brew install gemini-cli
   

   Xác minh:

   gemini --version
   
2. Thiết lập biến môi trường

   export GEMINI_API_KEY="sk-your-cometapi-key"
   export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
   

   Thay sk-your-cometapi-key bằng CometAPI key thực tế của bạn.

3. Khởi động Gemini CLI

   cd your-project
   gemini
   

   Khi khởi chạy lần đầu, bạn sẽ được nhắc chọn theme, xác nhận thông báo an toàn và tin cậy thư mục làm việc.

​

Lưu biến môi trường

Để tránh phải export lại ở mỗi phiên, hãy thêm vào cấu hình shell của bạn:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

Khởi động lại terminal để các thay đổi có hiệu lực.

​

Khắc phục sự cố

Triệu chứng	Cách khắc phục
Invalid API Key error	Xác minh GEMINI_API_KEY đã được thiết lập đúng. Chạy echo $GEMINI_API_KEY để kiểm tra
fetch failed	Các hạn chế mạng có thể chặn kết nối. Hãy thử proxy toàn hệ thống
Sai phiên bản Node.js	Gemini CLI yêu cầu Node.js 22+. Chạy node --version để kiểm tra
Gỡ cài đặt	npm uninstall -g @google/gemini-cli