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 внизу списка слева:
- Имя провайдера — например
mixen. - OpenAI endpoint:
https://api.mixen.ai/v1— основные модели,/chat/completionsи/v1/models. - Anthropic endpoint (для Claude-семейства и Anthropic-протокола):
https://api.mixen.ai— путь/v1/messagesклиент допишет сам, сегмент/v1в это поле добавлять не нужно. - API Key: ваш ключ
mxn-…из кабинета. - 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. - Включите тумблер провайдера.
Оба эндпоинта можно задать одному провайдеру одновременно — как в примере 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 — лимит запросов ключа (ключи и лимиты).