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

> Dùng ~/.gemini/.env để kết nối Gemini CLI với LLMoxy, sử dụng `gemini-4-argon`.

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](https://vi.llmoxy.com/docs/get-started/get-token). Nên dùng mã thông báo nhóm **auto**.

## Cài đặt

```bash
npm install -g @google/gemini-cli
gemini --version
```

## Kết nối LLMoxy

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

```bash
# 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
```

```powershell
# 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"
```

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

```json
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
```

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

```bash
gemini
```

## 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`.

Đây là bản markdown của https://vi.llmoxy.com/docs/code-tutorials/gemini-cli.
