ZeroGuardУстановить CodeОткрыть бота ↗

ZEROGUARD / DOCS

Подключение ZeroGuard API

Выбери адрес для своего ключа, проверь доступные модели и отправь первый запрос из терминала или редактора.

Подключение ключа

  1. Открой свой ключ

    В @ZerGuardApiBot выбери «Мои ключи». Скопируй ключ и проверь, какой адрес подключения указан в его карточке.

  2. Выбери маршрут из карточки

    Ключ покупателя использует /customer-api/v1. Для выданного отдельно личного доступа используй /ide-api/v1.

Тип ключа для примеров на странице
BASE URLhttps://zeroguardai.com/customer-api/v1

В настройках редактора выбери OpenAI Compatible. В поле Base URL вставь адрес выше, в API Key — свой ключ. Для Model ID скопируй точное имя из каталога своего ключа.

Установка ZeroGuard Code

Расширение для Visual Studio Code. Один файл VSIX — отдельный редактор распаковывать не нужно.

РАСШИРЕНИЕ ДЛЯ VS CODE

ZeroGuard Code

Версия 0.3.2 · VSIX

Скачать расширение ↓
  1. Открой Visual Studio Code.

    Если редактор ещё не установлен, скачай VS Code.

  2. Установи скачанный VSIX.

    Нажми Ctrl + Shift + P → Extensions: Install from VSIX... → выбери ZeroGuard-Code-0.3.2.vsix. Дождись завершения установки.

  3. Открой ZeroGuard.

    Нажми значок ZeroGuard слева или Ctrl + Shift + L. Нажми «Подключить API» и вставь ключ из бота. Доступные модели появятся под полем сообщения.

  4. Выбери папку и напиши задачу.

    «Чат» отвечает на вопросы. «Агент» работает с файлами и командами в выбранной папке. Разрешения можно изменить кнопкой рядом с переключателем режима.

Проверить файл

В PowerShell:

Get-FileHash -Algorithm SHA256 .\ZeroGuard-Code-0.3.2.vsix
Контрольная сумма загружается…
Файл контрольной суммы
Самостоятельная версия для Windows

Если используешь отдельную IDE, доступен архив версии 0.2.1. Его нужно полностью распаковать через «Извлечь всё», затем открыть ZeroGuard.exe внутри папки ZeroGuard-IDE. Включены актуальный интерфейс и подключение через основной сайт ZeroGuard.

Работа в IDE

При запуске Code занимает основную область окна. Файлы и терминал открываются через меню «⚙», рядом с кнопкой нового диалога.

ДействиеГде находится
Вернуться в CodeCtrl + Shift + L
Файлы проекта«⚙» → «Файлы проекта»
Терминал«⚙» → «Терминал»
API и ключСтатус подключения вверху или Ctrl + Alt + A
История чатовЗначок часов вверху
Новый диалог«+» вверху
Отправить картинкуCtrl + V, кнопка с картинкой или перетаскивание
Сменить модельСписок под полем сообщения
Локальный промпт и темаМеню «⚙»
Права агентаКнопка рядом с «Чат / Агент»

В сообщение можно добавить до четырёх изображений. Поддержка их анализа зависит от модели. История чатов сохраняется на устройстве и восстанавливается при запуске. Открытые файлы и несохранённые правки не закрываются при переходе в Code.

Claude Code внутри ZeroGuard

Открой папку проекта, затем ⚙ → Claude Code. IDE передаст текущий ключ ZeroGuard и предложит доступную модель Claude. Сессия откроется в основной области окна. Вернуться в чат: Ctrl + Shift + L.

Первый запуск

Если Claude Code не установлен, появится кнопка установки через WinGet. Дождись завершения, затем снова нажми «Claude Code». Для входа со своей подпиской выбери «Аккаунт Claude».

Запуск через ZeroGuard использует отдельные настройки и историю Claude Code на устройстве. Ключ передаётся в окружении процесса. Расширенные beta-возможности, явное кеширование и параметр thinking отключены для совместимости; подсчёт контекста в Claude Code приблизительный. Подтверждения действий остаются в Claude Code.

Документация Claude Code ↗

Другие редакторы

Ключ действует на доступные ему модели. Выбор одной модели в настройках не ограничивает сам ключ.

VS Code / Cursor Cline

Установи Cline из Extensions. В Cline выбери OpenAI Compatible. Укажи публичный Base URL, свой API-ключ и Model ID из каталога. Режим Act включает работу с файлами.

Инструкция Cline ↗
JetBrains Continue

Установи Continue из Marketplace. Подключи OpenAI Compatible, укажи Base URL и ключ. Для настройки всех доступных моделей используй команду Continue в блоке подключения на сайте.

Открыть подключение ↗
OpenCode Терминал

На сайте открой «Подключить другую IDE», выбери OpenCode и свою систему. Команда спросит ключ и добавит все доступные модели.

Получить команду ↗

Какие модели доступны ключу

Выполни GET /models в терминале. Он покажет разрешённые ключу модели без генерации ответа. Используй поле id из массива data в настройках клиента и запросах.

