Claude CodeГайд

Z.ai + Claude Code: подключаем GLM-5.3 за 5 минут

Как подключить GLM-5.3 от Z.ai к Claude Code: тарифы GLM Coding Plan на ноябрь 2026, настройка через settings.json и функцию glm, разбор ошибок 401 и 1113.

Z.ai + Claude Code: подключаем GLM-5.3 за 5 минут

$18 в месяц стоит GLM Coding Plan Lite от Z.ai на 6 ноября 2026 года, в феврале было $10. Подключить Z.ai к Claude Code по-прежнему можно за 5 минут: берёшь API-ключ в GLM Coding Plan, прописываешь адрес https://api.z.ai/api/anthropic и ключ в переменные окружения и сопоставляешь алиасы Claude с моделями GLM-5.3. Интерфейс, MCP, хуки и CLAUDE.md остаются прежними, меняется только модель, которая отвечает.

Я держу такую связку с февраля 2026 года как запасной вариант к подписке Anthropic: команда claude идёт в Anthropic, команда glm в Z.ai. За девять месяцев у Z.ai сменились модели (с GLM-4.7 на GLM-5.3), цены и сама система лимитов, а по API GLM-5.3 теперь стоит почти как Claude Sonnet 5.5. Ниже инструкция, которую я заново прошёл 6 ноября 2026 года на Claude Code 2.1.318, и расчёт, когда подписка окупается.

В статье разберём:

  • сколько стоит GLM Coding Plan и что изменилось с февраля;
  • когда выгоднее подписка, а когда оплата по API;
  • как получить API-ключ Z.ai;
  • как подключить Z.ai к Claude Code через settings.json;
  • как переключаться между Claude и запасным провайдером одной командой;
  • какую модель выбрать и как включить контекст на 1 млн токенов;
  • какие ошибки бывают при подключении и как их починить.

Что такое Z.ai и зачем подключать GLM

Z.ai (бывшая Zhipu AI) это китайская компания, которая делает открытые модели серии GLM. Для разработчиков у неё есть GLM Coding Plan: подписка с фиксированной ценой, которая работает в Claude Code, Codex, OpenCode, Cline и ещё двух десятках агентов. В Claude Code она подключается через Anthropic-совместимый адрес, поэтому сам инструмент ничего не замечает.

Зачем это нужно? Мне это даёт две вещи. Первая: запас на случай, когда лимит подписки Anthropic кончился посреди задачи. Вторая: дешёвый исполнитель для рутины, где флагман Claude избыточен (переименования, тесты, миграции). Проектирование и спорные архитектурные решения я всё равно оставляю Claude, тут мне спокойнее с моделью, к которой я привык.

Сейчас в плане две модели. GLM-5.3 вышла 18 августа 2026 года, на Terminal-Bench 2.1 она, по данным Z.ai, набирает 88,2 против 85,0 у Claude Opus 4.8, подробнее в моём обзоре GLM-5.3. GLM-5.3-Flash вышла 26 августа: 320 млрд параметров, из них активны 18 млрд, понимает картинки, разбор в статье про GLM-5.3-Flash. Обе поддерживают контекст на 1 млн токенов, даты релизов взяты из журнала обновлений Z.ai.

Отдельно про старые конфиги. По документации GLM Coding Plan, запросы к GLM-5.2 и GLM-5.1 сами уходят на GLM-5.3, а к GLM-4.7 на GLM-5.3-Flash. Так что настройка из февраля ещё отвечает, но модели в ней лучше переписать явно.

Сколько стоит GLM Coding Plan в ноябре 2026

Тарифов по-прежнему три, но цены выросли. На странице подписки 6 ноября 2026 года при помесячной оплате Lite стоит $18, Pro $80, Max $168. За квартал скидка 20%, за год 30%: тогда Lite обходится в $12,6 в месяц.

Страница подписки GLM Coding Plan с тарифами Lite за 18, Pro за 80 и Max за 168 долларов в месяц
При помесячной оплате Lite стоит $18, в феврале было $10. Pro даёт 6× от Lite, Max 14×. Скриншот: Z.ai / matveev.tech

Лимиты теперь считаются в кредитах, а не в числе запросов. У каждого тарифа есть окно на 5 часов и недельный потолок:

