Codex и GLM: подключение Z.AI и проверка провайдера

GLM можно подключить к Codex через отдельного провайдера Z.AI: нужны подходящий GLM Coding Plan, его ключ и настройки для протокола Responses. Сначала сохраните конфигурацию, затем настройте провайдера и подтвердите маршрут запросов тестом. Специальный гайд Z.AI для Codex описывает CLI и настольное приложение; наличие всех возможностей приложения с чужой моделью эта инструкция не гарантирует.

Что меняется при подключении

Codex остаётся рабочим инструментом, а модель и поставщик ответов меняются. Это не установка GLM локально и не добавление модели в подписку ChatGPT. GLM Coding Plan является отдельным пакетом Z.AI для поддерживаемых инструментов, как указано в официальном описании плана.

Если вы выбираете первую рабочую среду, основной путь начинается с настольного приложения Codex. Перенастраивать провайдера стоит под ясную потребность, а не ради нового названия. Ниже настройку удобно проверять в CLI: там проще отделить рабочую конфигурацию от состояния уже открытого окна.

Подключение считайте подтверждённым, когда совпадают настройки провайдера и учёт тестового расхода в его кабинете. Фраза модели о собственном названии не доказывает, кто обработал запрос.

Проверьте доступ и отдельный план до настройки

Убедитесь, что Z.AI разрешает обслуживание вашего аккаунта и предлагает нужный план. В проверенных публичных руководствах нет полного списка стран, позволяющего обещать доступ из России. Эта статья не подтверждает регистрацию, оплату или обслуживание в любом регионе. Если кабинет отказывает по условиям доступа, не продолжайте настройку и не оплачивайте услугу через неизвестного посредника.

• Codex уже запускается с прежними настройками, и вы знаете способ возвращения к ним.
• В кабинете Z.AI виден подходящий активный Coding Plan и доступная квота.
• Ключ получен именно для этого плана; корпоративный ключ не подменён обычным ключом API.
• Политика проекта разрешает передавать код выбранному провайдеру.
• Первая задача будет выполняться на синтетическом тексте или копии проекта без секретов.
• Состояние конфигурации сохранено до запуска мастера.

Z.AI различает ключи индивидуального и командного плана; командный ключ не взаимозаменяем с другими ключами. Это уточнение приведено в специальной инструкции подключения. Для настройки используйте предусмотренное поле мастера или защищённое хранилище. Ключ не должен попадать в обычный запрос модели, снимок экрана или общий журнал.

Сохраните исходную конфигурацию

Откройте папку настроек Codex (~/.codex/ на macOS/Linux или %USERPROFILE%\.codex\ на Windows) и сделайте отдельные копии существующих config.toml и models.json, если второй файл уже есть. Назовите копии так, чтобы их не спутать с действующими файлами. Если какого-то файла нет, зафиксируйте это: при возврате не следует создавать случайную пустую замену.

Не выгружайте копии в общий репозиторий или облачный разговор. Конфигурация может содержать данные доступа. Сохраните также сведения о выбранном провайдере и модели без секретов.

Подключение через провайдера отличается от запуска промежуточного роутера. Такой маршрут разобран в статье про Kimi в Codex. Не смешивайте инструкции: адрес сервиса, формат запросов и способ входа должны соответствовать одному выбранному пути.

По теме: Kimi в Codex: подключение через API и локальный роутер

Настройте Codex официальным мастером Z.AI

Z.AI предоставляет Coding Tool Helper с поддержкой Codex. Для запуска требуется Node.js версии 18 или новее; мастер вызывается командой npx @z_ai/coding-helper. Список инструментов и порядок выбора плана, ключа и инструмента описаны в справке Coding Tool Helper. Проверьте название пакета перед запуском: загрузка и выполнение программы должны быть осознанными.

node --version
codex --version
npx @z_ai/coding-helper

1. Проверьте версии Node.js и Codex. Если CLI ещё не установлен, сначала завершите официальную установку и обычный вход, не меняя одновременно все компоненты.
2. Запустите мастер после сохранения конфигурации.
3. Выберите свой тип Coding Plan и введите ключ в предусмотренное поле.
4. В списке инструментов выберите Codex. Другие программы подключайте только при отдельной потребности.
5. Разрешите загрузить настройки плана в Codex. Для первой проверки не добавляйте необязательные MCP-сервисы.
6. Завершите мастер, закройте прежнюю сессию и откройте новую.
7. Сверьте созданные настройки с актуальным специальным руководством Z.AI, затем выполните тест без изменений файлов.

