Вы можете запустить GLM-5.2 в Claude Code уже сегодня, и настройка занимает около двух минут. Claude Code работает с любым endpoint, который поддерживает Anthropic's Messages API, а Zhipu предоставляет именно это для GLM — укажите Claude Code на z.ai, и все готово. Есть два способа подключиться: приложение-переключатель в один клик (самый простой, и оно позволяет в любой момент вернуться к Claude), или вручную отредактированный файл конфигурации. Это руководство охватывает оба варианта для macOS, Windows и Linux, а также показывает, как переключиться обратно на Claude, когда он вам понадобится.
Самый быстрый способ: CC Switch
Если вы уже работаете более чем с одним провайдером, пропустите ручную настройку и используйте CC Switch (open-source, MIT-licensed, Windows/macOS/Linux). Это настольное приложение, которое управляет конфигурациями провайдеров для Claude Code, Codex, Gemini CLI и нескольких других CLI, так что вам не нужно редактировать JSON вручную.
1. Установите CC Switch с ccswitch.io или из его GitHub repo. Нажмите оранжевую кнопку + в правом верхнем углу главного окна, чтобы открыть Add Provider, и выберите вкладку Claude Provider. 2. Введите zhipu в поиске пресетов. Появятся два пресета — Zhipu GLM (mainland endpoint) и Zhipu GLM en. Вне mainland China выберите Zhipu GLM en для международного endpoint.
3. Прокрутите вниз и вставьте ваш API-ключ z.ai в поле API Key. Предустановка автоматически заполнит остальное: формат Anthropic Messages (Native), поле аутентификации ANTHROPIC_AUTH_TOKEN и базовый URL.
4. В Model Mapping задайте запрошенную модель для каждой роли — Sonnet, Opus, Fable и Haiku — как glm-5.2, чтобы каждый запрос направлялся в GLM независимо от того, к какому уровню Claude Code обращается. Установите флажок 1M для роли, чтобы сообщить Claude Code о миллионном контексте токенов. Сохраните.
5. Вернувшись к списку провайдеров, нажмите Enable в записи Zhipu GLM (существующий провайдер, например Claude Official, может оставаться в списке, чтобы потом можно было переключиться обратно), затем перезапустите Claude Code, чтобы убедиться, что он подхватил нового провайдера. Выполните /status, чтобы подтвердить, что модель отображается как glm-5.2.
Зачем возиться с приложением вместо статической конфигурации: оно поставляется с пресетами для большинства провайдеров, которые вы захотите попробовать — Kimi, MiniMax, MiMo, Qwen, DeepSeek и другие — так что для каждого нужен лишь пресет и ключ, а не переписывание конфигурации, и переключение между ними (или обратно на Claude) занимает пару кликов. В этом и заключается практическая основа гибридного рабочего процесса ниже.
Ручная настройка с помощью settings.json
Предпочитаете настроить его самостоятельно или настроить CI-box без GUI? Отредактируйте файл напрямую.
1. Получите API key в Z.AI API console. Подойдёт как pay-as-you-go key, так и ключ подписки GLM Coding Plan. 2. Объедините этот 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"
}
}3. Перезапустите Claude Code, затем выполните /status. В строке модели должно быть указано glm-5.2 (или glm-5.2[1m] для варианта с миллионом токенов). Если по-прежнему отображается модель Claude, файл не был подхвачен — проверьте наличие ошибок синтаксиса JSON и подтвердите путь.
Две альтернативы на основе shell, если вы предпочитаете не трогать файл:
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 native, прокси или Coding Plan?
Три практических способа подключить GLM-5.2 к Claude Code, и они не взаимозаменяемы.
Нативная конечная точка z.ai (рекомендуется). URL https://api.z.ai/api/anthropic выше. Она использует протокол Anthropic, поэтому Claude Code подключается без промежуточного ПО — выбор по умолчанию.
Прокси для перевода. Другие хосты (Fireworks, NVIDIA NIM, self-hosted weights) предоставляют GLM-5.2 через API, совместимый с OpenAI, который Claude Code не может читать напрямую, поэтому им нужен прокси, преобразующий форматы. claude-code-router справляется с этим. Имеет смысл только если у вас уже есть кредиты или оборудование на одной из этих платформ.
Подписка GLM Coding Plan. Фиксированный ежемесячный план (от $18/месяц, на странице подписки z.ai), который использует тот же endpoint z.ai, но взимает фиксированную плату вместо оплаты за токен. Если вы ежедневно пишете код в Claude Code, подписка обычно дешевле и предсказуемее, чем тарификация по токенам; посчитайте, как это соотносится с вашими ежемесячными расходами на токены, чтобы найти точку безубыточности. Если нагрузка у вас скачкообразная, выгоднее pay-as-you-go.
Переключение между GLM-5.2 и Claude
Claude Code использует одного активного провайдера за раз, поэтому вы *переключаетесь*, а не распределяете слоты: запускайте GLM-5.2 для рутинного объёма, а в CC Switch включайте своего Claude Official провайдера, когда вам нужен Claude для архитектуры, кода, чувствительного к безопасности, или ревью. Подойдёт любой Anthropic-compatible endpoint на стороне Claude — ваша учётная запись Anthropic или релей, такой как AIReiter, один из нескольких вариантов. Для автоматической маршрутизации по запросам между провайдерами gateway, такой как claude-code-router, выполняет распределение.
Устранение неполадок
Симптом | Вероятная причина | Исправление |
|---|---|---|
| settings.json не загружен | Проверьте, что JSON корректен; убедитесь, что вы отредактировали |
Ошибка | Неверный ID модели (с учетом регистра) | Используйте точно |
401 / сбой аутентификации | Несоответствие ключа/конечной точки | Не используйте ключ OpenRouter вместе с URL z.ai; при необходимости сгенерируйте ключ заново |
Длинные генерации обрываются | Слишком низкий тайм-аут | Установите |
Вызовы инструментов не выполняются или зацикливаются | Некорректный JSON инструмента | Уменьшите число параллельных подагентов; повторите попытку; упростите инструкцию |
Часто задаваемые вопросы
Бесплатен ли GLM-5.2 в Claude Code?
Не без ограничений, хотя z.ai проводила бесплатные окна с ограниченным сроком на GLM-5.2, а Coding Plan начинается от $18/month. Даже при полных тарифах pay-as-you-go ($1.40 / $4.40 per million) при небольшом использовании расходы составляют считанные центы.
Поддерживает ли GLM-5.2 контекст в 1M токенов в Claude Code?
Да. Установите ID модели glm-5.2[1m] вместо glm-5.2 в ваших переменных ANTHROPIC_DEFAULT_*, и Claude Code будет использовать миллион-токенное окно.
Что лучше для программирования в Claude Code: GLM-5.2 или Claude?
Для рутинных последовательных правок разница в цене делает GLM-5.2 рациональным выбором по умолчанию. Claude, как правило, выходит вперед в многоэтапной архитектуре, задачах, чувствительных к безопасности, и рабочих процессах с высокой конкуренцией субагентов. Настройка переключения позволяет использовать каждый там, где он сильнее, вместо того чтобы выбирать только один.
Могу ли я использовать GLM-5.2 в инструментах, отличных от Claude Code?
Да. Тот же endpoint z.ai и те же ключи работают и с другими agentic 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 из предустановленного списка, включите его, затем один раз выполните обычный выход из Claude Code / вход (OAuth). После этого вы сможете свободно переключаться между вашим официальным входом в Claude и сторонними провайдерами, такими как z.ai.
CC Switch бесплатен и безопасен в использовании?
Да — он с открытым исходным кодом под лицензией MIT и бесплатный. Ваши конфигурации хранятся локально в базе данных SQLite с атомарной записью, и по замыслу вносит минимальные изменения в собственную конфигурацию каждого инструмента, поэтому ваши CLI продолжают нормально работать, даже если вы удалите приложение.