CCG API Docs / Grok CLI
Grok CLI · интеграция

Grok CLI с нашим API

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

Начать настройку Открыть статистику

Поддерживаемые ключи

Grok CLI говорит только по OpenAI-протоколу, поэтому поддерживаются GPT-ключи.

Ваш ключКак подключаетсяBase URLМодель (пример)
GPT (gpt-*)env GROK_BASE_URL + GROK_API_KEYhttps://bridge.gptclaudegemini.xyz/v1gpt-5.6-terra
Claude (claude-*)не поддерживается: у Grok CLI нет Anthropic-режима
Один ключ — один тип моделей

Ключ видит только модели своего тарифа. Проверить список: GET https://bridge.gptclaudegemini.xyz/v1/models с вашим ключом.

Установка и настройка

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

    Нужен Node.js 18+.

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

  2. Задайте переменные окружения

    macOS / Linux
    export GROK_BASE_URL="https://bridge.gptclaudegemini.xyz/v1"
export GROK_API_KEY="sk-xxxxxxxxxx"
    Windows PowerShell
    $env:GROK_BASE_URL = "https://bridge.gptclaudegemini.xyz/v1"
$env:GROK_API_KEY = "sk-xxxxxxxxxx"

    Чтобы сохранить настройки навсегда, добавьте строки в профиль оболочки или задайте их в ~/.grok/user-settings.json.

  3. Запустите с моделью

    Terminal
    grok --model gpt-5.6-terra

Выбор модели

Доступные model ID зависят от вашего ключа:

Terminal
curl https://bridge.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

Решение проблем

Invalid API Key / 401
Проверьте, что ключ скопирован целиком и без пробелов, а Base URL указан точно как в таблице выше.
Model Not Found
Запросите список моделей вашего ключа через /v1/models и используйте точный ID из ответа.
Первый запрос упал с 5xx, повтор прошел
При недоступности одного upstream шлюз переключается на резервный, но первая попытка может вернуть ошибку. Повторите запрос.
Переменные не применяются
Откройте новый терминал после правки профиля оболочки. Проверьте значения: echo $GROK_BASE_URL.
«Cannot read properties of undefined (reading '0')» в режиме --prompt
Известный баг headless-режима текущих версий grok-cli: API возвращает корректный ответ, но CLI падает на своей стороне. Используйте интерактивный режим (grok без --prompt) или обновите grok-cli, когда выйдет исправление.

Статистика и ключ

Статистика открывается на отдельном сервисе. Для поиска используйте полный токен; в интерфейсе отображается только маскированная часть ключа.

Открыть статистику