Gemini CLI

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:

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-`)

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

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.

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.

Để 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.

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`