Перейти к содержанию
Документация
Подключить клиентZCode

ZCode

Настольный агент Z.ai: адрес и ключ Guard вводятся в окне настроек, файлы править не нужно.

Настроить через свою нейросеть
Протокол модели

Claude, Kimi, Composer и Grok

ZCode это настольное приложение с агентом от Z.ai для macOS, Windows и Linux (страница загрузки). Сторонний поставщик добавляется прямо в настройках: имя, адрес, ключ и список моделей. Guard подключается одним поставщиком сразу на все семейства.

  1. Откройте Settings (кнопка в левом нижнем углу), затем Model settings, Add provider, Custom endpoint.
  2. Name: Guard AI.
  3. Base URL: https://api.guardrelay.ai (без /v1: путь /v1/messages ZCode добавляет сам).
  4. API key: ваш ключ gd-… из бота.
  5. API format: Anthropic messages (/v1/messages).
  6. Add model: введите Model ID из списка ниже и окно контекста; в Advanced поставьте Max output tokens: 128000 для Claude Fable 5, Fable 5.1, Opus 5.5, Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 5.5, Sonnet 5, Sonnet 4.6 и Haiku 5.5; 64000 для Claude Opus 4.5, Sonnet 4.5 и Haiku 4.5; 128000 для Grok; 32000 для Composer; для Kimi оставьте поле пустым. Повторите для каждой нужной модели.
  7. Нажмите Add provider, включите переключатель поставщика и выберите модель в чате.

Идентификатор модели вводится точно как в списке: ZCode отправляет его на сервер без изменений. Окно контекста это бюджет, которым клиент считает историю чата. Max output tokens — предел одного ответа. Guard выполняет его до предела модели; если остатка на ключе не хватает на резерв под такой ответ с запасом ещё на 8 обычных запросов, Claude и Grok отвечают в пределах 32 000. Kimi получает значение как есть, а с пустым полем ZCode сам отправляет 32 000. ZCode вычитает этот предел из окна контекста, поэтому с большим пределом раньше сжимает историю.

Model IDОкно контекста
claude-sonnet-5-51M
claude-sonnet-51M
claude-opus-5-51M
claude-opus-51M
claude-fable-5-11M
claude-fable-51M
claude-opus-4-81M
claude-opus-4-71M
claude-opus-4-61M
claude-opus-4-5200K
claude-sonnet-4-61M
claude-sonnet-4-5200K
claude-haiku-5-51M
claude-haiku-4-5200K
Model IDОкно контекста
k31M
k3-256k256K
kimi-for-coding1M
kimi-for-coding-highspeed256K
Model IDОкно контекста
cursor-grok-4.7-low, cursor-grok-4.7-medium, cursor-grok-4.7-high, cursor-grok-4.7-xhigh256K
cursor-grok-4.7-low-fast, cursor-grok-4.7-medium-fast, cursor-grok-4.7-high-fast, cursor-grok-4.7-xhigh-fast256K · Fast
cursor-grok-4.6-low, cursor-grok-4.6-medium, cursor-grok-4.6-high, cursor-grok-4.6-xhigh500K
cursor-grok-4.6-low-fast, cursor-grok-4.6-medium-fast, cursor-grok-4.6-high-fast, cursor-grok-4.6-xhigh-fast500K
Model IDОкно контекста
composer-2.5200K
composer-2.5-fast200K

Поле Context window принимает число: для Claude 1M — 1000000, для Kimi K3 и K2.8 Preview (kimi-for-coding) — 1048576, для K3-256K и K2.7 Code HighSpeed — 262144, для Grok 4.7 — 256000, для Grok 4.6 — 500000, для Composer и Claude с окном 200K — 200000.

Режим контекста для Composer

Для composer-2.5 и composer-2.5-fast можно включить отдельный режим счётчика контекста. ZCode будет получать приблизительный размер текущей истории и видимого ответа: накопленный расход всего прогона больше не используется как размер одного окна.

  1. В Settings → Model settings откройте существующего поставщика Guard с форматом Anthropic messages.
  2. Измените только Base URL на https://api.guardrelay.ai/zcode и сохраните. Ключ и выбранную модель менять не нужно; /v1/messages ZCode добавит сам.
  3. Чтобы вернуть обычный учёт токенов в ответах API, восстановите Base URL https://api.guardrelay.ai.

