Grok Build

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

ПодготовкаКопировать ссылку на якорь

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

  Копировать

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

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

Конфигурация для заполненияКопировать ссылку на якорь

Шаги настройкиКопировать ссылку на якорь

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

  Копировать

  export AICENTOS_API_KEY="your_api_key_here"

• Отредактируйте ~/.grok/config.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 и переключите модель через селектор или команду:

  Копировать

  grok
  /model aicentos-grok

ПроверкаКопировать ссылку на якорь

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

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 — сначала проверьте баланс на странице кошелька.