Суть интеграции: GLM вместо Claude
Платформа Z.AI (Zhipu AI) опубликовала детальное руководство по подключению своих моделей к Claude Code — популярному агентному инструменту для разработки, работающему в терминале. Ключевое изменение заключается в маппинге внутренних переменных окружения Claude Code на модели семейства GLM. Теперь разработчики могут использовать GLM-5.3-Flash (в конфигурации по умолчанию для уровней Haiku, Sonnet и Opus) для выполнения рутинных задач, объяснения кода и управления git-воркфлоу через естественный язык.
Технические детали настройки
Интеграция работает за счет переопределения базового URL и токенов аутентификации. Вместо обращения к серверам Anthropic, запросы перенаправляются на API Z.AI. В конфигурационном файле ~/.claude/settings.json необходимо задать следующие параметры:
- ANTHROPIC_BASE_URL:
https://api.z.ai/api/anthropic - ANTHROPIC_AUTH_TOKEN: Ваш API-ключ от Z.AI Open Platform.
- API_TIMEOUT_MS: Установлено значение 3 000 000 мс (50 минут) для обработки сложных задач.
Для упрощения процесса Z.AI выпустила вспомогательный инструмент Coding Tool Helper (npx @z_ai/coding-helper), который автоматически устанавливает зависимости, настраивает окружение и управляет MCP-серверами. Также доступен bash-скрипт для macOS и Linux, который автоматически модифицирует файл настроек.
Совместимость и требования
Официально протестирована совместимость с версией Claude Code 2.0.14 и новее. Для работы требуется Node.js 18+. На macOS настоятельно рекомендуется использовать nvm для установки Node.js во избежание проблем с правами доступа. На Windows поддержка автоматического скрипта отсутствует, требуется ручная настройка переменных окружения.
| Параметр конфигурации | Значение по умолчанию (GLM-5.3-Flash) | Примечание |
|---|---|---|
| ANTHROPIC_DEFAULT_HAIKU_MODEL | glm-5.3-flash[1m] | Базовая быстрая модель |
| ANTHROPIC_DEFAULT_SONNET_MODEL | glm-5.3[1m] | Основная рабочая модель |
| ANTHROPIC_DEFAULT_OPUS_MODEL | glm-5.3[1m] | Модель для сложных задач |
| CLAUDE_CODE_AUTO_COMPACT_WINDOW | 1000000 | Размер окна контекста |
Почему это важно
Данное решение создает новую парадигму использования LLM: разработчики получают доступ к мощным моделям GLM через устоявшийся и удобный интерфейс Claude Code, не переучиваясь работать с новыми CLI-инструментами. Это особенно актуально для проектов, где критична стоимость вычислений или требуется обход геоблокировок, так как GLM-5.3-Flash позиционируется как эффективная и бюджетная альтернатива оригинальным моделям Anthropic.
Источник: Z ↗