Sử dụng Gemini CLI với CometAPI

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ả dụng của model 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-`)

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 khóa CometAPI thực tế của bạn.

Khởi động Gemini CLI

cd your-project
gemini

Ở lần khởi chạy đầu tiên, bạn sẽ được nhắc chọn một 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 ở 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.

Lỗi Invalid API Key

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 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 Gemini CLI

Chạy npm uninstall -g @google/gemini-cli.