Grok CLI

Консольный агент xAI с пользовательской моделью Guard.

Протокол модели

Claude, Kimi, Composer и Grok

Grok CLI это консольный агент xAI: репозиторий xai-org/grok-build, команда grok. Сторонний адрес у него не обходной путь, а описанная возможность: своя модель объявляется записью со своим адресом, своим ключом и своим протоколом.

bash

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

Настройки лежат в ~/.grok/config.toml. Каждая своя модель это запись [model.<имя>]. В ней model это точный id, который уйдёт на сервер, base_url это адрес, env_key называет переменную окружения с ключом, а api_backend выбирает протокол. Значений у него ровно три: chat_completions по умолчанию, responses и messages.

toml

# ~/.grok/config.toml
[model.guard]
model = "claude-sonnet-5-5"
name = "Guard Claude Sonnet 5.5"
base_url = "https://api.guardrelay.ai/v1"
env_key = "GUARD_API_KEY"
api_backend = "chat_completions"
max_completion_tokens = 8192
context_window = 1000000

toml

# ~/.grok/config.toml
[model.guard]
model = "k3"
name = "Guard Kimi K3"
base_url = "https://api.guardrelay.ai/v1"
env_key = "GUARD_API_KEY"
api_backend = "chat_completions"
max_completion_tokens = 8192
context_window = 1048576

toml

# ~/.grok/config.toml
[model.guard]
model = "cursor-grok-4.7-high"
name = "Guard Grok 4.7"
base_url = "https://api.guardrelay.ai/v1"
env_key = "GUARD_API_KEY"
api_backend = "chat_completions"
max_completion_tokens = 8192
context_window = 256000

toml

# ~/.grok/config.toml
[model.guard]
model = "composer-2.5"
name = "Guard Composer 2.5"
base_url = "https://api.guardrelay.ai/v1"
env_key = "GUARD_API_KEY"
api_backend = "chat_completions"
max_completion_tokens = 8192
context_window = 200000

Ключ кладётся в переменную, которую назвали в env_key, либо прямо в поле api_key той же записи. Клиент берёт сначала api_key, потом переменную из env_key, и только потом собственный вход в xAI и общую переменную XAI_API_KEY.

Запуск разовой задачи: grok -p "привет" -m guard. В сессии модель переключается командой /model guard, список показывает grok models, а постоянное значение по умолчанию задаётся отдельной записью [models] с полем default.

GLM 5.3 в Grok CLI

Установите Grok CLI

Установите официальный Grok Build по инструкции xAI. На macOS/Linux/Git Bash используйте первый блок; на Windows PowerShell — второй.

bash

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

powershell

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

Получите ключ Guard

Получите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.

Добавьте две модели GLM

Откройте ~/.grok/config.toml (Windows: %USERPROFILE%\.grok\config.toml). context_window = 200000 ниже — клиентский бюджет проверенного профиля, а не опубликованный лимит GLM. max_completion_tokens = 4096 — ограниченный пример для одного ответа.

toml

[models]
default = "glm-5.3"

[model."glm-5.3"]
model = "glm-5.3"
base_url = "https://api.guardrelay.ai/glm/v1"
name = "GLM 5.3"
env_key = "GUARD_GLM_API_KEY"
api_backend = "responses"
max_completion_tokens = 4096
context_window = 200000
supports_backend_search = false
stream_tool_calls = true

[model."glm-5.3-flash"]
model = "glm-5.3-flash"
base_url = "https://api.guardrelay.ai/glm/v1"
name = "GLM 5.3 Flash"
env_key = "GUARD_GLM_API_KEY"
api_backend = "responses"
max_completion_tokens = 4096
context_window = 200000
supports_backend_search = false
stream_tool_calls = true

macOS / Linux: введите ключ в скрытом приглашении. Переменная действует только в этом терминале и запущенном из него клиенте.