Тариф Цена в месяц Кредитов за 5 часов Кредитов в неделю
Lite $18 2 000 10 000
Pro $80 12 000 60 000
Max $168 28 000 140 000

Кредиты списываются по токенам. Для GLM-5.3 это 6,9 кредита за 10 тысяч входных токенов, 1,7 за 10 тысяч из кэша и 24 за 10 тысяч выходных. GLM-5.3-Flash ровно втрое дешевле: 2,3, 0,56 и 8.

Таблица кредитов GLM Coding Plan: Lite 2000 за 5 часов и 10000 в неделю, Pro 12000 и 60000, Max 28000 и 140000
Два лимита сразу: окно в 5 часов обновляется скользяще, недельный отсчитывается от даты покупки. Скриншот: документация Z.ai

Главная деталь тарифа это часы пик. С понедельника по пятницу с 14:00 до 18:00 по сингапурскому времени (UTC+8) кредиты списываются полностью, в остальное время вдвое меньше. По Москве пик выпадает на 9:00–13:00. Если тяжёлые задачи вроде рефакторинга ставить после обеда, лимит растягивается почти в два раза.

Ещё два правила из FAQ Z.ai. Когда квота кончилась, деньги с баланса не списываются, ты просто ждёшь следующего окна. И деньги за подписку не возвращают даже за неиспользованный срок, поэтому начинать лучше с месяца, а не с года.

Подписка или оплата по API: что выгоднее

В феврале я писал, что GLM в 5–7 раз дешевле Claude по API. Это уже неправда. Тогда я сравнивал GLM-4.7 ($0,6 и $2,2 за миллион) с Claude Sonnet 4.5 ($3 и $15). Сейчас Sonnet 5.5 стоит $2 и $10, а GLM-5.3 подорожала до $1,4 и $4,4. Свежие цифры взяты с прайса Z.ai и прайса Anthropic на 6 ноября 2026.

Прайс API Z.ai: GLM-5.3 1,4 доллара за вход и 4,4 за выход, GLM-5.3-Flash 0,15 и 0,50
GLM-5.3 по API стоит $1,4 за миллион входных токенов и $4,4 за миллион выходных, хранение кэша пока бесплатно. Скриншот: документация Z.ai

По прайсу GLM-5.3 дешевле Claude Sonnet 5.5 на входе в 1,4 раза, на выходе в 2,3 раза. Но в Claude Code почти весь вход идёт из кэша, а кэш у Sonnet 5.5 стоит $0,10 за миллион против $0,26 у GLM-5.3.

График цен API за миллион токенов: Opus 5.5 4 и 20 долларов, Sonnet 5.5 2 и 10, GLM-5.3 1,4 и 4,4, Haiku 5.5 0,1 и 0,5, GLM-5.3-Flash 0,15 и 0,5
По прайсу GLM-5.3 дешевле Sonnet 5.5, но разница уже не в разы, а GLM-5.3-Flash стоит на выходе столько же, сколько Haiku 5.5. Данные: Z.ai и Anthropic, 6 ноября 2026

Я посчитал типичный кусок работы агента: 1 млн входных токенов, из них 95% из кэша, и 20 тысяч токенов ответа. Новые 5% входа у Claude я считал по цене записи в кэш, у Z.ai хранение кэша пока бесплатное.

Модель Цена по API Кредитов Coding Plan в пик
Claude Opus 5.5 $0,84 —
Claude Sonnet 5.5 $0,42 —
GLM-5.3 $0,41 244
GLM-5.3-Flash $0,05 81

По API GLM-5.3 и Sonnet 5.5 выходят почти вровень. Вывод простой: Z.ai имеет смысл брать ради подписки, платить ей по API за GLM-5.3 нет причин. Lite даёт 10 000 кредитов в неделю, это 41 такой кусок в пик и 82 вне пика. По ценам API тот же объём стоил бы $72–144 в месяц, а подписка стоит $18.

Для сравнения, подписки Anthropic на странице тарифов Claude стоят $20 (Pro), $100 (Max) и $200 (Ultra) в месяц. Если упираешься в лимиты Pro, GLM Lite за $18 получается дешёвым вторым контуром. Ещё способы растянуть лимиты собраны в гайде как экономить токены в Claude Code.

