ZCode

ZCode — среда для программирования с AI-агентом от Z.ai, создателей моделей GLM. Есть настольное приложение для Windows и macOS и агент для терминала. Кроме своих моделей, ZCode принимает любой OpenAI-совместимый сервис как «свой провайдер», поэтому через Hubris в нём работают GLM, DeepSeek, Claude, GPT и остальные модели каталога. Аккаунт Z.ai для этого не нужен.

Требования

• Windows (x64) или macOS (Apple Silicon)
• Аккаунт на hubris.pw и API-ключ из раздела Ключи

Установка

Скачайте установщик со страницы выпусков ZCode на GitHub: ZCode-<версия>-win-x64.exe для Windows или ZCode-<версия>-mac-arm64.dmg для macOS. Установщик для Windows подписан компанией Zhipu.

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

Шаги в приложении — по документации ZCode, раздел Custom Providers:

1. Откройте панель Model Settings (выбор модели в окне чата или Settings → Model Providers).
2. Внизу списка провайдеров нажмите Add Provider.
3. Назовите провайдера Hubris.
4. В поле адреса OpenAI укажите https://api.hubris.pw/v1.
5. В поле API Key вставьте ключ Hubris (sk-gw-...).
6. Нажмите Add Model и введите ID моделей из каталога, по одному, вместе с префиксом разработчика: например z-ai/glm-5.3, deepseek/deepseek-v4.1-flash, anthropic/claude-sonnet-5.
7. Включите переключатель провайдера и сохраните.

После этого модели Hubris появятся в выборе модели в окне чата. Отправьте короткую задачу, например «Ответь одним словом: ок», и проверьте ответ.

Агент в терминале

Вместе с приложением ставится агент для терминала: resources/glm/zcode.cjs в папке установки. Он читает своих провайдеров из файла ~/.zcode/cli/config.json (на Windows %USERPROFILE%\.zcode\cli\config.json):

{
  "provider": {
    "hubris": {
      "kind": "openai-compatible",
      "name": "Hubris",
      "options": {
        "baseURL": "https://api.hubris.pw/v1",
        "apiKey": "sk-gw-..."
      },
      "models": {
        "z-ai/glm-5.3": { "name": "GLM-5.3", "tool_call": true },
        "deepseek/deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash", "tool_call": true }
      }
    }
  },
  "model": "hubris/deepseek/deepseek-v4.1-flash"
}

model задаётся как <провайдер>/<ID модели>: hubris/ и дальше ID из каталога. Разовую задачу агенту можно дать флагом -p, например -p "Создай файл notes.txt со строкой: привет".

Рекомендуемые модели

Одна задача агента складывается из нескольких запросов к модели. Первый запрос в сессии самый дорогой: ZCode отправляет модели свои инструкции и описание инструментов. Каждый запрос с ценой виден в разделе Расходы.

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

«Select a model before continuing»

• Модель не выбрана. В приложении выберите модель Hubris в окне чата. Для агента в терминале задайте model в config.json в виде hubris/<ID модели>.

401 или «Неверный API-ключ»

• Проверьте, что ключ начинается с sk-gw- и скопирован целиком, без пробелов.

Модель не найдена

• ID модели должен совпадать с каталогом символ в символ, вместе с префиксом разработчика: z-ai/glm-5.3, а не glm-5.3.

Что дальше

• Каталог моделей — ID и цены всех моделей.
• Управление API-ключами — отдельный ключ с лимитом под ZCode.
• Расходы — стоимость каждого запроса агента.
• OpenCode и Codex CLI — терминальные агенты с тем же подключением.

Обновлено: 28 сентября 2026 г.