macOS и Linux Bash / Zsh
Список моделей
printf 'API key: '
read -rs ZEROGUARD_API_KEY
printf '\n'
curl -sS 'https://zeroguardai.com/customer-api/v1/models' \
  -H "Authorization: Bearer $ZEROGUARD_API_KEY"
Windows PowerShell
Список моделей
$secret = Read-Host 'API key' -AsSecureString
$key = [Net.NetworkCredential]::new('', $secret).Password
$headers = @{ Authorization = "Bearer $key" }
$models = Invoke-RestMethod -Uri 'https://zeroguardai.com/customer-api/v1/models' -Headers $headers
$models.data | Select-Object -ExpandProperty id

На сайте виден общий каталог. Ответ с твоим ключом определяет доступ именно для этого подключения. Если массив пуст, проверь разрешённые модели ключа в кабинете.

Запрос к API

Отправь сообщение на POST /chat/completions. Вставь точный ID из ответа GET /models. При успешном запросе текст придёт в choices[0].message.content. Генерация расходует баланс или квоту ключа.

Передай ключ в заголовке Authorization: Bearer …. Если ты уже проверил список моделей в Bash или Zsh, переменная ZEROGUARD_API_KEY задана в этом окне терминала.

cURL · bash / macOS / Linux
curl -sS 'https://zeroguardai.com/customer-api/v1/chat/completions' \
  -H "Authorization: Bearer $ZEROGUARD_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"MODEL_ID","messages":[{"role":"user","content":"Привет"}],"max_tokens":256,"stream":false}'

Замени MODEL_ID точным ID из своего каталога. Один ключ может давать доступ к нескольким моделям. Строка model выбирает модель только для этого запроса.

Метод и путьНазначение
GET /modelsМодели, разрешённые ключу
POST /chat/completionsОтвет модели, в том числе SSE при stream: true
GET /balanceОстаток и ограничения ключа
GET /usageУчёт расхода ключа
GET /statusСостояние шлюза и доступные ключу модели

Пути дописываются к Base URL. Для потокового ответа используй curl -N и "stream":true. При tool calling инструменты выполняет твой клиент; он возвращает результат с исходным tool_call_id.

Jailbreak-промпты

Функция jailbreak-промптов — при активном доступе к приватному каналу. Бот проверяет срок доступа и участие в канале.

  1. Войди в личный кабинет через API-бота.

    Открыть кабинет ↗. Бот пришлёт одноразовую ссылку, действующую 5 минут.

  2. Открой «Промпты» и выбери ИИ.

    Точную модель выбирать не нужно.

  3. Вставь текст и нажми «Сохранить и включить».

    До 4 000 символов. Промпт применяется ко всем моделям выбранного ИИ по твоим ключам. Его также можно изменить в боте.

При истечении доступа промпт перестаёт добавляться к запросам. Проверка участия в Telegram кешируется не дольше 30 секунд. Отключение и удаление доступны и без подписки.

Промпт хранится на сервере до удаления. Переписка API не сохраняется. Инструкция учитывается во входных токенах; её выполнение зависит от модели.

Расход и лимиты ключа

В личном кабинете выбери ключ и открой «Лимиты и модели ключа». Можно изменить частоту запросов и разрешённые модели в пределах выданного доступа. Новые ограничения действуют на следующие запросы.

В боте нажми «Остаток» или отправь /balance. Если ключ передали отдельно, открой проверку остатка. В API доступны GET /balance и GET /usage; чтение не расходует квоту запросов.

Долларовый бюджет и лимит запросов — разные ограничения. «1 000 запросов» не означает $1 000. Когда поставщик не сообщает денежный баланс, он показывается как неизвестный. Отозванный ключ использовать нельзя.

Если что-то не работает

ОшибкаЧто проверить
400Открой поле error.message в ответе. Проверь формат JSON, ID модели и поддерживаемые параметры.
401Ключ без лишних пробелов, правильный Base URL, ключ не отозван.
403У ключа есть доступ к нужной модели и операции.
404Адрес заканчивается на /v1, выбран Chat Completions, точный ID модели взят из каталога.
429Частота, параллельность или квота ключа. Учитывай Retry-After, если он есть; не отправляй повторы одновременно.
502 · источник прервал ответОтвет поставщика не завершился. Проверь состояние модели и расход перед повтором: часть обработки могла уже произойти.
503Шлюз или источник временно недоступен. Проверь состояние моделей и повтори позже.
Агент отвечает кодом, но не меняет файлыВыбраны «Агент», рабочая папка и модель с инструментами; папка доверенная, изменения разрешены.
Старая версия интерфейса IDEЗаверши задачу, полностью закрой IDE и запусти обновлённую сборку.

В поддержку можно передать модель, время и код ошибки. Не отправляй API-ключ в сообщении. Открыть бота ↗

Хранение данных

История Code хранится на твоём устройстве. Наш hosted API обрабатывает сообщения и ответы в памяти без сохранения переписки. Сохраняются сведения о доступе, платежах и расходе, а также инструкции, которые ты явно установил в боте.

Сохранённые инструкции входят в приватные резервные копии; после удаления старые копии могут оставаться в пределах срока их хранения. Поставщик модели получает содержимое запроса, и его политика хранения действует отдельно.

Публичная политика API ↗