Пересчитываю тарифы провайдеров для Claude Code, когда они меняются, и пишу об этом в телеге — подписывайся.

Как получить API-ключ Z.ai

Ключ привязан к подписке, поэтому порядок такой: сначала тариф, потом ключ.

Первый: зарегистрироваться. Зайди на z.ai и войди через Google или GitHub, так быстрее всего.

Второй: оформить GLM Coding Plan. На z.ai/subscribe выбери Lite и период «Monthly». Оплата идёт картой или PayPal, с баланса кредитов списание идёт первым.

Третий: создать ключ. В личном кабинете открой Personal Coding Plan → Plan Overview и нажми создание ключа. Назови его по месту использования, например claude-code. Ключ показывается один раз, сразу сохрани его в менеджер паролей.

Шаг 2 документации Z.ai для Claude Code: где создать API-ключ и какие модели GLM подставляются по умолчанию
Ключ для личного тарифа создаётся в разделе Personal Coding Plan, для командного в Team Coding Plan. Без ручной настройки все три алиаса уходят на GLM-5.3-Flash. Скриншот: документация Z.ai

Обрати внимание на нижнюю часть кадра. Если ничего не настраивать, Z.ai отдаёт на все три алиаса Claude модель GLM-5.3-Flash. Она быстрая и дешёвая, но на сложных задачах слабее GLM-5.3, поэтому ниже я сопоставляю алиасы вручную.

Сохрани ключ в переменную окружения. Открой ~/.zshrc (или ~/.bashrc) и добавь строку:

export ZAI_API_KEY="вставь-свой-ключ-сюда"

Перезапусти терминал или выполни source ~/.zshrc.

Как подключить Z.ai к Claude Code через settings.json

Этот способ подходит, если Claude Code должен всегда работать через Z.ai. Открой ~/.claude/settings.json и добавь в секцию env такие ключи. Если в файле уже есть другие настройки, не заменяй его целиком, а допиши только эти поля.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "вставь-свой-ключ",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash[1m]",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Это та же схема, что в официальной инструкции Z.ai для Claude Code. Суффикс [1m] и CLAUDE_CODE_AUTO_COMPACT_WINDOW включают контекст на миллион токенов. API_TIMEOUT_MS поднимает таймаут ответа до 50 минут: по умолчанию в Claude Code он 10 минут, и длинные ответы GLM на максимальном уровне рассуждений иногда в него не укладываются.

Ручная настройка из документации Z.ai: settings.json с адресом api.z.ai, ключом, моделями glm-5.3 и таймаутом
Официальный вариант: Opus и Sonnet ведут на GLM-5.3, Haiku на GLM-5.3-Flash, у всех суффикс [1m]. Скриншот: документация Z.ai

Все переменные из этого блока разобраны в справочнике переменных окружения Claude Code, а про устройство самого файла есть отдельный гайд по settings.json.

Переменные окружения Claude Code: полный справочник
Что делает каждая переменная для провайдера, модели, таймаутов и телеметрии.

Есть и автоматический путь. Z.ai выпустила конфигуратор npx @z_ai/coding-helper (версия 0.1.1 на npm от 23 октября 2026). Он спрашивает ключ, прописывает переменные в конфиг Claude Code и подключает MCP-серверы Z.ai для поиска и чтения страниц. Удобно, но конфиг он правит глобальный, и после этого обычный claude тоже уходит в Z.ai. Мне такое не подходит, поэтому я пользуюсь функцией из следующего раздела.

Как переключаться между Claude и запасным провайдером одной командой

Я пользуюсь функцией в ~/.zshrc. Команда claude остаётся на подписке Anthropic, команда glm запускает тот же Claude Code через Z.ai. Глобальный settings.json при этом не трогается.

glm() {
  ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic \
  ANTHROPIC_AUTH_TOKEN="$ZAI_API_KEY" \
  ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.3[1m]" \
  ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.3[1m]" \
  ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.3-flash[1m]" \
  ANTHROPIC_DEFAULT_FABLE_MODEL="glm-5.3[1m]" \
  CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000 \
  API_TIMEOUT_MS=3000000 \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude "$@"
}

