Gemini CLI - CometAPI Documentation

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:

Tính khả dụng của model có thể thay đổi theo thời gian. Hãy kiểm tra trang Models của CometAPI để xem các model Gemini hiện có.

Đ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
Khóa CometAPI	Từ CometAPI Dashboard của bạn (bắt đầu bằng `sk-`)

Install Gemini CLI

npm install -g @google/gemini-cli

Hoặc qua Homebrew (macOS / Linux):

brew install gemini-cli

Xác minh:

gemini --version

Set environment variables

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

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

Start Gemini CLI

cd your-project
gemini

Ở lần khởi chạy đầu tiên, bạn sẽ được nhắc chọn giao diện, 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 trong 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 chính xác. 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 trên 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`