Свой API в ZCode: кастомный провайдер для Claude, GPT и китайских моделей (ноябрь 2026)
Да. По состоянию на 2026-11-10 официальная страница ZCode Connect Models говорит, что можно добавить своего провайдера, совместимого с протоколами Anthropic / OpenAI: в настольном приложении нажмите Manage Models внизу окна выбора модели, чтобы открыть Settings -> Model Settings, затем Add Provider внизу списка провайдеров, укажите эндпоинт и API-ключ и добавьте ID моделей через Add Model. Проверка на ZCode CLI 0.17.1 показала, что все три протокола QCode работают без входа в аккаунт Z.ai или BigModel: для Anthropic базовый URL — https://api.qcode.cc/api, для OpenAI Chat и Responses — https://api.qcode.cc/openai/v1, ключ — ваш QCode-ключ, начинающийся с cr_.
Обновлено 2026-11-10
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре главных факта: документация и проверка 2026-11-10
На CLI 0.17.1 работают все
По состоянию на 2026-11-10, проверено на ZCode CLI 0.17.1: anthropic-messages с https://api.qcode.cc/api (claude-haiku-5-5), openai-chat-completions и openai-responses — оба с https://api.qcode.cc/openai/v1 (deepseek-v4-flash, gpt-6.1-terra). Все три вернули ответ без входа в аккаунт Z.ai или BigModel.
Для Anthropic /v1 не нужен
В исходном коде ZCode к базовому URL Anthropic, который не заканчивается на /v1, дописывается /v1, а затем SDK добавляет /messages, поэтому запрос с https://api.qcode.cc/api уходит на /api/v1/messages. OpenAI Chat и Responses сразу дописывают /chat/completions или /responses, поэтому для них нужен https://api.qcode.cc/openai/v1.
У десктопа и CLI разные файлы настроек
Настольное приложение хранит провайдеров в ~/.zcode/v2/config.json, baseURL задаётся в options провайдера. CLI читает ~/.zcode/v2/provider_config.json (не config.json) и использует api.type и api.baseUrl; в официальной документации CLI сказано, что api.baseUrl пишется иначе, чем старый options.baseURL.
Последняя версия на 2026-11-10
Последний релиз на GitHub — v3.17.2: в README и журнале изменений указана дата 2026-11-03, релиз опубликован 2026-11-04 (UTC). Репозиторий zai-org/ZCode распространяется по лицензии Apache License 2.0, а CLI, собранный из его исходников, показывает версию 0.17.1.
Что такое ZCode и можно ли подключить свой API-ключ?
Да. По состоянию на 2026-11-10 официальная страница ZCode Connect Models говорит, что ZCode может добавить как своего провайдера любой сервис моделей, совместимый с протоколами Anthropic / OpenAI: публичные сервисы, каналы под управлением команды и сервисы, развёрнутые во внутренней сети. ZCode — открытая AI-среда для программирования от Z.ai (Zhipu): официальный FAQ называет её новой Agentic Development Environment (ADE) с собственным ZCode Agent в центре, а README — «AI-рабочим местом для программирования с настольным, браузерным и терминальным интерфейсами». Настольная версия работает на macOS (Apple Silicon / Intel), Windows (x64 / ARM64) и Linux (AppImage, DEB, RPM); версия для командной строки запускается командой zcode, zcode --web открывает веб-интерфейс, а CLI по документации репозитория собирается из исходников. На официальной странице перечислены три способа подключить модель: войти в аккаунт Z.ai или BigModel и напрямую использовать квоту его GLM Coding Plan; переключить страницу Z.ai / BigModel в режим API Key и ввести ключ этой платформы; добавить своего провайдера — тогда расход учитывает сервис, который вы указали. QCode подключается третьим способом.
v3.17.2 — последняя версия на 2026-11-10
По состоянию на 2026-11-10 последний релиз на GitHub — v3.17.2: README и журнал изменений датируют его 2026-11-03, а релиз на GitHub опубликован 2026-11-04 (UTC). В журнале изменений этой версии сказано, что повреждённые файлы конфигурации больше не перезаписываются, чтобы не терять данные. CLI, собранный из ветки main репозитория, показывает версию 0.17.1 — у него своя нумерация, не как у настольного приложения; именно эта сборка использовалась при проверке подключения к QCode 2026-11-10.
Хронология
Репозиторий zai-org/ZCode создан на GitHub.
Выпущена v3.17.2 (дата из README и журнала изменений; релиз на GitHub опубликован 2026-11-04 UTC).
Проверены официальная документация, README и Releases: v3.17.2 по-прежнему последняя. Проверка на ZCode CLI 0.17.1: протоколы Anthropic, OpenAI Chat и Responses в QCode работают.
Что написано в документации ZCode и что показали проверка и исходный код
Что описано в документации ZCode
① Свой провайдер в настольном приложении: откройте Settings -> Model Settings, нажмите Add Provider внизу списка провайдеров, задайте имя, укажите эндпоинт и API-ключ, вручную добавьте ID моделей через Add Model и включите переключатель. ② Официальный пример для DeepSeek: эндпоинт Anthropic https://api.deepseek.com/anthropic, эндпоинт OpenAI https://api.deepseek.com/v1. ③ В настольном файле ~/.zcode/v2/config.json options провайдера распознаёт только параметры подключения — apiKey, baseURL, apiKeyRequired, headers и подобные; прочие ключи, добавленные вручную, молча игнорируются и не попадают в тело запроса. ④ Документация CLI в репозитории: личные провайдеры задаются в ~/.zcode/v2/provider_config.json, типы API — openai-chat-completions, openai-responses и anthropic-messages, а api.baseUrl пишется иначе, чем старый options.baseURL. ⑤ Там же: ключ в этом файле хранится открытым текстом, поэтому ограничьте права доступа к нему и не коммитьте его в Git. ⑥ Некоторые сторонние развёртывания принимают уровень не выше xhigh, и на максимальном уровне размышления приходит ошибка параметра 400; помогает выбор high. ⑦ Одна и та же модель GLM сохраняет изображения на эндпоинте, совместимом с Anthropic, но на эндпоинте, совместимом с OpenAI Chat, считается не поддерживающей изображения. ⑧ После настройки выберите канал в окне выбора модели и отправьте короткую тестовую инструкцию.
Чего нет в документации — и что показали проверка и исходный код
По состоянию на 2026-11-10: ① Как формируется путь, в документации не сказано; в исходном коде ZCode к базовому URL Anthropic без /v1 на конце дописывается /v1, затем SDK добавляет /messages, а OpenAI Chat и Responses сразу дописывают /chat/completions или /responses, поэтому для QCode указывают https://api.qcode.cc/api и https://api.qcode.cc/openai/v1. ② Нужен ли сначала вход в аккаунт Z.ai или BigModel: проверка на ZCode CLI 0.17.1 показала, что достаточно личной настройки провайдера. ③ Responses: на странице настроек настольной версии перечислены протоколы Anthropic и OpenAI, отдельного пункта для Responses нет; тип openai-responses в CLI при проверке работает, адрес тот же — https://api.qcode.cc/openai/v1. ④ Как настольное приложение выбирает адрес, если у одного провайдера заданы и Anthropic, и OpenAI, официально по-прежнему не описано, поэтому понятнее всего завести по провайдеру на каждый протокол.
Десктоп и CLI: два входа и два файла настроек
Настольное приложение: провайдер через интерфейс
По официальной документации: Settings -> Model Settings → Add Provider. В эндпоинты Anthropic и OpenAI впишите те же адреса, что прошли проверку в CLI (https://api.qcode.cc/api и https://api.qcode.cc/openai/v1), затем добавьте ID моделей через Add Model. Настройки сохраняются в ~/.zcode/v2/config.json, где baseURL лежит в options провайдера.
CLI: файл provider_config.json
CLI читает ~/.zcode/v2/provider_config.json, а не config.json настольной версии. У каждого провайдера один api.type: anthropic-messages с https://api.qcode.cc/api либо openai-chat-completions / openai-responses с https://api.qcode.cc/openai/v1; ключ — в access.apiKey, модели — в personalModelIds. По состоянию на 2026-11-10 на ZCode CLI 0.17.1 работают все три.
Как подключить ZCode к QCode: шаги для десктопа и CLI
Настольное приложение: ① Установите ZCode с zcode.z.ai (на macOS перетащите ZCode.app в папку Applications, на Windows запустите установщик, на Linux используйте AppImage, DEB или RPM). ② Нажмите название модели в поле чата, затем Manage Models внизу списка — откроется Settings -> Model Settings. ③ Нажмите Add Provider внизу списка провайдеров, назовите его QCode Claude, укажите эндпоинт Anthropic https://api.qcode.cc/api, введите ключ, начинающийся с cr_, добавьте модели, например claude-sonnet-5-5, через Add Model и включите переключатель. ④ Создайте второго провайдера, QCode OpenAI, с эндпоинтом OpenAI https://api.qcode.cc/openai/v1 и моделями, например gpt-6.1-sol и deepseek-v4-flash. ⑤ Выберите модель в окне выбора модели и отправьте короткую тестовую инструкцию. CLI: в ~/.zcode/v2/provider_config.json добавьте провайдера в providerRules, впишите ключ cr_ в access.apiKey, задайте api.type anthropic-messages и api.baseUrl https://api.qcode.cc/api (или openai-chat-completions / openai-responses с https://api.qcode.cc/openai/v1), перечислите ID моделей в personalModelIds и укажите этого провайдера в defaultModelSelection. Ключ в файле хранится открытым текстом: ограничьте права доступа и не коммитьте файл в Git.
ZCode с API-ключом QCode
По состоянию на 2026-11-10 один API-ключ QCode даёт оба совместимых эндпоинта — Anthropic и OpenAI: модели Claude работают через эндпоинт Anthropic https://api.qcode.cc/api, модели GPT — через эндпоинт OpenAI https://api.qcode.cc/openai/v1 (один адрес для Chat и Responses), а семейства GLM, Kimi, DeepSeek и Qwen — через эндпоинт Anthropic или OpenAI Chat. Оплата по токенам, цены по моделям — на /models; частые ID моделей: claude-sonnet-5-5, claude-opus-5-5, gpt-6.1-sol, deepseek-v4-pro, glm-5.3, kimi-k3 и qwen3.8-max. Три шага: ① зарегистрируйтесь и пополните баланс (поддерживаются Alipay и другие основные способы оплаты); ② купите личный тариф или «Разовые пакеты» и скопируйте API-ключ, начинающийся с cr_; ③ добавьте провайдеров в ZCode, как описано выше; пошаговая инструкция есть в документации QCode: https://docs.qcode.cc/ru/docs/ide/zcode. Не хотите месячный тариф? «Разовые пакеты» (/pay-as-you-go) начинаются с $4: разовый объём, который нужно израсходовать за 7 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет.
Частые вопросы
Можно ли в ZCode использовать свой API-ключ?
Да. Официальная страница ZCode Connect Models говорит, что ZCode может добавить как своего провайдера любой сервис моделей, совместимый с протоколами Anthropic / OpenAI: Add Provider, эндпоинт и API-ключ, затем ручное добавление ID моделей через Add Model. По состоянию на 2026-11-10 проверка на ZCode CLI 0.17.1 показала, что все три протокола QCode работают сразу: для Anthropic — https://api.qcode.cc/api, для OpenAI Chat и Responses — https://api.qcode.cc/openai/v1, ключ — ваш QCode-ключ, начинающийся с cr_. Оплата по токенам, цены по моделям — на /models.
Где в ZCode настроить кастомную модель?
Настольное приложение: нажмите название модели в поле чата, затем Manage Models внизу окна выбора модели — откроется Settings -> Model Settings; там нажмите Add Provider внизу списка провайдеров. При первом запуске без рабочей модели к настройкам моделей ведёт и кнопка Use API Key на экране приветствия. CLI: правьте ~/.zcode/v2/provider_config.json, а не ~/.zcode/v2/config.json настольной версии, и пишите адрес в api.baseUrl, а не в options.baseURL. В официальной документации CLI также сказано, что ZCODE_BASE_URL связан с сервисным эндпоинтом самого продукта, поэтому адрес API модели туда не вписывают.
Можно ли в ZCode использовать Claude?
Свой провайдер в ZCode поддерживает протокол Anthropic, поэтому можно указать базовый URL Anthropic от QCode https://api.qcode.cc/api и вызывать модели Claude; по состоянию на 2026-11-10 при проверке на ZCode CLI 0.17.1 claude-haiku-5-5 сразу ответила, а claude-sonnet-5-5 и claude-opus-5-5 тоже есть на /models. Модели Claude доступны только по этому адресу; модели GPT используют базовый URL OpenAI https://api.qcode.cc/openai/v1.
Нужен ли /v1 в базовом URL ZCode?
Для Anthropic — нет, для OpenAI — да. Исходный код ZCode дописывает /v1 к базовому URL Anthropic, если его там нет, а затем SDK добавляет /messages, поэтому указывайте https://api.qcode.cc/api (по исходному коду адрес https://api.qcode.cc/api/v1 приведёт на тот же /api/v1/messages). OpenAI Chat и Responses сразу дописывают /chat/completions или /responses, поэтому указывайте https://api.qcode.cc/openai/v1. По состоянию на 2026-11-10 все три варианта прошли проверку на ZCode CLI 0.17.1; завершающий слеш не ставьте.
Поддерживает ли ZCode Responses или Gemini?
CLI поддерживает Responses: задайте api.type openai-responses и api.baseUrl https://api.qcode.cc/openai/v1 — по состоянию на 2026-11-10 это работает на ZCode CLI 0.17.1 (gpt-6.1-terra). На странице настроек настольной версии перечислены протоколы Anthropic и OpenAI без отдельного пункта для Responses; для моделей GPT в настольном приложении указывайте эндпоинт OpenAI https://api.qcode.cc/openai/v1. Среди типов API в документации ZCode нет Gemini; в QCode доступны Claude, GPT и семейства GLM, Kimi, DeepSeek и Qwen, ID моделей — на /models.
ZCode с QCode выдаёт 400 или 404: что делать?
Смотрите на текст ошибки. model_not_available_on_endpoint: модель Claude добавлена к провайдеру с адресом OpenAI — перенесите модели claude-… к провайдеру с адресом https://api.qcode.cc/api. Ошибка параметра 400 на максимальном уровне размышления: по документации, некоторые сторонние развёртывания принимают уровень не выше xhigh, выберите high. 404: частая причина — завершающий слеш, из-за которого путь превращается в //v1/messages; вводите /api и /openai/v1 точно как выше. Пропадают изображения: в официальном примере одна и та же модель GLM сохраняет изображения на эндпоинте, совместимом с Anthropic, но на эндпоинте, совместимом с OpenAI Chat, считается не поддерживающей их; для своей модели явно укажите поддержку изображений в её настройках.
Источники
ZCode: страницы Connect Models, установки и FAQ, а также журнал изменений на zcode.z.ai; страница ZCode на docs.bigmodel.cn; README, LICENSE, руководство по CLI и документ о его настройке, функция normalizeAnthropicBaseURL в исходном коде, данные репозитория и Releases zai-org/ZCode на GitHub — всё прочитано 2026-11-10. Проверка: 2026-11-10, ZCode CLI 0.17.1, собранный из исходников репозитория. QCode: qcode.cc/models, qcode.cc/pricing, qcode.cc/pay-as-you-go и страница Endpoints & API Paths на docs.qcode.cc, получены 2026-11-10.
Запустите ZCode со своим ключом
Один API-ключ QCode — в своего провайдера ZCode: эндпоинт Anthropic для Claude, эндпоинт OpenAI для GPT, китайские модели — через любой; оплата по токенам, цены по моделям — на /models.
Читайте также
Разовые пакеты
Разовая квота на 7 дней без подписки; новые пакеты добавляются к тому же ключу
Китайские модели в Claude Code: настройка
Один ключ cr_ для DeepSeek, GLM, Kimi и Qwen в Claude Code: адрес тот же, переключение через /model.
Свои модели в Trae: руководство
Как заполнить свою модель в Trae: формат API, URL запроса, ID модели и API-ключ, ограничение режима Auto и частые ошибки.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Утверждения на этой странице проверены 2026-11-10 по документации, репозиторию и исходному коду ZCode, адреса QCode проверены на ZCode CLI 0.17.1; приоритет у официальных страниц. Названия меню и параметры зависят от установленной версии, доступность моделей QCode — по /models.