По сравнению с февральской версией тут две новые строки. ANTHROPIC_DEFAULT_FABLE_MODEL нужна, потому что в Claude Code появился алиас fable: без этой строки /model fable отправит в Z.ai запрос к claude-fable-5-1, и он упадёт. API_TIMEOUT_MS я взял из рекомендаций Z.ai.

Терминал: содержимое функции glm, её проверка командой type и версия Claude Code 2.1.318
Функция glm подхватилась оболочкой, Claude Code версии 2.1.318. Скриншот: терминал / matveev.tech

Все аргументы пробрасываются дальше: glm -p "объясни этот код", glm --model sonnet, glm --continue работают как с обычным claude.

Почему ключ передаётся через ANTHROPIC_AUTH_TOKEN, а не через ANTHROPIC_API_KEY? Первая переменная отправляет ключ в заголовке Authorization: Bearer, и именно так его ждёт Z.ai. Это видно в справочнике Claude Code.

Справочник переменных Claude Code: ANTHROPIC_AUTH_TOKEN задаёт заголовок Authorization, ANTHROPIC_BASE_URL меняет адрес API
ANTHROPIC_AUTH_TOKEN уходит с префиксом Bearer. Заодно видно, что с чужим ANTHROPIC_BASE_URL отключается Remote Control. Скриншот: документация Claude Code

Тот же приём работает с любым Anthropic-совместимым провайдером. Например, у DeepSeek адрес https://api.deepseek.com/anthropic (документация DeepSeek), отдельный гайд лежит в статье DeepSeek + Claude Code. Так у меня в ~/.zshrc живут glm и dsk, а claude остаётся на Anthropic.

Claude Code с другими провайдерами в 2026
Какие ещё сервисы с Anthropic-совместимым API можно подставить вместо Claude.

Какую модель выбрать: старшую или Flash

Моделей всего две, поэтому выбор короткий.

GLM-5.3 для основной работы. Планирование, рефакторинг, отладка и вообще всё, где ошибка дорого стоит. Её я ставлю на алиасы opus, sonnet и fable.

GLM-5.3-Flash для фона. Claude Code отдаёт алиасу haiku фоновые задачи: заголовки сессий, сжатие истории, простые проверки. Flash списывает втрое меньше кредитов и понимает картинки, так что ей можно скинуть скриншот ошибки. Если лимит Lite кончается слишком быстро, можно перевести на Flash и sonnet.

Переключаться внутри сессии можно командой /model: /model opus даст GLM-5.3, /model haiku даст Flash.

Уровень рассуждений меняется командой /effort. У GLM их три: low, high и max, по умолчанию стоит max. Значения Claude Code Z.ai переводит в свои автоматически, а полностью выключить рассуждения нельзя: «выключено» превращается в low. Как устроены сами уровни, я разбирал в статье про модель и effort level в Claude Code.

Таблица из документации Z.ai: как значения thinking и reasoning_effort переводятся в уровни low, high и max
Отключить рассуждения у GLM нельзя, такой запрос получает уровень low. Для кода Z.ai советует max. Скриншот: документация Z.ai

Проверить, что всё подхватилось, можно командой /status внутри сессии. В строке Model должна стоять glm-5.3 или glm-5.3[1m], а в источнике настроек твой settings.json или переменные окружения. Расход кредитов по моделям показывает страница Charge Type в кабинете Z.ai.

Какие ошибки бывают при подключении и как их починить

Большинство проблем ловится за минуту, если знать, на что смотреть.

Ошибка 401 «token expired or incorrect». Ключ не дошёл или он неверный. Проверь, что функция видит переменную: echo "$ZAI_API_KEY" должна вывести ключ без пробелов и кавычек. Ещё одна причина в том, что ключ создан вне Coding Plan: такой ключ работает только с балансом API.

Терминал: запуск glm с неверным ключом заканчивается ошибкой 401 token expired or incorrect
Так выглядит ответ Z.ai на неверный ключ. Строка unrecognized_model перед ней безвредна: Claude Code не знает имя glm-5.3, а суффикс [1m] сообщает ему размер контекста. Скриншот: терминал / matveev.tech

