🎯 О чём этот конспект: Подробный разбор Zcode — бесплатного десктопного приложения, которое объединяет в себе мощные CLI-агенты (Claude Code, Gemini CLI, Codex) в едином графическом интерфейсе. Инструмент позволяет управлять проектами, переключаться между LLM-провайдерами и использовать MCP-серверы без необходимости постоянно работать в терминале.

👤 Кому будет полезно: Вайбкодерам, разработчикам и AI-энтузиастам, которые хотят использовать продвинутые возможности Claude Code и других агентов с удобством полноценной IDE (файловый менеджер, встроенный браузер, визуальный контроль правок).

✨ Что получите: Вы научитесь настраивать Zcode, подключать различных провайдеров (OpenRouter, ZI), использовать готовых агентов для ревью кода и бесшовно переключаться между разными AI-движками в рамках одного проекта.

1. Zcode как визуальная оболочка для AI-агентов

Контекст: Zcode — это не просто очередной чат-бот, а полноценный "враппер" (оболочка) над популярными CLI-инструментами разработки. Основная проблема CLI-агентов вроде Claude Code — сложность визуализации изменений в больших проектах и управления контекстом. Zcode решает это, предоставляя интерфейс, похожий на VS Code, где терминал, дерево файлов и окно чата с агентом интегрированы в единое рабочее пространство. Это позволяет "вайбкодить" быстрее, видя все изменения в реальном времени.

Выгода: Упрощение рабочего процесса, наглядный контроль Diff-ов (разницы в коде) и доступ к мощным агентам без глубоких знаний командной строки.

Как применить:

• Шаг 1: Установка — Скачайте версию для вашей ОС (Mac OS или Windows) с официального сайта zcode-ai.com.
• Шаг 2: Авторизация — При первом запуске войдите через аккаунт GLM (ZAI) для доступа к базовым моделям.
• Шаг 3: Подключение проектов — Откройте существующую папку с кодом через "Open Project". Zcode просканирует структуру и подготовит контекст для агентов.

2. Гибкая настройка провайдеров и моделей

Контекст: Одной из ключевых фишек Zcode является поддержка множества провайдеров через единый интерфейс настроек. Вы не ограничены одной моделью: можно использовать родные модели GLM, подключить OpenRouter для доступа к Claude 3.5 Sonnet или GPT-4o, а также настроить Gemini CLI. Это дает свободу выбора инструмента под конкретную задачу (например, дешевая модель для простых правок и мощная — для архитектуры).

Выгода: Экономия на токенах за счет использования бесплатных моделей (например, Step 3.5 через OpenRouter) и отсутствие привязки к одному вендору.

Как применить:

• Шаг 1: Настройка Agent Settings — Перейдите в раздел настроек агента (шестеренка).
• Шаг 2: Добавление провайдера — В секции провайдеров выберите "OpenRouter" или "Custom".
• Шаг 3: Ввод API-ключа — Вставьте ваш ключ и выберите нужную модель (например, step-3.5-free).
• Шаг 4: Конфигурация Claude Code — В настройках Claude Code укажите, каких агентов и скиллы (skills) вы хотите активировать.

3. Работа с агентами и MCP-серверами

Контекст: Zcode поддерживает концепцию специализированных агентов (Code Reviewer, UI Skeleton Planner) и протокол MCP (Model Context Protocol). Это позволяет расширять возможности AI: давать ему доступ к поиску в вебе, памяти (через .md файлы) и специфическим инструментам разработки. Вы можете буквально "на лету" подключать новые навыки к вашему AI-помощнику.

Выгода: Автоматизация рутинных процессов (ревью, написание тестов) и расширение контекста модели за пределы простого чтения файлов.

Как применить:

• Шаг 1: Активация MCP — В настройках перейдите в раздел MCP и включите нужные серверы (например, Google Search или Fetch).
• Шаг 2: Выбор агента — При создании новой задачи (New Task) выберите роль, например Code Reviewer.
• Шаг 3: Использование памяти — Создайте файл cloud-code.md для хранения долгосрочного контекста проекта, который агент будет учитывать при каждой итерации.

4. Визуальное редактирование и встроенный браузер

Контекст: В отличие от работы в обычном терминале, Zcode предоставляет встроенный браузер для моментального превью веб-приложений и удобный интерфейс подтверждения правок. Когда агент предлагает изменения, вы видите их в формате Side-by-Side Diff (было/стало). Вы можете принять все правки одной кнопкой Always Allow или отклонить сомнительные куски кода.

Выгода: Сокращение цикла "написал код — проверил результат" и минимизация ошибок при автоматическом редактировании файлов.

Как применить:

• Шаг 1: Запуск задачи — Введите промпт, например:

Modify the header to be nicer, add a gradient text and improve mobile responsiveness.

• Шаг 2: Контроль Diff — После генерации кода просмотрите изменения в окне сравнения.
• Шаг 3: Проверка в браузере — Переключитесь на вкладку "Browser" внутри Zcode. Если агент запустил npm run dev, вы увидите результат изменений прямо в приложении. Можно менять разрешение (Mobile/Tablet/Desktop) для проверки адаптивности.

5. Мультизадачность и переключение между сессиями

Контекст: Zcode позволяет запускать несколько задач параллельно, используя разные движки. Например, одна задача может выполнять ревью кода через Claude Code, а вторая — генерировать футер через Codex. Это реализовано через систему вкладок или сессий, что удобно для больших проектов, где нужно делать несколько дел одновременно.

Выгода: Повышение продуктивности за счет параллельной работы AI-агентов.

Как применить:

• Шаг 1: Создание параллельной задачи — Пока работает одна задача, нажмите "New Task".
• Шаг 2: Смена движка — Выберите другой инструмент (например, переключитесь с Claude Code на Codex).
• Шаг 3: Мониторинг логов — Используйте вкладку "Logs", чтобы видеть, какая модель используется в данный момент и на каком этапе находится выполнение задачи.

FAQ

В: Является ли Zcode полностью бесплатным?

О: Само приложение Zcode бесплатно. Однако использование моделей (Claude, GPT, Gemini) зависит от ваших API-ключей или лимитов соответствующих провайдеров. В приложении можно использовать бесплатные модели через OpenRouter (например, Step 1).

В: Можно ли использовать Zcode без установки Claude Code CLI?

О: Zcode выступает как оболочка. Для полноценной работы функций Claude Code или Gemini CLI они должны быть установлены в системе или настроены внутри приложения как исполняемые агенты.

В: Как Zcode работает с безопасностью кода?

О: В настройках есть "Permission Mode". Вы можете выбрать "Always Accept" для полной автоматизации или режим подтверждения каждой правки, что безопаснее для критически важных проектов.

В: Поддерживает ли Zcode кастомные MCP серверы?

О: Да, в разделе настроек MCP можно добавить любой сторонний сервер, указав команду запуска и необходимые аргументы. Это позволяет интегрировать специфические инструменты вашей компании.

В: Что делать, если интерфейс Zcode завис при генерации?

О: Инструмент находится на ранней стадии разработки. Если UI перестал реагировать (особенно при изменении размера окна), рекомендуется перезапустить приложение. Ваши сессии и файлы проекта при этом сохраняются.

Конспект создан на основе видео «Zcode - A desktop environment for Claude Code, Gemini CLI, Codex and more» канала Drago. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=pzIARgn-bQw