Grok Code от xAI (Grok Build CLI): установка и начало работы

Grok Code — это Grok Build CLI от xAI: ИИ-агент для терминала. Установка на macOS и Linux, вход по X-аккаунту или API-ключу, базовые команды, работа с репозиторием, MCP и доступность из России.

Запрос «grok code» в рунете набирает 245 показов в месяц (Wordstat, август 2026), но под этим именем скрывается не репозиторий, а целый продукт: Grok Build — терминальный кодинг-агент xAI, который ставится одной командой и работает в виде полноэкранного TUI. Репозитория github.com/xai-org/grok-code не существует — официальный код лежит в github.com/xai-org/grok-build. Ниже — что это, как установить, войти и начать работать, и что из этого реально доступно из России на момент публикации (август 2026).

Что такое Grok Code (Grok Build CLI)

Grok Build — это агент xAI в терминале: читает кодовую базу, правит файлы, выполняет shell-команды, ищет в вебе и держит длительные фоновые задачи. Работает тремя способами (документация, docs.x.ai/build/overview):

• интерактивный TUI — полноэкранный, с мышью, похож на интерфейсы других терминальных агентов;
• headless — grok -p "промпт" для скриптов и CI с выводом в JSON;
• ACP (Agent Client Protocol) — grok agent stdio для встраивания в IDE и другие приложения.

Ядро агента — модель Grok 4.5 (контекст 500K токенов), на неё же xAI перевёл Grok Build (страница продукта). Знание модели — до 1 февраля 2026, свежие события она подтягивает через веб-поиск (docs.x.ai/developers/models).

С 14–15 июля 2026 года код Grok Build открыт — xAI опубликовала исходники после того, как исследователь Cereblab обнаружил в версии 0.2.93 скрытую загрузку репозиториев в облако (подробности — в разделе про приватность). Это релиз прозрачности, а не community-проект: внешние пул-реквесты не принимаются, репозиторий синхронизируется из закрытого монорепо.

Что умеет Grok Build

Возможности на момент публикации — по официальной документации (обзор, раздел команд, changelog):

• Plan-режим — сначала агент предлагает план, файлы не меняются до вашего одобрения;
• субагенты — параллельные дочерние агенты для исследования и ревью;
• Skills, Plugins, Hooks, MCP — расширения и внешние инструменты;
• совместимость с Claude Code — читает CLAUDE.md, .claude/rules/, скиллы и MCP Claude Code без настройки;
• AGENTS.md — конвенции проекта по директориям;
• песочница — профили workspace/read-only/strict для изоляции команд;
• память — решения и контекст переживают перезапуск сессии.

Что это значит на практике, хорошо видно на примере Джона Кука, который в июле 2026 прогнал через Grok 4.5 шахматную головоломку Мартина Гарднера — 5 белых и 3 чёрных ферзя на доске 5×5 (johndcook.com, 20.07.2026). Промпт он сформулировал так:

Generate SWI Prolog code to solve the following chess puzzle. On a 5 by 5 chessboard, place 5 white queens and 3 black queens so that no queen is attacking a queen of the other color. Have the code enumerate all solutions.

«Сгенерируй код на SWI Prolog для решения головоломки. На доске 5×5 размести 5 белых и 3 чёрных ферзя так, чтобы ни один ферзь не атаковал ферзя другого цвета. Пусть код перечислит все решения.»

Результат: код на Prolog отработал с первого раза и нашёл все восемь решений; код на Lean 4 — с третьей попытки. Кук сравнивает:

The code did not run on the first or second attempts but ran correctly on the third iteration. That’s better than I’ve seen before.

«Код не запустился с первой и второй попыток, но с третьей отработал корректно. Такого я раньше не видел.»

Показательно не «всё с первого раза», а то, что агент дошёл до рабочего результата за три итерации — типичная картина для автономного кодинг-агента.

Установка

Официальный способ установки — скрипт с сайта xAI. Никаких npm, brew и pip: бинарник скачивается и кладётся в ~/.grok/bin.

macOS и Linux

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

Скрипт сам добавляет ~/.grok/bin в PATH (прописывает блок в ~/.zshrc/~/.bashrc) и ставит автодополнение для bash, zsh и fish. После перезапуска терминала:

grok --version

Windows

irm https://x.ai/cli/install.ps1 | iex

Либо тот же curl | bash под Git for Windows / MSYS2 — установщик поддерживает оба пути (установщик x.ai/cli/install.sh).

Каналы и версии

По умолчанию ставится стабильная версия. На момент публикации актуальна Grok Build 1.0.0 (вышла 7 августа 2026, changelog); превью-канал включается переменной окружения GROK_CHANNEL=alpha. Обновления — командой grok update.

Вход: X-аккаунт или API-ключ

При первом запуске grok открывает браузер для авторизации — вход через аккаунт X (OAuth). Для окружений без браузера (сервер, CI) используется API-ключ xAI:

export XAI_API_KEY="xai-..."
grok

