Grok CLI

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

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

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

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

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

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

brew install node

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

node -v
npm -v

Установка Grok CLIКопировать ссылку на якорь

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

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

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

grok --version

Настройка подключенияКопировать ссылку на якорь

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

Способ 1: переменные окружения (рекомендуется)Копировать ссылку на якорь

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

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:

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

Способ 3: аргументы командной строкиКопировать ссылку на якорь

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

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

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

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

grok

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

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

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

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

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

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

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

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

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