# Grok Build

Источник: https://docs.aicentos.com/ru/clients/grok-build

Language: ru

> Подключение aicentos в Grok Build — кастомный model provider через config.toml

Grok Build — консольный агент для программирования от xAI. По умолчанию он вызывает официальный интерфейс xAI, но позволяет объявить в `~/.grok/config.toml` произвольные OpenAI-совместимые эндпоинты `[model.*]`. Направьте эндпоинт на aicentos — и одним и тем же ключом можно вызывать модели линейки grok и других вендоров.

## Подготовка

* Установите Grok Build (официальный скрипт):

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

* Создайте в консоли aicentos отдельный ключ (рекомендуемое имя `grok-build`).

## Конфигурация для заполнения

| Поле            | Значение                                                                         |
| --------------- | -------------------------------------------------------------------------------- |
| base\_url       | `https://aicentos.com/v1`                                                        |
| api\_backend    | `chat_completions` (значение по умолчанию)                                       |
| env\_key        | `AICENTOS_API_KEY`                                                               |
| model           | ID модели из «витрины моделей» в консоли, например `grok-4.7`, `claude-opus-4-8` |
| context\_window | по выбранной модели, например `200000`                                           |

## Шаги настройки

* Запишите ключ в переменную окружения shell (добавьте в `~/.zshrc` или `~/.bashrc` и примените через `source`):

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

* Отредактируйте `~/.grok/config.toml`, добавив кастомную модель:

  ```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>` в `[model.<name>]` — это ID модели; чтобы подключить несколько моделей, например `grok-4.7` и `claude-opus-4-8`, допишите отдельные секции `[model.grok-4.7]`, `[model.claude-opus-4-8]`.

* Запустите Grok Build и переключите модель через селектор или команду:

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

## Проверка

Сначала проверьте, распознались ли модели:

```bash
grok models
```

Затем отправьте лёгкий промпт (например, `grok -p "опиши текущий каталог одним предложением" -m aicentos-grok`) и убедитесь, что ответ приходит нормально.

## Примечания

* У Grok Build **нет параметра командной строки `--base-url`**; кастомный эндпоинт задаётся только через файл конфигурации или переменные окружения.
* `api_backend` по умолчанию — `chat_completions`; если явно указать `responses` или `messages`, убедитесь, что шлюз поддерживает соответствующий эндпоинт, иначе запрос завершится ошибкой.
* Порядок разрешения учётных данных: `api_key` из конфигурации модели → переменная окружения из `env_key` → token текущей сессии → глобальный `XAI_API_KEY`. Здесь достаточно сослаться через `env_key` на свою переменную — к официальному аккаунту xAI запросы не попадут.
* Если у новой модели опустить `context_window`, Grok Build по умолчанию считает его равным 200 000; лучше указать явно по выбранной модели.
* После подключения кастомного эндпоинта подписка xAI не нужна, но выбранная модель по-прежнему тарифицируется на стороне aicentos — сначала проверьте баланс на [странице кошелька](https://aicentos.com/wallet).