Списания и тарифы не меняются: в личном кабинете учитывается фактический расход. Показатель контекста в ZCode в этом режиме — оценка, по нему нельзя рассчитывать стоимость запроса.

Для интеграций: запрос идёт на POST /zcode/v1/messages. Поле usage_source равно context_estimate, а usage содержит оценку. В завершённом ответе billing_usage содержит фактический общий расход прогона, как usage обычного адреса. На паузе для клиентского инструмента и до подтверждённого завершения billing_usage равно null.

Цены и подробности по каждой модели на странице Модели. У Grok уровень размышления выбирается именем модели (low, medium, high, xhigh), у Composer размышления нет: переключатель размышления в ZCode на эти модели не влияет.

Режим размышления, который ZCode включает по умолчанию, Guard приводит к тому, что принимает модель: у Sonnet 5.5, Opus 5.5 и Fable 5.1 размышление всегда адаптивное, у Haiku 5.5 включённое размышление становится адаптивным, у Haiku 4.5 и Sonnet 4.5 уровень усилия не применяется. Kimi принимает параметры размышления ZCode как есть.

Чтобы получить созданное Grok или Composer изображение, попросите модель сохранить его в рабочую папку. Поддержанные изображения выдаются в конце ответа ссылкой на скачивание на 24 часа; ссылка открывается без ключа. Автоматически созданные assets без такого сохранения не выдаются. Это выдача изображений, не произвольных файлов. Отдельной платы за файл нет, оплачиваются токены запроса.

GLM 5.3 в ZCode

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

Установите ZCode с официальной страницы. Откройте отдельную тестовую папку без секретов, затем Settings → Model settings.

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

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

Добавьте своего поставщика

  1. Нажмите Add provider → Create custom provider. В ZCode 3.14.3 созданная запись может называться New provider.
  2. В Base URL укажите https://api.guardrelay.ai/glm/v1, в API format выберите Responses (/responses), в API key вставьте gd-….
  3. Нажмите Add model, оставьте Smart configuration включённым и введите Model ID glm-5.3.
  4. Оставьте Context window и Max output tokens пустыми: проверенная конфигурация не задавала предполагаемый числовой предел. Сохраните модель и поставщика.
  5. При необходимости повторите Add model для glm-5.3-flash.
Поле ZCodeЗначение
ПоставщикNew provider
Base URLhttps://api.guardrelay.ai/glm/v1
API formatResponses (/responses)
API keygd-…
Model IDglm-5.3
Smart configurationвключено
Context window / Max output tokensоставить пустыми
Итоговый запросPOST https://api.guardrelay.ai/glm/v1/responses

Быстрая проверка и продолжение

  1. В новой беседе выберите glm-5.3 и откройте отдельную тестовую папку с README.md.
  2. Отправьте: Прочитай README.md и ответь ровно GUARD_GLM_OK. Ничего не меняй.
  3. В том же чате попросите назвать строку без повторного открытия файла. Новый чат создавайте только для отдельной задачи.

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

Model IDЧто использовать
glm-5.3Основная модель; текст и задачи с кодом.
glm-5.3-flashБыстрая модель; на уровне API принимает PNG и PDF во всех трёх протоколах, MP4 — только в Chat Completions.
  • Подтверждены Responses, локальные Read/Edit/Bash инструменты и продолжение того же ZCode-чата.
  • Инструменты чтения, правки и терминала исполняет сам клиент. Этот профиль не подключает инструменты или 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_foundModel 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Проверьте доступный баланс и незавершённые резервы в личном кабинете.
Кнопка Add provider выглядит иначеСверьте версию 3.14.3. В ней путь называется Add provider → Create custom provider; шаги 3.9.1 не переносите.
404 после сохраненияВыбран Responses (/responses), Base URL не содержит /responses, Smart configuration включён, Model ID точный.

Gemini в ZCode

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

Установите ZCode с официальной страницы. Откройте отдельную тестовую папку без секретов, затем Settings → Model settings.

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

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

Добавьте своего поставщика

  1. Нажмите Add provider → Create custom provider. Созданная запись может называться New provider.
  2. В Base URL укажите https://api.guardrelay.ai/v1, в API format выберите Responses (/responses), в API key вставьте gd-….
  3. Нажмите Add model, оставьте Smart configuration включённым и введите Model ID gemini-4-argon.
  4. Оставьте Context window и Max output tokens пустыми: числовые пределы подберёт сам ZCode. Сохраните модель и поставщика.
  5. При необходимости повторите Add model для остальных ID из таблицы ниже.
