Перейти к содержимому
EN

ZCode

ZCode — агентная среда (десктоп-приложение Z.ai) для работы с моделями. Кастомный провайдер в ней понимает OpenAI- и Anthropic-совместимые протоколы — Mixen говорит на обоих, поэтому каталог подключается целиком: текст, Claude- и GPT-семейства, Sonar с веб-поиском.

Готовые сборки — на zcode.z.ai: .dmg (macOS), .exe (Windows), .deb/.rpm/.AppImage (Linux, beta). Подписка GLM Coding Plan для своего провайдера не нужна — расход идёт с баланса Mixen.

Model Settings → Add Provider внизу списка слева:

  1. Имя провайдера — например mixen.
  2. OpenAI endpoint: https://api.mixen.ai/v1 — основные модели, /chat/completions и /v1/models.
  3. Anthropic endpoint (для Claude-семейства и Anthropic-протокола): https://api.mixen.ai — путь /v1/messages клиент допишет сам, сегмент /v1 в это поле добавлять не нужно.
  4. API Key: ваш ключ mxn-… из кабинета.
  5. Add Model — добавьте модели по одной, точным id из каталога: GET /v1/models или каталог на сайте. Примеры: z-ai/glm-5.3 — родная для ZCode топ-модель, далее z-ai/glm-5.3-flash, openai/gpt-5.6-sol, anthropic/claude-sonnet-5.
  6. Включите тумблер провайдера.

Оба эндпоинта можно задать одному провайдеру одновременно — как в примере DeepSeek из документации ZCode.

  • Биллинг и лимиты — общие для ключа: баланс и история в тех же GET /v1/balance и GET /v1/history.
  • Reasoning: в options провайдера ZCode принимает только настройки соединения (apiKey, baseURL, headers) — остальные ключи, включая reasoning_effort, молча игнорируются. Глубина рассуждения задаётся в каталоге по умолчанию модели.
  • Модели — добавляются вручную по id; несуществующий id даст ошибку на первом запросе. Сверяйте точные имена в GET /v1/models (суффиксы вроде -preview — часть имени).
  • Прокси: ZCode не читает системные HTTP_PROXY/HTTPS_PROXY — если нужен, задайте его в настройках самого ZCode.

Ошибки приходят в формате соответствующего протокола: OpenAI-эндпоинт — {"error": {"message", "code"}}, Anthropic — {"type": "error", "error": {...}}. Частые: 401 — ключ не введён/отозван; 402 — на аккаунте не было пополнений или баланс исчерпан; 429 — лимит запросов ключа (ключи и лимиты).