Endpoint: https://api.shopaikey.com
Gemini CLI là công cụ dòng lệnh (CLI) mã nguồn mở của Google, giúp bạn lập trình cặp (pair programming), refactor code, và debug ngay trong terminal với sức mạnh của Gemini models.
0. Cài đặt tự động (Khuyên dùng)
macOS / Linux
curl -fsSL https://cdn.shopaikey.com/gemini-cli/setup.sh | bash
Windows (PowerShell)
irm https://cdn.shopaikey.com/gemini-cli/setup.ps1 | iex
Script tự động cài Gemini CLI (nếu chưa có), backup settings cũ, và cấu hình API key.
1. Yêu cầu & Cài đặt
Yêu cầu hệ thống
- Node.js: Phiên bản 18 trở lên.
- OS: macOS, Linux, hoặc Windows (WSL/PowerShell).
Cài đặt nhanh với npx (không cần cài đặt)
npx @google/gemini-cli
Cài đặt toàn cục với npm
npm install -g @google/gemini-cli
Cài đặt với Homebrew (macOS/Linux)
brew install gemini-cli
Cài đặt với MacPorts (macOS)
sudo port install gemini-cli
Cài đặt với Anaconda (cho môi trường hạn chế)
# Tạo và kích hoạt môi trường mới
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
# Cài Gemini CLI toàn cục qua npm (trong môi trường)
npm install -g @google/gemini-cli
2. Cấu hình (Quan trọng)
Để Gemini CLI trỏ về https://api.shopaikey.com thay vì server mặc định của Google, bạn cần cấu hình Base URL và API Key. Có 2 cách để làm việc này.
Cách 1: Sử dụng file .env (Khuyên dùng)
Cách này giúp cấu hình được lưu vĩnh viễn và dễ quản lý.
Bước 1: Tạo file .env trong thư mục home
- macOS / Linux:
~/.gemini/.env - Windows:
%USERPROFILE%\.gemini\.env
Bước 2: Nhập nội dung cấu hình
GEMINI_API_KEY=sk-your-token-here
GOOGLE_GEMINI_BASE_URL=https://api.shopaikey.com
Cách 2: Sử dụng Biến môi trường (Environment Variables)
Dùng cách này nếu bạn không muốn sửa file config hoặc muốn test nhanh.
Linux / macOS
export GEMINI_API_KEY="sk-your-token-here"
export GOOGLE_GEMINI_BASE_URL="https://api.shopaikey.com"
Windows (PowerShell)
$env:GEMINI_API_KEY = "sk-your-token-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://api.shopaikey.com"
Windows (CMD)
set GEMINI_API_KEY=sk-your-token-here
set GOOGLE_GEMINI_BASE_URL=https://api.shopaikey.com
3. Hướng dẫn Sử dụng
Sau khi cấu hình xong, bạn có thể bắt đầu sử dụng Gemini CLI.
Khởi động chế độ tương tác (Interactive Mode)
Tại thư mục dự án của bạn, gõ:
gemini
Lúc này bạn sẽ vào giao diện chat. Bạn có thể hỏi:
"Giải thích cấu trúc dự án này cho tôi" "Tạo một file test cho hàm login trong src/auth.js"
Chạy lệnh trực tiếp (Single Shot)
Gửi một yêu cầu nhanh mà không cần vào chế độ chat:
gemini "Refactor file utils.js để code gọn hơn"
Chọn model
Gemini CLI hỗ trợ nhiều model khác nhau. Bạn có thể chỉ định model khi khởi động:
gemini --model gemini-3-pro "Giải thích hàm calculateTotal"
Xem danh sách model đầy đủ tại Bảng giá Model.