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

Gemini CLI là tác nhân terminal của Google. Cấu hình được ghi trong ~/.gemini/, không cần sửa biến môi trường của Shell.

Trước khi bắt đầu, hãy chuẩn bị một mã thông báo LLMoxy. Nên dùng mã thông báo nhóm auto.

Cài đặt

npm install -g @google/gemini-cli
gemini --version
BASH

Kết nối LLMoxy

Tạo thư mục cấu hình và ghi .env:

# macOS / Linux
mkdir -p ~/.gemini
cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=API Key LLMoxy của bạn
GEMINI_MODEL=gemini-4-argon
EOF
BASH
# Windows PowerShell
mkdir -Force "$env:USERPROFILE\.gemini"
@"
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=API Key LLMoxy của bạn
GEMINI_MODEL=gemini-4-argon
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"
POWERSHELL

Tùy chọn, chỉ định đăng nhập bằng API Key:

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
JSON

Lưu nội dung trên thành ~/.gemini/settings.json (trên Windows là %USERPROFILE%\.gemini\settings.json).

TIP Địa chỉ của Gemini CLI không có /v1. Hãy thay API Key LLMoxy của bạn bằng mã thông báo thật trong bảng điều khiển.

Khởi động

gemini
BASH

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

gemini: command not found Xác nhận node -v hoạt động bình thường, rồi mở lại terminal. Tên gói là @google/gemini-cli.

Gọi thất bại Kiểm tra .env không có khoảng trắng thừa, nhóm mã thông báo là auto, tài khoản còn số dư.

Linux không kết nối được Dùng curl -I https://llmoxy.com; khi cần proxy, thêm HTTPS_PROXY=http://your-proxy:port vào .env.