# Grok Build

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

Language: vi

> Kết nối aicentos trong Grok Build —— tự định nghĩa model provider qua config.toml

Grok Build là terminal coding Agent của xAI, mặc định gọi giao diện chính thức của xAI, nhưng nó hỗ trợ khai báo endpoint OpenAI tương thích bất kỳ dạng `[model.*]` trong `~/.grok/config.toml`. Trỏ endpoint về aicentos, là có thể dùng cùng một Key gọi các mô hình dòng grok và các mô hình của nhà cung cấp khác.

## Chuẩn bị

* Cài Grok Build (script chính thức):

  ```bash
  curl -fsSL https://x.ai/cli/install.sh | bash
  ```

* Tạo một Key chuyên dụng trong Console của aicentos (khuyến nghị đặt tên `grok-build`).

## Cấu hình cần điền

| Trường          | Giá trị                                                                        |
| --------------- | ------------------------------------------------------------------------------ |
| base\_url       | `https://aicentos.com/v1`                                                      |
| api\_backend    | `chat_completions` (giá trị mặc định)                                          |
| env\_key        | `AICENTOS_API_KEY`                                                             |
| model           | model ID trong "Model Square" của Console, ví dụ `grok-4.7`, `claude-opus-4-8` |
| context\_window | điền theo mô hình đã chọn, ví dụ `200000`                                      |

## Các bước thiết lập

* Ghi Key vào biến môi trường shell (ghi vào `~/.zshrc` hoặc `~/.bashrc` rồi `source` để có hiệu lực):

  ```bash
  export AICENTOS_API_KEY="your_api_key_here"
  ```

* Sửa `~/.grok/config.toml`, thêm một mô hình tùy chỉnh:

  ```toml
  [models]
  default = "aicentos-grok"

  [model.aicentos-grok]
  base_url          = "https://aicentos.com/v1"
  env_key           = "AICENTOS_API_KEY"
  api_backend       = "chat_completions"
  context_window    = 200000
  max_completion_tokens = 8192
  description       = "aicentos gateway - grok-4.7"
  ```

  `<name>` trong `[model.<name>]` chính là model ID; nếu muốn kết nối nhiều mô hình, ví dụ `grok-4.7` và `claude-opus-4-8`, thì lần lượt viết thêm một đoạn `[model.grok-4.7]`, `[model.claude-opus-4-8]`.

* Khởi động Grok Build, dùng bộ chọn mô hình hoặc lệnh để chuyển:

  ```bash
  grok
  /model aicentos-grok
  ```

## Kiểm tra

Trước tiên liệt kê xem mô hình có được nhận diện không:

```bash
grok models
```

Rồi gửi một câu prompt nhẹ (ví dụ `grok -p "giới thiệu thư mục hiện tại trong một câu" -m aicentos-grok`) xác nhận có thể trả về bình thường.

## Lưu ý

* Grok Build **không có tham số dòng lệnh `--base-url`**, endpoint tùy chỉnh chỉ có thể chỉ định qua file cấu hình hoặc biến môi trường.
* `api_backend` mặc định đã là `chat_completions`; nếu ghi rõ thành `responses` hoặc `messages`, cần xác nhận gateway hỗ trợ endpoint tương ứng, nếu không sẽ thất bại.
* Thứ tự phân giải thông tin xác thực: `api_key` trong cấu hình mô hình → biến môi trường do `env_key` chỉ định → token phiên đã đăng nhập → `XAI_API_KEY` toàn cục. Ở đây dùng `env_key` tham chiếu tên biến của bạn là được, sẽ không lẫn sang tài khoản chính thức của xAI.
* Nếu mô hình thêm mới bỏ qua `context_window`, Grok Build mặc định xử lý theo 200,000; khuyến nghị điền rõ theo mô hình đã chọn.
* Sau khi nối endpoint tùy chỉnh sẽ không còn phụ thuộc gói đăng ký xAI, nhưng mô hình được chọn vẫn do phía aicentos tính phí, trước tiên vào [trang Ví](https://aicentos.com/wallet) xác nhận số dư.