# Grok CLI

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

Language: ru

> Использование aicentos в Grok CLI — подключение через переменные окружения или файл конфигурации

Grok CLI — консольный инструмент на OpenAI-совместимом интерфейсе: кастомный адрес API можно подключить напрямую в качестве его бэкенд-сервиса.

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

Сначала установите Node.js 18+ и npm.

Рекомендуется установка со страницы загрузки Node.js: [https://nodejs.org/en/download](https://nodejs.org/en/download)

* macOS/Windows: скачайте и установите LTS-версию
* Linux: установка способом для вашего дистрибутива

Пользователи macOS могут также использовать Homebrew:

```bash
brew install node
```

После установки убедитесь:

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

## Установка Grok CLI

Глобальная установка через npm:

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

После установки проверьте:

```bash
grok --version
```

## Настройка подключения

Grok CLI предлагает три способа конфигурации с приоритетом: аргументы командной строки > переменные окружения > файл конфигурации.

### Способ 1: переменные окружения (рекомендуется)

Задайте следующие переменные окружения:

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

Для быстрой проверки достаточно выполнить export в текущем shell. Для постоянного действия добавьте эти строки в `~/.zshrc` или `~/.bashrc`, затем выполните `source ~/.zshrc`, чтобы они вступили в силу.

### Способ 2: файл конфигурации

Отредактируйте `~/.grok/user-settings.json`:

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

### Способ 3: аргументы командной строки

Укажите параметры при запуске:

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

## Запуск и использование

Когда конфигурация готова, просто запустите:

```bash
grok
```

После запуска отправьте сообщение в Grok CLI: если ответ приходит нормально, подключение выполнено успешно.

## Проверка и устранение неполадок

При ошибке аутентификации проверьте:

* корректность `GROK_API_KEY`
* указывает ли `GROK_BASE_URL` / `baseURL` на правильный адрес сервиса (нужен суффикс `/v1`)

Убедившись, что конфигурация верна, просто перезапустите.

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

* Grok CLI работает через OpenAI-совместимый интерфейс, настройка простая и прямая
* Три способа конфигурации можно свободно выбирать; рекомендуется способ с переменными окружения
* Адрес API обязательно должен содержать суффикс `/v1`
* Поддерживается кастомная модель по умолчанию

## Полезные ссылки

* Официальная документация: [https://docs.aicentos.com/clients/grok-cli.html](https://docs.aicentos.com/clients/grok-cli.html)