# Grok CLI

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

Language: vi

> Dùng aicentos trong Grok CLI —— kết nối qua biến môi trường hoặc file cấu hình

Grok CLI là một công cụ dòng lệnh, dùng giao diện tương thích OpenAI, có thể trực tiếp trỏ địa chỉ API tùy chỉnh về làm dịch vụ backend của nó.

## Chuẩn bị

Cần cài trước Node.js 18+ và npm.

Khuyến nghị cài từ 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

Người dùng macOS cũng có thể dùng Homebrew:

```bash
brew install node
```

Sau khi cài xong, xác nhận:

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

## Cài đặt Grok CLI

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

```bash
npm install -g @vibe-kit/grok-cli
```

Sau khi cài xong, kiểm tra:

```bash
grok --version
```

## Cấu hình kết nối

Grok CLI cung cấp ba cách cấu hình, thứ tự ưu tiên: tham số dòng lệnh > biến môi trường > file cấu hình.

### Cách 1: Biến môi trường (khuyến nghị)

Thiết lập các biến môi trường sau:

```bash
export GROK_BASE_URL="https://aicentos.com/v1"
export GROK_API_KEY="your_api_key_here"
```

Thử tạm thời thì chỉ cần chạy export trong shell hiện tại. Muốn hiệu lực vĩnh viễn, thêm các câu lệnh trên vào `~/.zshrc` hoặc `~/.bashrc`, rồi chạy `source ~/.zshrc` để có hiệu lực.

### Cách 2: File cấu hình

Sửa `~/.grok/user-settings.json`:

```json
{
  "apiKey": "your_api_key_here",
  "baseURL": "https://aicentos.com/v1",
  "defaultModel": "gpt-4o"
}
```

### Cách 3: Tham số dòng lệnh

Khi khởi động, chỉ định qua tham số:

```bash
grok --base-url https://aicentos.com/v1
```

## Khởi động và sử dụng

Sau khi cấu hình xong, chạy trực tiếp:

```bash
grok
```

Sau khi khởi động, mở hội thoại trong Grok 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ác minh và xử lý sự cố

Nếu gặp lỗi xác thực, hãy kiểm tra:

* `GROK_API_KEY` có đúng không
* `GROK_BASE_URL` / `baseURL` có trỏ đúng địa chỉ dịch vụ không (cần có hậu tố `/v1`)

Sau khi xác nhận cấu hình không sai, khởi động lại là được.

## Lưu ý

* Grok CLI dùng giao diện tương thích OpenAI, cấu hình đơn giản trực tiếp
* Ba cách cấu hình có thể chọn linh hoạt, khuyến nghị dùng cách biến môi trường
* Địa chỉ API bắt buộc phải chứa hậu tố `/v1`
* Hỗ trợ tùy chỉnh mô hình mặc định

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

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