Установка Grok Build на macOS, Linux или Windows за две минуты

Перед установкой

Grok Build — терминальное приложение от SpaceXSI (ранее xAI). Есть готовые сборки для macOS, Linux и Windows. Вам понадобятся:

• Терминал: Terminal или iTerm на macOS, любая оболочка на Linux, PowerShell или Git Bash на Windows.
• Веб-браузер для первого входа или API-ключ, если вы настраиваете его на сервере.
• Аккаунт. Grok Build можно попробовать бесплатно, а тариф Plus в The X Subscription ($8 в месяц) и старшие тарифы дают больше использования.

Команды установки

1. macOS, Linux или Git Bash: выполните curl -fsSL https://x.ai/cli/install.sh | bash
2. Windows PowerShell: выполните irm https://x.ai/cli/install.ps1 | iex
3. Проверьте результат: выполните grok --version. Если выводится номер версии, установка прошла успешно.

Обе команды взяты с официальной страницы Grok Build и из репозитория на GitHub. По данным стороннего гида по настройке, установщик помещает программу в ~/.grok/bin.

Разработчики также могут собрать его из исходников. Для этого нужны тулчейн Rust (устанавливается и фиксируется через rustup), DotSlash (cargo install dotslash) и protoc. Поддерживаемые платформы для сборки — macOS и Linux. Сборка под Windows поддерживается «по мере возможности», поэтому пользователям Windows лучше брать готовую сборку.

Первый запуск и вход

1. Откройте терминал в папке проекта, а не в домашней папке.
2. Выполните grok.
3. Откроется окно браузера для входа, обычно на grok.com.
4. После входа запустится терминальный интерфейс. Учётные данные хранятся в ~/.grok/auth.json.

Почему важна папка проекта: в июле 2026 г. запуск Grok Build мог загрузить всю текущую папку в облачное хранилище компании. SpaceXSI отключила это в тот же день и утверждает, что теперь Build может работать полностью локально. Запускать его в папке проекта всё равно безопаснее, ведь агент может читать и редактировать файлы там, где он запущен.

По умолчанию Grok Build работает в режиме планирования: он предлагает план и ничего не меняет, пока вы его не утвердите.

Обновление и проверка настройки

• grok update обновляет Grok Build до последней версии.
• grok doctor проверяет настройку терминала и сообщает о проблемах.
• grok --version показывает установленную версию.

Обновляйтесь почаще. SpaceXSI быстро выпускает новые функции, а новые модели, такие как Grok 4.7, появляются в Grok Build в день релиза.

API-ключ в CI

На серверах сборки вход через браузер не работает. Для CI задайте переменную окружения XAI_API_KEY и используйте headless-режим для скриптов и пайплайнов.

1. Создайте аккаунт на console.x.ai.
2. Пополните баланс. API работает по предоплате, и когда кредиты заканчиваются, запросы отклоняются.
3. Создайте ключ на странице API Keys.
4. Сохраните его как секрет в вашей CI-системе и передайте как XAI_API_KEY.

Использование через API-ключ оплачивается по тарифам API, а не из пула вашей подписки. Модель grok-build-0.1 стоит $1 за миллион входных токенов и $2 за миллион выходных.

Файл конфигурации и разрешения

Grok Build хранит настройки в ~/.grok/config.toml. Там же настраиваются MCP-серверы для подключения к инструментам вроде Linear, Sentry или Postgres.

Соглашения для отдельных проектов задаются в файле AGENTS.md в каждой папке. Сторонний гид перечисляет такие режимы разрешений: default, acceptEdits, auto, dontAsk, bypassPermissions и plan. Полезные флаги — --worktree, --no-plan и --no-subagents. Не используйте bypassPermissions, если только не запускаете Build в песочнице.

Частые проблемы

• «grok: command not found»: откройте новый терминал, чтобы оболочка перечитала пути, и проверьте, что ~/.grok/bin есть в PATH.
• Интерфейс отображается криво: выполните grok doctor, чтобы проверить поддержку терминала.
• Окно входа не открывается: на удалённой машине используйте XAI_API_KEY.
• API-ключ отклоняется: проверьте, что на балансе аккаунта в консоли есть кредиты.
• Нет Grok 4.7 Fast: Fast не входит в бесплатный тариф.
• Лимит закончился: платные тарифы делят один недельный пул с чатом Grok и Cursor. Активное использование в одном месте оставляет меньше для остальных.

Частые вопросы