{
unset GUARD_GLM_API_KEY
until [ -n "${GUARD_GLM_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_GLM_API_KEY || break; printf "\n"; done
export GUARD_GLM_API_KEY

grok -m glm-5.3
}

Windows PowerShell: выполните команды в том же окне, из которого запускаете клиент. При открытии нового PowerShell задайте ключ снова.

powershell

$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_GLM_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password

grok -m glm-5.3

Проверьте и продолжите

bash

grok --model glm-5.3 --disable-web-search --single "Reply with exactly GLM_OK and remember PINE"
grok --continue --model glm-5.3 --disable-web-search --single "What word were you asked to remember?"

Для интерактивной беседы выполните grok -m glm-5.3; grok -c продолжает последнюю беседу в текущей папке. supports_backend_search = false и --disable-web-search не подключают отдельный поиск к GLM.

Модели и подтверждённые возможности

Model ID	Что использовать
`glm-5.3`	Основная модель; текст и задачи с кодом.
`glm-5.3-flash`	Быстрая модель; на уровне API принимает PNG и PDF во всех трёх протоколах, MP4 — только в Chat Completions.

Подтверждены Responses, локальные file/shell tools и --continue в той же папке.
Инструменты чтения, правки и терминала исполняет сам клиент. Этот профиль не подключает инструменты или MCP Z.AI автоматически.
Проверка этой версии была текстовой и не подтверждает её кнопку вложений. Возможности Flash на уровне API не означают, что конкретный интерфейс умеет передать файл.
Профиль использует OpenAI Responses. Серверный промпт GLM для обычного API выключен по умолчанию; настройка клиента сама его не включает.
Native TXT, DOCX и XLSX не входят в подтверждённый GLM-контракт. Для документов используйте PDF; для изображений — PNG и модель glm-5.3-flash.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID равен ровно `glm-5.3` или `glm-5.3-flash`; старые GLM ID, aliases, Turbo и FlashX не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/glm/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции API format; из старого профиля не перенесены reasoning, temperature, MCP или другие непроверенные поля.
`402 insufficient_balance`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
`grok models` не показывает GLM	Проверьте точные заголовки `[model."glm-5.3"]`, `[models] default` и файл в `GROK_HOME` текущего пользователя.
Клиент пытается войти в xAI	Проверьте `env_key = "GUARD_GLM_API_KEY"`, `api_backend = "responses"` и выбор custom model `glm-5.3`.

Gemini в Grok CLI

Установите Grok CLI

Установите официальный Grok Build по инструкции xAI. На macOS/Linux/Git Bash используйте первый блок; на Windows PowerShell — второй.

bash

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

powershell

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

Получите ключ Guard

Добавьте модели Gemini

Откройте ~/.grok/config.toml (Windows: %USERPROFILE%\.grok\config.toml). context_window = 1048576 ниже — окно модели из таблицы, это клиентский бюджет Grok CLI; max_completion_tokens = 4096 — ограниченный пример для одного ответа.

toml

[models]
default = "gemini-4-argon"

[model."gemini-4-argon"]
model = "gemini-4-argon"
base_url = "https://api.guardrelay.ai/v1"
name = "Gemini 4 Argon"
env_key = "GUARD_GEMINI_API_KEY"
api_backend = "responses"
max_completion_tokens = 4096
context_window = 1048576
supports_backend_search = false
stream_tool_calls = true

[model."gemini-3.8-flash"]
model = "gemini-3.8-flash"
base_url = "https://api.guardrelay.ai/v1"
name = "Gemini 3.8 Flash"
env_key = "GUARD_GEMINI_API_KEY"
api_backend = "responses"
max_completion_tokens = 4096
context_window = 1048576
supports_backend_search = false
stream_tool_calls = true

{
unset GUARD_GEMINI_API_KEY
until [ -n "${GUARD_GEMINI_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_GEMINI_API_KEY || break; printf "\n"; done
export GUARD_GEMINI_API_KEY
grok -m gemini-4-argon
}

powershell

$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_GEMINI_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
grok -m gemini-4-argon

Проверьте и продолжите

bash

grok --model gemini-4-argon --disable-web-search --single "Reply with exactly GUARD_GEMINI_OK and remember PINE"
grok --continue --model gemini-4-argon --disable-web-search --single "What word were you asked to remember?"

Для интерактивной беседы выполните grok -m gemini-4-argon; grok -c продолжает последнюю беседу в текущей папке. supports_backend_search = false и --disable-web-search не подключают отдельный поиск xAI к Gemini.

Модели и возможности Gemini

Model ID	Вход и окно
`gemini-4-argon`	Текст, изображения, PDF; окно 1 048 576 токенов, общее на вход и ответ.
`gemini-3.8-flash`	Текст, изображения, PDF; окно 1 048 576 токенов на вход.

Локальные файловые и shell-инструменты исполняет сам Grok CLI; --continue продолжает беседу в той же папке.
Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
Профиль использует OpenAI Responses. Серверный промпт — отдельная настройка семейства Gemini: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID — точный ID из таблицы выше или короткое имя `gemini`; другие написания не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
`402 insufficient_credit`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
`grok models` не показывает Gemini	Проверьте точные заголовки `[model."gemini-4-argon"]`, `[models] default` и файл в `GROK_HOME` текущего пользователя.
Клиент пытается войти в xAI	Проверьте `env_key = "GUARD_GEMINI_API_KEY"`, `api_backend = "responses"` и выбор custom model `gemini-4-argon`.

Muse в Grok CLI

Установите Grok CLI

Установите официальный Grok Build по инструкции xAI. На macOS/Linux/Git Bash используйте первый блок; на Windows PowerShell — второй.

bash

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

powershell

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

Получите ключ Guard

Добавьте модели Muse

toml

[models]
default = "muse-wonder-1.0"

[model."muse-wonder-1.0"]
model = "muse-wonder-1.0"
base_url = "https://api.guardrelay.ai/v1"
name = "Muse Wonder 1.0"
env_key = "GUARD_MUSE_API_KEY"
api_backend = "responses"
max_completion_tokens = 4096
context_window = 1048576
supports_backend_search = false
stream_tool_calls = true

[model."muse-spark-1.3"]
model = "muse-spark-1.3"
base_url = "https://api.guardrelay.ai/v1"
name = "Muse Spark 1.3"
env_key = "GUARD_MUSE_API_KEY"
api_backend = "responses"
max_completion_tokens = 4096
context_window = 1048576
supports_backend_search = false
stream_tool_calls = true

[model."muse-spark-1.2"]
model = "muse-spark-1.2"
base_url = "https://api.guardrelay.ai/v1"
name = "Muse Spark 1.2"
env_key = "GUARD_MUSE_API_KEY"
api_backend = "responses"
max_completion_tokens = 4096
context_window = 1048576
supports_backend_search = false
stream_tool_calls = true

{
unset GUARD_MUSE_API_KEY
until [ -n "${GUARD_MUSE_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_MUSE_API_KEY || break; printf "\n"; done
export GUARD_MUSE_API_KEY
grok -m muse-wonder-1.0
}

powershell

$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_MUSE_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
grok -m muse-wonder-1.0

Проверьте и продолжите

bash

grok --model muse-wonder-1.0 --disable-web-search --single "Reply with exactly GUARD_MUSE_OK and remember PINE"
grok --continue --model muse-wonder-1.0 --disable-web-search --single "What word were you asked to remember?"

Для интерактивной беседы выполните grok -m muse-wonder-1.0; grok -c продолжает последнюю беседу в текущей папке. supports_backend_search = false и --disable-web-search не подключают отдельный поиск xAI к Muse.

Модели и возможности Muse

Model ID	Вход и окно
`muse-wonder-1.0`	Текст, изображения, PDF; окно 1 048 576 токенов.
`muse-spark-1.3`	Текст, изображения, PDF; окно 1 048 576 токенов.
`muse-spark-1.2`	Текст, изображения, PDF; окно 1 048 576 токенов.

Локальные файловые и shell-инструменты исполняет сам Grok CLI; --continue продолжает беседу в той же папке.
Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
Профиль использует OpenAI Responses. Серверный промпт — отдельная настройка семейства Muse: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

Если подключение не получилось

Признак	Что проверить
`401 invalid_api_key`	Клиент получил полный действующий ключ `gd-…`; переменная задана в том же процессе, где запущен клиент.
`404 model_not_found`	Model ID — точный ID из таблицы выше или короткое имя `muse`; другие написания не поддерживаются.
`404` или неверный путь	Base URL равен `https://api.guardrelay.ai/v1`. Клиент сам добавляет `/responses`; не дописывайте его второй раз.
`400 invalid_request`	Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
`402 insufficient_credit`	Проверьте доступный баланс и незавершённые резервы в личном кабинете.
`grok models` не показывает Muse	Проверьте точные заголовки `[model."muse-wonder-1.0"]`, `[models] default` и файл в `GROK_HOME` текущего пользователя.
Клиент пытается войти в xAI	Проверьте `env_key = "GUARD_MUSE_API_KEY"`, `api_backend = "responses"` и выбор custom model `muse-wonder-1.0`.

Установите Grok CLI

Установите официальный Grok Build (grok) по инструкции xAI. На macOS/Linux/Git Bash используйте первую команду, на Windows PowerShell — вторую. Проверьте grok --version.

bash

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

powershell

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

Получите ключ Guard

В @guardapi откройте Категории → API, выберите пакет и сохраните ключ gd-…. Для пользовательской модели Grok отдельный вход в аккаунт xAI не нужен: ключ Guard передаётся через переменную GUARD_API_KEY.

Создайте пользовательскую модель

Откройте ~/.grok/config.toml (Windows: %USERPROFILE%\.grok\config.toml). Если файла нет, создайте папку .grok и файл config.toml в домашнем каталоге.
Добавьте таблицу [model.guard-codex]. Если в файле уже есть другие [model.*] или [models], оставьте их; не создавайте вторую таблицу [model.guard-codex].
Укажите model = "gpt-6-astra", base_url = "https://api.guardrelay.ai/codex/v1", env_key = "GUARD_API_KEY", api_backend = "responses". Это даёт POST /responses; суффикс /responses в базовый адрес не добавляйте.
Задайте GUARD_API_KEY в том терминале, где запускаете grok. Если в той же таблице есть api_key, он имеет приоритет над env_key; удалите старое значение, если переходите на переменную.

toml

# Добавьте в ~/.grok/config.toml
[model.guard-codex]
model = "gpt-6-astra"
name = "GUARD API · GPT-6 Astra"
base_url = "https://api.guardrelay.ai/codex/v1"
env_key = "GUARD_API_KEY"
api_backend = "responses"
context_window = 872000

Для gpt-6-astra можно выбрать допустимое усилие max при запуске. context_window задаёт бюджет Grok по метаданным каталога, а не жёсткий предел запроса. Этот профиль использует Responses: не добавляйте Chat-поле max_completion_tokens. Если клиент отправляет max_output_tokens, Guard принимает и сохраняет его, но managed Codex не гарантирует жёсткое усечение; списание идёт по фактическим токенам и денежным правилам ключа.

Последний сохранённый нативный каталог Guard объявляет следующие значения максимального окна для настройки клиентского бюджета. Это не проверенный жёсткий предел входа; клиент может сжать историю раньше. В подключении Guard все семь моделей принимают и сохраняют max_output_tokens (Responses), max_completion_tokens (Chat) и max_tokens (Messages) как advisory, без гарантии жёсткого лимита вывода managed Codex; списание идёт по фактическим токенам и денежным правилам ключа.

ID модели	Контекст для настройки клиента
`gpt-6-astra`	`872000`
`gpt-6.1-sol`	`872000`
`gpt-6-sol`	`872000`
`gpt-6-luna`	`872000`
`gpt-5.6-sol`	`872000`
`gpt-5.6-terra`	`872000`
`gpt-5.6-luna`	`872000`

Сделайте первый запрос

macOS / Linux: скрытый ввод не оставляет ключ в истории команд. Переменная действует только в текущем терминале. Запуск без -p открывает интерактивную беседу, куда можно написать следующий вопрос. Последняя строка блока, grok -c, продолжает последнюю беседу в той же папке.

bash

{
unset GUARD_API_KEY
until [ -n "${GUARD_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_API_KEY || break; printf "\n"; done
export GUARD_API_KEY
grok -p "Reply with exactly OK" -m guard-codex --reasoning-effort max
grok -c
}

Windows PowerShell:

powershell

$secret = Read-Host "Guard API key" -AsSecureString
$env:GUARD_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password
grok -p "Ответь ровно OK" -m guard-codex --reasoning-effort max
grok -c

Для нового интерактивного сеанса выполните grok -m guard-codex; для продолжения последней беседы в той же папке — grok -c. Команда grok models показывает доступные локальные имена, включая guard-codex.

Если подключение не получилось

Признак	Что проверить
`grok models` не показывает `guard-codex`	Таблица `[model.guard-codex]` есть в `~/.grok/config.toml`; файл сохранён и TOML корректен.
`401`	`GUARD_API_KEY` задан в текущем терминале, а старый `api_key` в таблице не перекрывает его.
`404` или неверный API	Base URL оканчивается на `/codex/v1`, `api_backend` равен `responses`, выбран точный ID `gpt-6-astra`.
`402`	Проверьте баланс и лимиты ключа в кабинете.

По проверке от 23 сентября 2026 года Grok CLI 0.2.93 с api_backend = "responses" подтвердила текстовые ответы, клиентские инструменты и продолжение в том же сеансе с gpt-6-astra через Base URL https://api.guardrelay.ai/codex/v1. Автоматическое название отдельным запросом отправляет temperature=1, а текущее подключение Codex отклоняет это поле с 400 invalid_request до reserve/egress. Это касается только автоназвания; основной клиент продолжает работать. Документированной настройки для отключения auto-title у клиента не найдено.

Grok CLI

Claude, Kimi, Composer и Grok

GLM 5.3 в Grok CLI

Установите Grok CLI

Получите ключ Guard

Добавьте две модели GLM

Проверьте и продолжите

Модели и подтверждённые возможности

Если подключение не получилось

Gemini в Grok CLI

Установите Grok CLI

Получите ключ Guard

Добавьте модели Gemini

Проверьте и продолжите

Модели и возможности Gemini

Если подключение не получилось

Muse в Grok CLI

Установите Grok CLI

Получите ключ Guard

Добавьте модели Muse

Проверьте и продолжите

Модели и возможности Muse

Если подключение не получилось

Установите Grok CLI

Получите ключ Guard

Создайте пользовательскую модель

Сделайте первый запрос

Если подключение не получилось

Разделы

На этой странице