# Gemini CLI

Nguồn: https://docs.aicentos.com/vi/clients/gemini-cli

Language: vi

> Dùng aicentos trong Gemini CLI —— cấu hình gateway tùy chỉnh qua biến môi trường

Gemini CLI là công cụ dòng lệnh do Google chính thức phát hành, hỗ trợ cấu hình gateway tùy chỉnh qua biến môi trường để kết nối dịch vụ Codex Proxy, cho phép trò chuyện tương tác với các mô hình Gemini ngay trong terminal.

## Chuẩn bị

Gemini CLI cài toàn cục qua npm, cần chuẩn bị sẵn môi trường Node.js 18+ và npm trước.

### Cài Node.js

* Truy cập trang tải chính thức của Node.js: [https://nodejs.org/en/download](https://nodejs.org/en/download)
* macOS/Windows: tải và cài bản LTS
* Linux: cài theo cách của bản phân phối được hướng dẫn trên trang
* macOS (người dùng Homebrew): chạy `brew install node`

### Kiểm tra cài đặt

```bash
node -v
npm -v
```

## Cài đặt Gemini CLI

Cài toàn cục Gemini CLI bằng npm:

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

Xác minh cài đặt:

```bash
gemini --version
```

## Cấu hình biến môi trường

Gemini CLI hỗ trợ kết nối gateway tùy chỉnh qua ba biến môi trường sau:

| Biến môi trường          | Mô tả                                                              |
| ------------------------ | ------------------------------------------------------------------ |
| `GOOGLE_GEMINI_BASE_URL` | Địa chỉ gốc dịch vụ gateway, thay thế endpoint mặc định của Google |
| `GEMINI_API_KEY`         | API Key của bạn                                                    |
| `GEMINI_MODEL`           | Mô hình dùng mặc định                                              |

### Ví dụ cấu hình

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"
```

### Lưu ý

* `GOOGLE_GEMINI_BASE_URL` điền địa chỉ gốc dịch vụ, không cần kèm đường dẫn API cụ thể
* Thử tạm thời: chạy trực tiếp các lệnh export trên trong phiên shell hiện tại
* Hiệu lực vĩnh viễn: thêm các câu export vào `~/.zshrc` hoặc `~/.bashrc`, rồi chạy `source ~/.zshrc` để có hiệu lực

## Khởi động Gemini CLI

Sau khi cấu hình xong, chạy trực tiếp lệnh sau để khởi động:

```bash
gemini
```

Sau khi khởi động là có thể trò chuyện tương tác với các mô hình Gemini ngay trong terminal.

## Xác minh kết nối

Mở một hội thoại trong Gemini CLI, nếu nhận được phản hồi bình thường nghĩa là kết nối thành công.

### Xử lý sự cố thường gặp

* Nếu gặp lỗi xác thực, hãy xác nhận `GEMINI_API_KEY` có đúng không
* Kiểm tra `GOOGLE_GEMINI_BASE_URL` có trỏ đúng địa chỉ dịch vụ không

## Lưu ý

* Dịch vụ hiện tại đã hỗ trợ giao diện tương thích Gemini, có thể dùng trực tiếp cho Gemini CLI
* Cấu hình biến môi trường nên thêm vào file cấu hình shell để có hiệu lực vĩnh viễn
* Gemini CLI tự nối đường dẫn API, không cần thêm đường dẫn API cụ thể vào BASE\_URL

## Liên kết liên quan

* Tài liệu chính thức: [https://docs.aicentos.com/clients/gemini-cli.html](https://docs.aicentos.com/clients/gemini-cli.html)