Поле ZCodeЗначение
ПоставщикNew provider
Base URLhttps://api.guardrelay.ai/v1
API formatResponses (/responses)
API keygd-…
Model IDgemini-4-argon
Smart configurationвключено
Context window / Max output tokensоставить пустыми
Итоговый запросPOST https://api.guardrelay.ai/v1/responses

Быстрая проверка и продолжение

  1. В новой беседе выберите gemini-4-argon и откройте отдельную тестовую папку с README.md.
  2. Отправьте: Прочитай README.md и ответь ровно GUARD_GEMINI_OK. Ничего не меняй.
  3. В том же чате попросите назвать строку без повторного открытия файла. Новый чат создавайте только для отдельной задачи.

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

Model IDВход и окно
gemini-4-argonТекст, изображения, PDF; окно 1 048 576 токенов, общее на вход и ответ.
gemini-3.8-flashТекст, изображения, PDF; окно 1 048 576 токенов на вход.
  • Локальные инструменты чтения, правки и команд исполняет сам ZCode; беседа продолжается в том же чате.
  • Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
  • Профиль использует OpenAI Responses. Серверный промпт — отдельная настройка семейства Gemini: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

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

ПризнакЧто проверить
401 invalid_api_keyКлиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент.
404 model_not_foundModel ID — точный ID из таблицы выше или короткое имя gemini; другие написания не поддерживаются.
404 или неверный путьBase URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /responses; не дописывайте его второй раз.
400 invalid_requestВыбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
402 insufficient_creditПроверьте доступный баланс и незавершённые резервы в личном кабинете.
Кнопка Add provider выглядит иначеШаги выше относятся к пути Add provider → Create custom provider. Если в вашей версии ZCode названия другие, найдите в ней те же поля: Base URL, API format, API key и Model ID.
404 после сохраненияВыбран Responses (/responses), Base URL не содержит /responses, Smart configuration включён, Model ID точный.

Muse в ZCode

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

Установите ZCode с официальной страницы. Откройте отдельную тестовую папку без секретов, затем Settings → Model settings.

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

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

Добавьте своего поставщика

  1. Нажмите Add provider → Create custom provider. Созданная запись может называться New provider.
  2. В Base URL укажите https://api.guardrelay.ai/v1, в API format выберите Responses (/responses), в API key вставьте gd-….
  3. Нажмите Add model, оставьте Smart configuration включённым и введите Model ID muse-wonder-1.0.
  4. Оставьте Context window и Max output tokens пустыми: числовые пределы подберёт сам ZCode. Сохраните модель и поставщика.
  5. При необходимости повторите Add model для остальных ID из таблицы ниже.
Поле ZCodeЗначение
ПоставщикNew provider
Base URLhttps://api.guardrelay.ai/v1
API formatResponses (/responses)
API keygd-…
Model IDmuse-wonder-1.0
Smart configurationвключено
Context window / Max output tokensоставить пустыми
Итоговый запросPOST https://api.guardrelay.ai/v1/responses

Быстрая проверка и продолжение

  1. В новой беседе выберите muse-wonder-1.0 и откройте отдельную тестовую папку с README.md.
  2. Отправьте: Прочитай README.md и ответь ровно GUARD_MUSE_OK. Ничего не меняй.
  3. В том же чате попросите назвать строку без повторного открытия файла. Новый чат создавайте только для отдельной задачи.

Модели и возможности 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 токенов.
  • Локальные инструменты чтения, правки и команд исполняет сам ZCode; беседа продолжается в том же чате.
  • Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
  • Профиль использует OpenAI Responses. Серверный промпт — отдельная настройка семейства Muse: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.

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

ПризнакЧто проверить
401 invalid_api_keyКлиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент.
404 model_not_foundModel ID — точный ID из таблицы выше или короткое имя muse; другие написания не поддерживаются.
404 или неверный путьBase URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /responses; не дописывайте его второй раз.
400 invalid_requestВыбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие.
402 insufficient_creditПроверьте доступный баланс и незавершённые резервы в личном кабинете.
Кнопка Add provider выглядит иначеШаги выше относятся к пути Add provider → Create custom provider. Если в вашей версии ZCode названия другие, найдите в ней те же поля: Base URL, API format, API key и Model ID.
404 после сохраненияВыбран Responses (/responses), Base URL не содержит /responses, Smart configuration включён, Model ID точный.

