logo

Hướng dẫn cấu hình Gemini CLI

Các bước cài đặt

1. Cài đặt Node.js

Truy cập trang chủ Node.js, khuyến nghị tải phiên bản LTS bên trái, đây là phiên bản hỗ trợ dài hạn, ổn định hơn.

2. Cài đặt Git

Truy cập trang chủ Git, trang sẽ tự động đề xuất phiên bản phù hợp với hệ điều hành của bạn, nhấn nút để tải về.

3. Cài đặt Gemini CLI

Mở cmd command line, cài đặt gemini-cli qua npm：

npm install -g @google/gemini-cli

Các bước cấu hình

Cấu hình (.env)

Tạo tệp cấu hình (Windows: %USERPROFILE%\.gemini\.env, Mac/Linux: ~/.gemini/.env)

GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=<LLMOXY_API_KEY>
GEMINI_MODEL=gemini-2.5-pro

Lưu ý: API Key hãy dùng token nhóm Gemini/Vertex.

Khởi động

gemini

Các bước cấu hình chi tiết

1. Cài đặt Gemini CLI

Mở PowerShell, chạy：

npm install -g @google/generative-ai-cli

Kiểm tra cài đặt：

gemini --version

Nếu báo không tìm thấy lệnh gemini, thử tên gói thay thế：

npm install -g @google/gemini-cli

Mở terminal（nhấn Command + Space, nhập Terminal, nhấn Enter），chạy：

npm install -g @google/generative-ai-cli

Kiểm tra cài đặt：

gemini --version

Nếu báo không tìm thấy lệnh gemini, thử tên gói thay thế：

npm install -g @google/gemini-cli

Mở terminal, chạy：

npm install -g @google/generative-ai-cli

Kiểm tra cài đặt：

gemini --version

Nếu báo không tìm thấy lệnh gemini, thử tên gói thay thế：

npm install -g @google/gemini-cli

2. Cấu hình Gemini CLI（kết nối LLMoxy）

Gemini CLI sử dụng thư mục cấu hình riêng, không cần chỉnh tệp cấu hình Shell.

Tạo thư mục cấu hình

mkdir -Force "$env:USERPROFILE\.gemini"

Ghi tệp cấu hình biến môi trường

Tạo tệp .env（vui lòng thay API Key）：

@"
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=LLMoxy API Key của bạn
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"

Tùy chọn: ghi cấu hình xác thực

@"
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\settings.json"

Thư mục cấu hình nằm ở %USERPROFILE%\.gemini\（thường là C:\Users\tên-người-dùng\.gemini\）。

Tạo thư mục cấu hình

mkdir -p ~/.gemini

Ghi tệp cấu hình biến môi trường

Tạo tệp .env（vui lòng thay API Key）：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=LLMoxy API Key của bạn
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

Tùy chọn: ghi cấu hình xác thực

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

Thư mục cấu hình nằm ở ~/.gemini/（tức /Users/tên-người-dùng/.gemini/）。

Tạo thư mục cấu hình

mkdir -p ~/.gemini

Ghi tệp cấu hình biến môi trường

Tạo tệp .env（vui lòng thay API Key）：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=LLMoxy API Key của bạn
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

Tùy chọn: ghi cấu hình xác thực

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

Bạn phải thay LLMoxy API Key của bạn bằng Key thật sao chép từ bảng điều khiển LLMoxy.

Giải thích các mục cấu hình：

  • GOOGLE_GEMINI_BASE_URL — địa chỉ cổng LLMoxy
  • GEMINI_API_KEY — API Key của bạn
  • GEMINI_MODEL — mô hình mặc định（gemini-3.1-flash-image-preview-1 là flagship mới nhất）

Câu hỏi thường gặp

npm install -g báo lỗi quyền

Chạy PowerShell với quyền quản trị viên, rồi thử lại.

Cài lại Node.js qua Homebrew, bản Homebrew không cần sudo.

Dùng nvm quản lý Node.js（khuyến nghị），hoặc đổi thư mục npm toàn cục： npm config set prefix ~/.npm-global, rồi thêm ~/.npm-global/bin vào PATH.

Báo "gemini command not found"

  • Thử gói thay thế： npm install -g @google/gemini-cli
  • Xác nhận Node.js đã cài： node -v
  • Khởi động lại terminal

Lỗi gọi API

  • Kiểm tra nội dung tệp cấu hình có đúng không
  • Xác nhận API Key không có khoảng trắng thừa
  • Vào bảng điều khiển LLMoxy kiểm tra số dư tài khoản

Vấn đề kết nối máy chủ từ xa (Linux)

  • Kiểm tra mạng： curl -I https://llmoxy.com
  • Nếu cần proxy, thêm vào .env： HTTPS_PROXY=http://your-proxy:port
Hướng dẫn CC Switch
Hướng dẫn cấu hình CodeX CLI