Ключи создаются в консоли xAI (console.x.ai). Для SSH/WSL с версии 0.2.34 работает вход по device code — grok login показывает код и ссылку, остаётся ввести его в браузере с любой машины (changelog, версия 0.2.34 от 07.06.2026). Внутри TUI аккаунтом управляют команды /login и /logout.

Способ входа	Кому подходит	Что нужно
Браузер при первом запуске	локальная работа	аккаунт X
grok login (device code)	SSH, WSL, удалённые машины	аккаунт X + доступ к ссылке
API-ключ XAI_API_KEY	headless, CI, боты	ключ из console.x.ai
GROK_DEPLOYMENT_KEY	корпоративное управление	ключ команды xAI

Тарифы на момент публикации

• Free — $0/мес: Grok Build доступен с «щедрыми лимитами» (формулировка самой xAI на странице тарифов), вход по X-аккаунту.
• SuperGrok — $30/мес: модель Grok 4.5, выше лимиты по всем функциям.
• SuperGrok Plus — $100/мес: существенно большие лимиты использования Build, приоритетный доступ.
• API, pay-as-you-go: grok-4.5 — $2 за 1M входных и $6 за 1M выходных токенов; специальная модель grok-build-0.1 — $1 и $2 (pricing, docs.x.ai).

Схема «установка → вход → старт» целиком:

Первый запуск и базовые команды

Запуск в директории проекта:

cd /путь/к/проекту
grok

Промпты, с которых обычно начинают (из официального quickstart и практики):

> Объясни этот репозиторий
> @src/main.rs Разбери этот файл по шагам
> Найди TODO и составь список задач
> Напиши тесты для функции parse_config и запусти их
> Почини ошибки компиляции в этом модуле

Слеш-команды внутри TUI (полный список — /help):

Команда	Назначение
/plan [описание]	войти в plan-режим, менять файлы нельзя до одобрения
/model <имя>	сменить модель
/context	текущее использование контекста
/usage	токены и стоимость сессии
/privacy	статус и настройки хранения данных
/new, /resume, /sessions	сессии: начать новую, вернуть, переключить
/rewind, /undo	откат к предыдущему шагу
/import-claude	перенести настройки Claude Code
/mcps, /skills, /plugins, /hooks	вкладки расширений

Headless-режим для скриптов и CI:

grok -p "Собери проект и почини ошибки" --output-format streaming-json
grok -p "Объясни архитектуру" --cwd /путь/к/проекту -m grok-4.5

Флаг --no-auto-update отключает фоновую проверку обновлений в автоматизированных средах — пригодится, чтобы CI не решал сам, когда обновляться (headless-документация).

Работа с репозиторием

Grok Build читает конвенции проекта так же, как Claude Code: файлы AGENTS.md, Agents.md, CLAUDE.md и .claude/rules/ подхватываются автоматически — при переезде с Claude Code ничего настраивать не нужно. Свои правила можно класть в .grok/, а глобальные — в ~/.grok/config.toml (модели, права доступа, песочница).

Полезная команда для знакомства с тем, что агент видит в вашей папке:

grok inspect

Она показывает источники конфигурации, скиллы, плагины, хуки и подключённые MCP-серверы. А команда /skillify сохраняет текущую сессию как переиспользуемый скилл — рабочий приём для повторяющихся задач в одном проекте.

MCP: подключаем внешние инструменты

MCP-серверы добавляются одной командой (документация):

# Локальный сервер (stdio)
grok mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /путь/к/папке

# Удалённый сервер по HTTP (OAuth подхватывается автоматически)
grok mcp add --transport http linear https://mcp.linear.app/mcp

Управление: grok mcp list — список, grok mcp remove <имя> — удалить, grok mcp doctor [имя] — диагностика подключения. В TUI то же самое делает вкладка /mcps.

Grok Build также читает чужие MCP-конфигурации — ~/.claude.json, .cursor/mcp.json, проектный .mcp.json — и подключает их автоматически. Это значит, что серверы, которые вы уже настроили для Claude Code или Cursor, работают и в grok без дублирования. Подробно о протоколе — в нашей статье про MCP.

Приватность: что нужно знать до запуска

Самый чувствительный момент Grok Build — и его нельзя обойти в статье про установку. В июле 2026 исследователь Cereblab разобрал трафик версии 0.2.93 и показал, что CLI загружал в облако xAI больше, чем нужно для ответа (wire-level анализ, gist):

It transmits the contents of files it reads — including a .env secrets file — to xAI, verbatim and unredacted. […] It uploads the whole repository — every tracked file’s content plus git history — independent of what the agent reads.

«Он передаёт в xAI содержимое читаемых файлов — включая .env с секретами — дословно и без редактирования. […] Он загружает весь репозиторий — содержимое каждого отслеживаемого файла плюс git-историю — независимо от того, что агент реально читал.»

Что изменилось с тех пор (на момент публикации):

• 13 июля 2026 xAI отключила серверную загрузку данных (disable_codebase_upload: true на стороне сервера);
• 14–15 июля 2026 компания опубликовала исходники Grok Build под Apache 2.0, Илон Маск пообещал безвозвратно удалить ранее собранные данные;
• в интерфейсе появилась команда /privacy (настройка хранения данных).