Ошибка «1113 Insufficient Balance». Подписка есть, но запрос ушёл мимо неё, и Z.ai пытается списать деньги с баланса API. По FAQ Z.ai причин три: неверный адрес, инструмент не из списка поддерживаемых или модель не из плана. В плане вызываются только glm-5.3 и glm-5.3-flash, так что старая строка glm-4.5-air для Haiku из февральских инструкций как раз даёт эту ошибку.

Неверный адрес. Для Claude Code нужен https://api.z.ai/api/anthropic. Адрес https://api.z.ai/api/coding/paas/v4 предназначен для OpenAI-совместимых инструментов вроде Cline, а https://api.z.ai/api/v1 для Codex, с Claude Code они не работают. Это расписано в гайде Z.ai по смене моделей.

Правки в settings.json не применились. Закрой все окна Claude Code и запусти заново. Если не помогло, проверь JSON на лишние запятые и сверь имена переменных.

Ошибки про beta-заголовки. Если в ответ приходит Unexpected value(s) для anthropic-beta, добавь в функцию CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1. Флаг убирает из запросов экспериментальные функции Anthropic, которых у Z.ai нет.

Квота кончается к обеду. Скорее всего, тяжёлая работа попадает в пик с 9:00 до 13:00 по Москве, где кредиты идут по полной цене. Перенеси большие задачи на вторую половину дня или отдай sonnet модели Flash.

Не работает Remote Control. Это ожидаемо. Начиная с версии 2.1.196 Claude Code отключает Remote Control, если ANTHROPIC_BASE_URL указывает не на Anthropic, а CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC отключает ещё и функции, которым нужны флаги с серверов Anthropic. Для таких функций запускай обычный claude.

Частые вопросы про Z.ai и Claude Code

Будут ли работать MCP-серверы, хуки и CLAUDE.md? Да. Они работают на стороне Claude Code и от провайдера модели не зависят. Меняется только модель, которая обрабатывает запросы. В тарифы Z.ai дополнительно входят свои MCP-серверы для веб-поиска, чтения страниц и анализа картинок, их расход тоже идёт в кредиты.

Можно ли использовать ключ Coding Plan вне Claude Code? Только в инструментах из официального списка Z.ai: ZCode, Codex, OpenCode, Cline и других. Обычные запросы к API по ключу подписки не проходят. Для своих скриптов нужен отдельный ключ с балансом и оплатой по токенам.

Куда уходит код и используют ли его для обучения? Код уходит на серверы Z.ai. На странице тарифов у личных планов указана «Default data privacy», а в блоке про командный тариф Z.ai пишет, что данные не используются для обучения моделей. Если проект под NDA или с персональными данными, я бы не отправлял его ни в одно облако без согласования с безопасниками.

Есть ли у Z.ai бесплатные модели для Claude Code? По API бесплатны старые GLM-4.7-Flash и GLM-4.5-Flash, но в Coding Plan они не входят, и для агентной работы они заметно слабее GLM-5.3. Самый дешёвый рабочий вариант сейчас это GLM-5.3-Flash по API за $0,15 и $0,50 за миллион токенов.

Стоит ли подключать вторую модель к Claude Code

Думаю, стоит, если ты упираешься в лимиты Claude Pro и нужен второй контур подешевле. За $18 Lite забирает рутину вроде тестов, переименований и миграций, а функция glm живёт рядом с обычным claude и ему не мешает. Бери подписку помесячно, раз деньги за неё не возвращают, и ставь тяжёлые задачи после 13:00 по Москве.

Если хочется платить Z.ai по API, смысла мало: там GLM-5.3 выходит почти вровень с Sonnet 5.5. Проект под NDA я бы без согласования с безопасниками туда не отправлял. А если ты работаешь через Remote Control, с чужим адресом API он не включится. Проектирование и спорные решения я по-прежнему оставляю Claude.

Другие способы подключить сторонние модели и всё про настройку агента собраны в разделе о Claude Code.

Читайте также

CTO говорит

Разбираю релизы моделей и инструментов: что вышло и стоит ли переходить.

Читать в Telegram

Ещё в разделе Claude Code

Весь раздел