Руководство по агентам Flaq AI

Практическое руководство по использованию ZCode с API-сервисами Flaq AI

Подключите настольную среду программирования с ИИ ZCode к OpenAI-совместимому API Flaq AI, а затем используйте модели GLM 5.2, Kimi K3 или DeepSeek v4 для вопросов о репозитории и задач программирования. В этом руководстве описаны загрузка ZCode с официального сайта, настройка собственного провайдера, выбор модели и простая проверка рабочего пространства.

Установка

Установка ZCode

Скачайте официальное настольное приложение ZCode для macOS, Windows или Linux, установите его стандартным для вашей системы способом и при первом запуске выберите каталог проекта. Сейчас наряду с версиями для macOS и Windows ZCode предоставляет AppImage для Linux x64.

1

Скачивание ZCode

Откройте официальную страницу установки и выберите пакет, соответствующий вашей операционной системе и архитектуре.

Выберите файл .dmg для Apple Silicon или Intel, перетащите ZCode в папку Applications и откройте приложение из Launchpad.

Скачивание ZCode для macOS

https://zcode.z.ai/en/docs/install

Настройка

Подключение ZCode к Flaq AI

Откройте настройки моделей ZCode, добавьте Flaq AI как стороннего провайдера по протоколу OpenAI, введите свой API-ключ Flaq и вручную добавьте идентификатор выбранной модели. Через собственных провайдеров ZCode может использовать совместимые модельные сервисы, даже если их нет во встроенном списке провайдеров.

Рекомендуемая модель по умолчанию для программирования в ZCode, многоэтапных задач с репозиторием, планирования и анализа кода.

Нажмите название модели в окне чата ZCode, выберите Manage Models и откройте Settings → Model Settings. Нажмите Add Provider, выберите протокол OpenAI, введите приведённые ниже настройки Flaq и включите провайдера. Если список моделей не загрузится автоматически, нажмите Add Model и вручную введите идентификатор выбранной модели.

  • Используйте точный базовый URL API Flaq и замените заполнитель своим API-ключом Flaq.
  • Оставьте идентификатор выбранной модели в точности в указанном виде.

Настройки провайдера Flaq AI

Provider name: Flaq AIProtocol: OpenAIAPI base URL: https://api.flaq.ai/api/v1API key: Your_Flaq_Api_KeyModel ID: glm-5.2-text-to-textEnable provider: On

Проверка

Проверка Flaq в ZCode

Выберите настроенную модель Flaq в списке моделей, откройте каталог проекта как текущее рабочее пространство, запустите новый сеанс ZCode Agent и сначала отправьте задачу для репозитория, доступную только для чтения.

Используйте этот запрос, чтобы проверить, что выбранная модель отвечает с учётом информации из текущего рабочего пространства, не запрашивая изменений файлов.

Проверка доступа к проекту

List the files in this project and summarize its main purpose. Do not modify any files.

Официальный сайт

Официальный сайт ZCode

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

Официальный сайт ZCode

Откройте официальный сайт ZCode, чтобы скачать приложение и ознакомиться с актуальным порядком настройки для macOS, Windows и Linux.

Устранение неполадок

Часто задаваемые вопросы о ZCode

Использование этой настройки из руководства может значительно увеличить расход токенов.