ZEROGUARD / DOCS
Открыл.
Подключил. Работаешь.
Короткие инструкции для ZeroGuard Code и твоего редактора.
Быстрый старт
- Получи ключ в боте.
Открой @ZerGuardApiBot → «Мои ключи». Если доступа ещё нет, бот покажет доступные варианты. Покупка и выдача ключей происходят только в боте.
- Выбери приложение.
ZeroGuard Code или другая IDE. Для OpenCode и Continue: в боте «Подключить API» → программа → система → скопируй команду. Она добавит все доступные ключу модели.
- Подключи адрес и ключ.
Вставь Base URL ниже и свой ключ в настройках приложения. Модель можно менять с тем же ключом.
https://www.zeroguardai.com/ide-api/v1Установка 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 ↗Другие редакторы
Ключ действует на доступные ему модели. Выбор одной модели в настройках не ограничивает сам ключ.
Запрос к API
Для личного маршрута /ide-api/v1 используй OpenAI Compatible / Chat Completions. Поддерживаются потоковые ответы и клиентские инструменты, если они доступны у модели. Для моделей Claude доступен совместимый Messages-маршрут через Chat Completions. Responses не поддерживается.
Передай ключ в заголовке Authorization: Bearer …. В примере переменная ZEROGUARD_API_KEY должна содержать твой ключ; страница его не запрашивает и запрос не запускает.
curl https://www.zeroguardai.com/ide-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.
Модели
Каталог подгружается через GET /models с твоим ключом. В Code это происходит при подключении; обновление доступно в меню «⚙». Для другой IDE точный ID можно взять из ответа этого маршрута.
curl https://www.zeroguardai.com/ide-api/v1/models \
-H "Authorization: Bearer $ZEROGUARD_API_KEY"Публичный каталог и состояние моделей доступны на сайте. Метрики показывают нагрузку нашего шлюза и результаты недавних запросов. «Нет данных» означает отсутствие свежих наблюдений.
Jailbreak-промпты
Функция jailbreak-промптов — при активном доступе к приватному каналу. Бот проверяет срок доступа и участие в канале.
- Войди в личный кабинет через API-бота.
Открыть кабинет ↗. Бот пришлёт одноразовую ссылку, действующую 5 минут.
- Открой «Промпты» и выбери ИИ.
Точную модель выбирать не нужно.
- Вставь текст и нажми «Сохранить и включить».
До 4 000 символов. Промпт применяется ко всем моделям выбранного ИИ по твоим ключам. Его также можно изменить в боте.
При истечении доступа промпт перестаёт добавляться к запросам. Проверка участия в Telegram кешируется не дольше 30 секунд. Отключение и удаление доступны и без подписки.
Промпт хранится на сервере до удаления. Переписка API не сохраняется. Инструкция учитывается во входных токенах; её выполнение зависит от модели.
Расход и лимиты ключа
В личном кабинете выбери ключ и открой «Лимиты и модели ключа». Можно изменить частоту запросов и разрешённые модели в пределах выданного доступа. Новые ограничения действуют на следующие запросы.
В боте нажми «Остаток» или отправь /balance. Если ключ передали отдельно, открой проверку остатка. В API доступны GET /balance и GET /usage; чтение не расходует квоту запросов.
Долларовый бюджет и лимит запросов — разные ограничения. «1 000 запросов» не означает $1 000. Когда поставщик не сообщает денежный баланс, он показывается как неизвестный. Отозванный ключ использовать нельзя.
Если что-то не работает
| Ошибка | Что проверить |
|---|---|
| 401 | Ключ без лишних пробелов, правильный Base URL, ключ не отозван. |
| 403 | У ключа есть доступ к нужной модели и операции. |
| 404 | Адрес заканчивается на /v1, выбран Chat Completions, точный ID модели взят из каталога. |
| 429 | Частота, параллельность или квота ключа. Учитывай Retry-After, если он есть; не отправляй повторы одновременно. |
| 502 · источник прервал ответ | Ответ поставщика не завершился. Проверь состояние модели и расход перед повтором: часть обработки могла уже произойти. |
| Агент отвечает кодом, но не меняет файлы | Выбраны «Агент», рабочая папка и модель с инструментами; папка доверенная, изменения разрешены. |
| Старая версия интерфейса IDE | Заверши задачу, полностью закрой IDE и запусти обновлённую сборку. |
В поддержку можно передать модель, время и код ошибки. Не отправляй API-ключ в сообщении. Открыть бота ↗
Хранение данных
История Code хранится на твоём устройстве. Наш hosted API обрабатывает сообщения и ответы в памяти без сохранения переписки. Сохраняются сведения о доступе, платежах и расходе, а также инструкции, которые ты явно установил в боте.
Сохранённые инструкции входят в приватные резервные копии; после удаления старые копии могут оставаться в пределах срока их хранения. Поставщик модели получает содержимое запроса, и его политика хранения действует отдельно.
Публичная политика API ↗