Что такое ZCode
ZCode — самостоятельная десктопная среда агентной разработки (Agentic Development Environment, ADE) от компании Z.ai (международное подразделение Zhipu AI). Это не очередное расширение для VS Code и не форк популярной IDE — приложение спроектировано с нуля для работы ИИ-агента и доступно для macOS, Windows и Linux.
В отличие от инструментов вроде Cursor, Cline или Claude Code, где ИИ выступает помощником программиста, в ZCode центральная роль отдана автономному агенту. Пользователь формулирует высокую цель на естественном языке, а агент сам планирует последовательность действий, правит файлы, запускает команды в терминале, проверяет результаты и итерирует до достижения цели.
Требования
- macOS, Windows или Linux
- Приложение ZCode с официального сайта
- Аккаунт LLMost с API-ключом (или собственный API-ключ совместимого провайдера)
Установка
- Скачайте и установите ZCode с zcode.z.ai.
- Запустите приложение и пройдите первичную настройку.
- Создайте ключ на странице Ключи API (формат
llmost_...).
Подключение LLMost
ZCode позволяет подключить любую модель через OpenAI-совместимый endpoint. Чтобы заставить агента работать на моделях каталога LLMost:
-
В настройках ZCode найдите раздел подключения модели / провайдера.
-
Выберите тип провайдера Create custom provider (или «Кастомный провайдер»).
-
Заполните поля:
- Base URL:
https://llmost.ru/api/v1 - API Key: ваш ключ
llmost_... - Модель: укажите модель из каталога LLMost, например
openai/gpt-6.1-terra-pro-20261026
- Base URL:
-
Сохраните настройки — агент готов к работе.
Если ZCode подтягивает список моделей автоматически, убедитесь, что Base URL указан ровно как https://llmost.ru/api/v1 (без /chat/completions на конце).
Выбор модели
Для агентной работы модель обязана поддерживать tool calling — без него агент не сможет править файлы и запускать команды. Хорошие варианты из каталога LLMost:
~anthropic/claude-sonnet-latest— лучший выбор для агентного кодинга, контекст 1 млн токенов;~openai/gpt-latest— универсальная флагманская альтернатива;deepseek/deepseek-v3.2-20251201— бюджетный вариант для простых задач.
Алиасы, начинающиеся с ~, всегда указывают на актуальную версию модели. Полный список с ценами — в каталоге моделей LLMost.
Уровни автономии и мышления
ZCode предлагает четыре уровня автономии агента, которые регулируют, как часто приложение запрашивает ваше подтверждение:
- «Запросить перед изменениями» (по умолчанию) — агент спрашивает разрешение перед каждым изменением.
- «Изменять автоматически» — агент применяет правки без запроса, но требует подтверждения для запуска команд.
- «Режим планирования» — агент показывает только план действий, не выполняя его.
- «Полный доступ» — минимальное количество прерываний.
Также доступен «Уровень мышления» — регулирует глубину рассуждений модели: «низкий» для простых вопросов, «высокий» для повседневных задач, «максимальный» для сложных инженерных задач с глубоким анализом.
Проверка
Создайте новую задачу в ZCode и дайте agentes простую цель, например: «Создай файл hello.txt с текстом "Привет"». Агент должен самостоятельно составить план, создать файл и подтвердить выполнение — значит, подключение к LLMost работает.
Чтобы проверить endpoint в обход ZCode, выполните запрос напрямую:
curl https://llmost.ru/api/v1/chat/completions \
-H "Authorization: Bearer llmost_..." \
-H "Content-Type: application/json" \
-d '{
"model": "~google/gemini-flash-latest",
"messages": [{"role": "user", "content": "Привет!"}]
}'Частые проблемы
Агент не выполняет действия — отвечает только текстом. Выбранная модель не поддерживает tool calling — смените её на одну из рекомендованных выше.
Ошибка 401. Ключ скопирован не полностью или удалён. Создайте новый на странице Ключи API.
Ошибка 402 «Недостаточно средств». Автономный агент расходует много токенов — проверьте баланс и пополните его.
Список моделей не подтянулся. Проверьте, что Base URL — ровно https://llmost.ru/api/v1, без /chat/completions на конце.
Ссылки
- Официальный сайт: zcode.z.ai
- GitHub: ZCode
- Другие приложения — в каталоге ИИ-агентов