ZEROGUARD / DOCS
Подключение ZeroGuard API
Выбери адрес для своего ключа, проверь доступные модели и отправь первый запрос из терминала или редактора.
Подключение ключа
- Открой свой ключ
В @ZerGuardApiBot выбери «Мои ключи». Скопируй ключ и проверь, какой адрес подключения указан в его карточке.
- Выбери маршрут из карточки
Ключ покупателя использует
/customer-api/v1. Для выданного отдельно личного доступа используй/ide-api/v1.
https://zeroguardai.com/customer-api/v1В настройках редактора выбери OpenAI Compatible. В поле Base URL вставь адрес выше, в API Key — свой ключ. Для Model ID скопируй точное имя из каталога своего ключа.
Установка ZeroGuard Code
Расширение для Visual Studio Code. Один файл VSIX — отдельный редактор распаковывать не нужно.
ZeroGuard Code
Версия 0.3.2 · VSIX
- Открой Visual Studio Code.
Если редактор ещё не установлен, скачай VS Code.
- Установи скачанный VSIX.
Нажми Ctrl + Shift + P →
Extensions: Install from VSIX...→ выбериZeroGuard-Code-0.3.2.vsix. Дождись завершения установки. - Открой ZeroGuard.
Нажми значок ZeroGuard слева или Ctrl + Shift + L. Нажми «Подключить API» и вставь ключ из бота. Доступные модели появятся под полем сообщения.
- Выбери папку и напиши задачу.
«Чат» отвечает на вопросы. «Агент» работает с файлами и командами в выбранной папке. Разрешения можно изменить кнопкой рядом с переключателем режима.
Проверить файл
В PowerShell:
Get-FileHash -Algorithm SHA256 .\ZeroGuard-Code-0.3.2.vsixКонтрольная сумма загружается…Самостоятельная версия для Windows
Если используешь отдельную IDE, доступен архив версии 0.2.1. Его нужно полностью распаковать через «Извлечь всё», затем открыть ZeroGuard.exe внутри папки ZeroGuard-IDE. Включены актуальный интерфейс и подключение через основной сайт ZeroGuard.
Работа в IDE
При запуске Code занимает основную область окна. Файлы и терминал открываются через меню «⚙», рядом с кнопкой нового диалога.
| Действие | Где находится |
|---|---|
| Вернуться в Code | Ctrl + 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 ↗Другие редакторы
Ключ действует на доступные ему модели. Выбор одной модели в настройках не ограничивает сам ключ.
Какие модели доступны ключу
Выполни 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 -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-промптов — при активном доступе к приватному каналу. Бот проверяет срок доступа и участие в канале.
- Войди в личный кабинет через API-бота.
Открыть кабинет ↗. Бот пришлёт одноразовую ссылку, действующую 5 минут.
- Открой «Промпты» и выбери ИИ.
Точную модель выбирать не нужно.
- Вставь текст и нажми «Сохранить и включить».
До 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 ↗