Не следуйте совету безусловно заменить весь файл конфигурации готовым фрагментом. В нём могут быть настройки ваших проектов и других провайдеров. Если мастер собирается перезаписать их, остановитесь, сравните изменение с сохранённой копией и выберите настройку, которая сохраняет нужные разделы.

Как проверить маршрут и расход

Специальный гайд Codex указывает адрес Responses на api.z.ai с путём /api/v1, провайдера ZAI, протокол wire_api = "responses" и каталог моделей models.json. В опубликованном примере используется glm-5.3. Не заменяйте адрес типовым endpoint из инструкции для другого инструмента. Конфигурация провайдеров на стороне Codex описана также в расширенных настройках OpenAI.

1. Проверьте только несекретные поля: провайдер, модель, адрес, протокол и путь к каталогу. Не выводите значение ключа.
2. Перед тестом запишите состояние расхода в кабинете Z.AI. На время проверки не запускайте другие задачи этого плана.
3. Откройте новую сессию Codex в пустой тестовой папке.
4. Попросите объяснить небольшой синтетический текст без команд, изменения файлов и внешних действий.
5. Проверьте итог и состояние провайдера в сессии.
6. Сверьте учёт расхода в кабинете с этим тестом. Если запись ещё не появилась, не делайте вывод о маршруте по одному ответу.
7. Только после подтверждения попробуйте небольшую обратимую задачу в копии проекта.

Объясните, какие поля нужны карточке тестового товара: название и доступность.
Не читайте другие папки, не запускайте команды и не изменяйте файлы.
Не подключайте инструменты и внешние сервисы.
Не делайте вывод о своём провайдере из текста задания.

У Coding Plan есть собственные ограничения и общий расход поддерживаемых инструментов. Условия использования и просмотр квоты описаны в FAQ Z.AI. Если расход появился в неожиданном месте, приостановите тест и выясните тип ключа, план и endpoint. Не добивайте настройку повторными платными запросами вслепую.

По теме: Codex Micro: что это за контроллер и как его настроить

Диагностика по этапу сбоя

• Мастер не запускается: проверьте Node.js, соединение и точное имя пакета. Не запускайте терминал с повышенными правами как первый способ исправления.
• Ключ отклонён: проверьте соответствие индивидуальному или командному плану и состояние аккаунта в кабинете. Не печатайте ключ для сравнения.
• Настройки сохранены, но сессия использует прежнюю модель: закройте старый процесс и проверьте новую сессию и выбранный профиль.
• Ошибка чтения каталога: сверяйте путь и валидность JSON, сохраняя исходный файл.
• Ответ идёт, но расход не совпадает: изолируйте тест от остальных инструментов и проверьте специальный адрес Codex.
• Один инструмент работает, другой нет: проверяйте конкретный вызов. Успех ответа модели не доказывает поддержку браузера, генерации изображений или всех плагинов.

Для начала проверки мастера предусмотрена команда npx @z_ai/coding-helper doctor, указанная в его официальной справке. Перед отправкой диагностического вывода удалите ключи, персональные данные и закрытые адреса. Результат диагностики объясняет состояние настроек, но не заменяет тестовый запрос.

Как вернуться к прежнему провайдеру

Закройте сессии, использующие тестовую настройку. Верните сохранённые конфигурационные файлы в их прежние места и откройте новую сессию. Если после начала теста появились другие важные настройки, не заменяйте весь файл старой копией: сравните изменения и верните только части подключения Z.AI.

Проверьте прежний провайдер на той же безвредной задаче. Не удаляйте всю папку Codex вместе с историей ради смены модели. Если ключ больше не нужен, отзовите его в кабинете Z.AI и проверьте автопродление отдельной подписки. Возврат настроек приложения сам по себе не отменяет подписку.

Частые вопросы

GLM входит в подписку ChatGPT?

Нет, здесь используется отдельный провайдер и отдельный Coding Plan Z.AI. Проверяйте его условия в своём кабинете.

Поддерживается ли настольное приложение?

Специальный гайд Z.AI описывает перезапуск приложения после настройки. Проверять нужно вашу версию и конкретные функции; общий ответ модели не подтверждает работу всех возможностей.

Можно ли использовать старую инструкцию с роутером?

Не смешивайте её с прямым путём Z.AI. Сначала выберите один маршрут, иначе невозможно понять, где возникла ошибка и куда ушёл запрос.

Достаточно спросить модель, кто она?

Нет. Подтверждение дают настройки активной сессии и учёт изолированного теста у провайдера.