Даже с учётом этих мер разумно включить локальные переключатели, если работаете с чужим или коммерческим кодом. В ~/.grok/config.toml:

[harness]
disable_codebase_upload = true

И/или переменные окружения:

export GROK_TELEMETRY_ENABLED=0
export GROK_TELEMETRY_TRACE_UPLOAD=0

Проверка и диагностика — grok doctor. Подробный разбор инцидента, что именно уходило в облако и как проверять сетевую активность агента, — в отдельном кейсе про Grok Build CLI. Для серийной работы это чтение обязательное.

Российские реалии

Тема «Grok Code / Grok Build в России» в рунете почти не освещена: пошаговых русскоязычных гайдов по установке и настройке CLI на момент публикации нет. Поиск на Хабре по «grok cli» и «grok xai» не даёт результатов; разборы ограничиваются чат-версией Grok. Ниже — что известно из доступных русскоязычных источников и практики с аналогичными сервисами.

• Геофильтр. xAI фильтрует российские IP-адреса на своей стороне: grok.com и x.ai открываются из РФ только у части провайдеров, стабильной работы без зарубежного IP ждать не стоит. Формально Роскомнадзор grok.com не блокировал — ограничение ставит сама компания (AIMarketCap, 01.08.2026).
• Регистрация. Для входа в Grok Build нужен аккаунт X. При верификации сервис может запросить телефон, а российские номера проходят проверку не всегда — проще завести аккаунт через VPN с «чистым» зарубежным IP.
• Оплата. Платежи обрабатывает Stripe, который отсекает карты российских банков: Visa, Mastercard, Mir для подписки SuperGrok не подходят. Рабочие варианты — карта банка Казахстана/Узбекистана/Киргизии или посредники. Бесплатный тариф карты не требует — этого достаточно для знакомства с Grok Build.
• Агрегаторы. Для чат-доступа к Grok работают российские агрегаторы (Study24, FICHI.AI, GPTunnel, Syntx AI), которые перепродают API-доступ за рубли, — но это именно чат с моделью, не Grok Build CLI (там же). Для CLI нужен либо X-аккаунт, либо API-ключ с зарубежной картой.
• Кейс с утечкой освещён и в рунете: новость о том, что xAI открыла код Grok Build после обнаружения загрузки репозиториев в облако, разобрана на Tproger (июль 2026).

Коротко: установить Grok Build из РФ можно, бесплатный тариф карты не требует, но стабильно работать получится только через VPN, а платные лимиты — с зарубежной картой или посредником.

Советы для старта

• Начните на пет-проекте: «объясни этот модуль», «напиши тесты» — и только потом разрешайте агенту менять прод.
• Запускайте агента в отдельной директории проекта, а не в $HOME — и проверяйте политику данных через /privacy.
• Коммитьте до начала сессии и просматривайте диффы: Grok Build вносит правки в файлы, ошибки случаются.
• Не включайте always-approve без необходимости — режим ask по умолчанию дешевле в смысле контроля.
• Для CI добавляйте --no-auto-update: обновление посреди пайплайна — источник неожиданных расхождений.
• Используйте /rewind, если агент пошёл не туда — это быстрее, чем переписывать промпт заново.

Честные ограничения

• Кейс с приватностью не забыт. Серверную загрузку xAI отключила, но доверие к облачной части инструмента восстанавливается медленно; для коммерческого кода с секретами сначала читайте разбор инцидента и включайте локальные отключения.
• Код открыт, но это не community-проект. Внешние пул-реквесты не принимаются, репозиторий синхронизируется из монорепо — «открытый» здесь означает «можно прочитать и собрать», а не «можно влиять на развитие».
• Молодой инструмент. Версия 1.0.0 вышла 7 августа 2026 — интерфейс и поведение ещё меняются от релиза к релизу, часть документации отстаёт от кода.
• Закрытая серверная часть. Модель и API живут в облаке xAI: локальная установка не делает агента локальным.
• Оплата из РФ. Бесплатный тариф доступен, платные лимиты и API — нет без зарубежной карты или посредника.

Вывод

Grok Code (Grok Build CLI) — рабочий терминальный агент от xAI, который за год прошёл путь от закрытого сервиса до открытого кода (Apache 2.0): одна команда установки, вход по X-аккаунту или API-ключу, бесплатный тариф для старта, а после него — SuperGrok за $30/мес или pay-as-you-go через API. Из России инструмент устанавливается штатно, но работать стабильно получится через VPN, а платить — только зарубежной картой.

Главное, что нужно помнить при старте: это облачный агент с файловым доступом, и история с загрузкой репозиториев в июле 2026 — не повод игнорировать приватность, а повод проверить настройки до того, как пускать его в коммерческий код.

Дальше по серии «Агентный кодинг для программистов»: общая вводная — «Что такое агентный кодинг», аналоги-установки — «Как установить Codex CLI», «Как установить Gemini CLI», «Как установить Claude Code», подключение внешних данных — «Что такое MCP», конвенции — «AGENTS.md», разбор инцидента с приватностью — «Кейс: Grok Build CLI — скорость, цена и приватность».