Codex в ZCode

Для ZCode 3.9.1.5853 используйте отдельного поставщика OpenAI Responses с exact gpt-6-astra. Ключ gd-… получите в боте Guard. Эта инструкция относится только к Responses/Astra; Chat, другие модели и другие версии ZCode ею не подтверждаются.

Для проверки можно использовать обычный чат без файлов: отправьте «Ответь: связь установлена». Чтобы проверить работу с проектом, создайте в Проводнике или Finder отдельную папку guard-test, откройте её в редакторе и создайте файл README.md с текстом «Это тестовый проект Guard». Дальнейший пример чтения относится к этой папке.

1. Добавьте адрес и ключ

  1. Откройте Settings → Model settings. Если настройки закрыты, нажмите название модели у поля ввода и выберите Manage Models.
  2. Нажмите Add provider → Custom endpoint. Не меняйте уже настроенного поставщика для Claude, Kimi, GLM, Gemini, Muse, Composer или Grok.
  3. В Name укажите GUARD API · Codex.
  4. В Base URL вставьте https://api.guardrelay.ai/codex/v1.
  5. В API key вставьте свой gd-… из бота; не добавляйте ключ в файл проекта или сообщение чата.
  6. В API format выберите Responses (/responses) и сохраните поставщика.

2. Добавьте GPT-модель

  1. Откройте созданного поставщика и нажмите Add model. Если эта кнопка появилась до сохранения поставщика, добавьте модель в той же форме.
  2. В Model ID укажите ровно gpt-6-astra, а для неё выберите OpenAI Responses. Другие доступные ID и уровни усилий — на странице Модели.
  3. Если ZCode показывает Thought Level, выберите Low для этого профиля Astra; не добавляйте effort к Model ID.
  4. В Context window укажите 272000. В Advanced → Max output tokens укажите 128000: Guard сохраняет max_output_tokens как advisory для managed Codex, но не обещает жёсткое обрезание ответа.
  5. Сохраните модель и включите переключатель поставщика.
Model IDContext window для ZCode
gpt-6-astra272000
gpt-6.1-sol872000
gpt-6-sol872000
gpt-6-luna872000
gpt-5.6-sol872000
gpt-5.6-terra872000
gpt-5.6-luna872000

Для доказанного профиля Astra используйте 272000. Остальные строки — только catalog budgets для настройки клиента и не являются проверкой этих моделей в ZCode. Автосжатие истории может сработать раньше; Context window не задаёт лимит одного ответа.

Поле ZCodeЗначение
Base URLhttps://api.guardrelay.ai/codex/v1
API formatResponses (/responses)
Model IDgpt-6-astra
Model API formatOpenAI Responses
Context window272000
Max output tokens128000 · advisory
Итоговый запросPOST https://api.guardrelay.ai/codex/v1/responses

Уровень размышления выбирайте только если ZCode показывает Thought Level у выбранной модели. Сверьте доступные значения с Моделями; не добавляйте effort к Model ID и не подменяйте модель. Если переключателя нет, оставьте настройку по умолчанию.

3. Первый ответ и продолжение

  1. Выберите тестовую рабочую папку без ключей и личных данных, где есть README.md. В новом чате оставьте режим Ask before changes, нажмите название модели у поля ввода и выберите GUARD API · Codex → gpt-6-astra.
  2. Отправьте: Прочитай README.md и объясни в двух предложениях, о чём этот тестовый проект. Ничего не меняй. Если ZCode попросит разрешение, разрешайте только чтение этого файла.
  3. После ответа в том же чате отправьте: Назови один факт из README.md, на котором основано объяснение. Для другой задачи начните новый чат.

После проверки чтения можно поручить изменение: «Добавь в README.md раздел Проверка и одну строку описания». Просмотрите предложенную правку и подтвердите её, если она соответствует задаче. Команды, доступ к файлам и инструменты разрешаются в самом клиенте; для подключения Guard не нужно заранее выдавать неограниченный доступ ко всему компьютеру.

Разделы

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