AIREITERGLM-5.2 уже можно использовать в Claude Code — настройка займёт примерно две минуты. Claude Code умеет работать с любым endpoint, поддерживающим Anthropic Messages API, а Zhipu предоставляет такой интерфейс для GLM. Достаточно указать адрес z.ai. Есть два пути: CC Switch с переключением в один клик или ручная правка конфигурации. Ниже разберём оба варианта для macOS, Windows и Linux, а также покажем, как при необходимости вернуться к Claude.
Самый простой вариант — CC Switch
Если вы уже используете нескольких провайдеров, ручную настройку можно пропустить и установить CC Switch. Это open-source приложение под MIT-лицензией для Windows/macOS/Linux, которое управляет конфигурациями провайдеров для Claude Code, Codex, Gemini CLI и ряда других CLI. Редактировать JSON вручную не придётся.
- Установите CC Switch с ccswitch.io или из его GitHub repo. В главном окне нажмите оранжевую кнопку + в правом верхнем углу, чтобы открыть Add Provider, затем перейдите на вкладку Claude Provider.
- Введите
zhipuв поиске пресетов. Появятся два варианта: Zhipu GLM для endpoint в материковом Китае и Zhipu GLM en. За пределами материкового Китая выбирайте Zhipu GLM en — это международный endpoint.
- Прокрутите страницу вниз и вставьте API-ключ z.ai в поле API Key. Остальные параметры пресет заполнит сам: формат Anthropic Messages (Native), поле авторизации
ANTHROPIC_AUTH_TOKENи базовый URL. - В разделе Model Mapping назначьте
glm-5.2для каждой роли — Sonnet, Opus, Fable и Haiku. Тогда все запросы будут уходить в GLM независимо от того, какой уровень выбирает Claude Code. Отметьте 1M у нужной роли, чтобы сообщить Claude Code о контексте в миллион токенов. Сохраните настройки.
- Вернитесь к списку провайдеров и нажмите Enable у Zhipu GLM. Например, Claude Official можно оставить в списке для последующего возврата к Claude. Перезапустите Claude Code, чтобы он точно подхватил нового провайдера, затем выполните
/status: в строке модели должно бытьglm-5.2.
Преимущество приложения перед статичной конфигурацией в том, что в нём есть пресеты для большинства провайдеров, которые обычно хочется попробовать: Kimi, MiniMax, MiMo, Qwen, DeepSeek и других. Вместо очередной правки конфига достаточно выбрать пресет и добавить ключ, а переключение между ними или возврат к Claude занимает пару кликов. На этом и строится гибридный сценарий, о котором речь пойдёт ниже.
Ручная настройка через settings.json
Предпочитаете контролировать конфигурацию сами или настраиваете CI-машину без графического интерфейса? Внесите изменения непосредственно в файл.
- Получите API-ключ в Z.AI API console. Подойдёт ключ для оплаты по факту использования или ключ подписки GLM Coding Plan.
- Добавьте этот блок
envв файл настроек Claude Code. Не удаляйте существующие ключи и не перезаписывайте файл целиком. Сам блок одинаков для всех платформ, различается только путь к файлу:
- macOS / Linux: ~/.claude/settings.json - Windows: %USERPROFILE%\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
"API_TIMEOUT_MS": "3000000"
}
}- Перезапустите Claude Code и выполните
/status. В строке модели должно отображатьсяglm-5.2либоglm-5.2[1m]для версии с контекстом в миллион токенов. Если по-прежнему указана модель Claude, конфигурация не была загружена: проверьте синтаксис JSON и путь к файлу.
Если не хотите редактировать файл, есть два варианта через оболочку:
- macOS / Linux — экспортируйте переменные для одного сеанса в bash/zsh, затем запустите:
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claudeЗакройте терминал — и при следующем запуске снова будет использоваться обычная конфигурация.
- Windows — задайте постоянные пользовательские переменные среды в PowerShell, затем перезапустите терминал:
setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"Переменные ANTHROPIC_DEFAULT_* переназначают роли моделей, на которые Claude Code маршрутизирует запросы: Opus, Sonnet и Haiku. В новых сборках появилась также роль Fable, которую показывает CC Switch. Если везде указать glm-5.2, все запросы уйдут в GLM. Если же фоновые задачи хочется сделать дешевле и быстрее, для слота Haiku можно выбрать glm-4.5-air. Для полного окна в миллион токенов используйте glm-5.2[1m]. Длинное значение API_TIMEOUT_MS важнее, чем кажется: GLM нередко отвечает медленнее Claude, и стандартный таймаут может оборвать длинную генерацию.
Какой способ выбрать: z.ai, прокси или Coding Plan
Подключить GLM-5.2 к Claude Code можно тремя практическими способами, и это не взаимозаменяемые варианты.
Нативный endpoint z.ai — рекомендуемый вариант. Это указанный выше URL https://api.z.ai/api/anthropic. Он поддерживает протокол Anthropic, поэтому Claude Code подключается напрямую, без промежуточного слоя. Это выбор по умолчанию.
Прокси с преобразованием протоколов. Другие хостинги, включая Fireworks, NVIDIA NIM и самостоятельно развёрнутые веса, отдают GLM-5.2 через OpenAI-совместимый API, который Claude Code напрямую не понимает. Нужен прокси, преобразующий форматы; с этим справляется claude-code-router. Такой путь имеет смысл, только если у вас уже есть кредиты или оборудование на одной из этих платформ.
Подписка GLM Coding Plan. Это фиксированный месячный тариф от $18/month, согласно странице подписки z.ai. Используется тот же endpoint z.ai, но вместо тарификации по токенам вы платите фиксированную сумму. Если вы ежедневно пишете код в Claude Code, подписка обычно оказывается дешевле и предсказуемее оплаты по счётчику токенов. Сравните её со своими месячными расходами на токены, чтобы найти точку окупаемости. При неравномерном использовании выгоднее pay-as-you-go.
Как переключаться между GLM-5.2 и Claude
В Claude Code одновременно активен только один провайдер, поэтому модели нужно переключать, а не распределять по слотам. GLM-5.2 можно использовать для повседневного объёма задач, а когда нужны Claude для архитектуры, чувствительного к безопасности кода или ревью — включать Claude Official в CC Switch. Для стороны Claude подойдёт любой Anthropic-совместимый endpoint: учётная запись Anthropic или, например, relay AIReiter — один из нескольких вариантов. Если нужна автоматическая маршрутизация каждого запроса между провайдерами, распределение возьмёт на себя gateway вроде claude-code-router.
Решение типичных проблем
| Симптом | Вероятная причина | Что делать |
|---|---|---|
/status по-прежнему показывает модель Claude | settings.json не загружен | Проверьте валидность JSON, убедитесь, что редактировали ~/.claude/settings.json, и перезапустите Claude Code |
Ошибка model not found | Неверный ID модели с учётом регистра | Используйте строго glm-5.2, glm-5.2[1m] или glm-4.5-air |
| 401 / authentication failed | Ключ не соответствует endpoint | Не используйте ключ OpenRouter с URL z.ai; при необходимости создайте новый ключ |
| Длинные генерации обрываются | Слишком маленький таймаут | Увеличьте API_TIMEOUT_MS, например до 3000000 |
| Вызовы инструментов падают или зацикливаются | Некорректный JSON инструментов | Уменьшите число параллельных субагентов, повторите запрос или упростите инструкцию |
Частые вопросы
GLM-5.2 в Claude Code бесплатна?
Не без ограничений, хотя z.ai запускала ограниченные по времени бесплатные периоды для GLM-5.2, а стоимость Coding Plan начинается от $18/month. Даже по полным тарифам pay-as-you-go — $1.40 / $4.40 за миллион — при лёгком использовании расходы составляют считанные центы.
Поддерживает ли GLM-5.2 контекст в 1M токенов в Claude Code?
Да. В переменных ANTHROPIC_DEFAULT_* укажите ID модели glm-5.2[1m] вместо glm-5.2, и Claude Code будет использовать окно в миллион токенов.
Что лучше для программирования в Claude Code: GLM-5.2 или Claude?
Для обычных последовательных правок разница в цене делает GLM-5.2 рациональным вариантом по умолчанию. Claude обычно сильнее в многошаговой архитектуре, задачах с повышенными требованиями к безопасности и сценариях с большим числом параллельных субагентов. Настройка переключения позволяет использовать каждую модель там, где она сильнее, а не выбирать одну-единственную.
Можно ли использовать GLM-5.2 не только в Claude Code?
Да. Те же endpoint и ключи z.ai работают с другими агентными CLI: OpenCode, Cline и Kilo Code принимают пользовательский base URL, а CC Switch управляет пресетами для нескольких таких инструментов.
Нужна ли платная подписка Claude, чтобы использовать GLM-5.2 в Claude Code?
Нет. Claude Code — это лишь клиент: после подключения к z.ai оплата идёт z.ai, а не Anthropic. Учётная запись Claude нужна только в том случае, если вы хотите сохранить Claude как провайдера для переключения.
Нужно ли перезапускать Claude Code после смены провайдера в CC Switch?
Согласно документации CC Switch, Claude Code поддерживает горячее переключение данных провайдера без перезапуска, тогда как большинству других CLI требуется перезапуск терминала или приложения. На практике перезапуск Claude Code — самый надёжный способ убедиться, что переключение сработало.
Как вернуться к Claude с официальным входом в CC Switch?
Добавьте провайдер Claude Official из списка пресетов, включите его, затем один раз выполните обычный выход и вход Claude Code через OAuth. После этого можно свободно переключаться между официальной учётной записью Claude и сторонними провайдерами, такими как z.ai.
CC Switch бесплатен и безопасен?
Да. Это бесплатный open-source проект под лицензией MIT. Конфигурации хранятся локально в базе SQLite с атомарной записью, а само приложение намеренно вносит минимальные изменения в конфиги каждого инструмента. Поэтому CLI продолжат работать как обычно, даже если удалить приложение.