Z.ai + Claude Code: подключаем GLM-5.3 за 5 минут
Как подключить GLM-5.3 от Z.ai к Claude Code: тарифы GLM Coding Plan на ноябрь 2026, настройка через settings.json и функцию glm, разбор ошибок 401 и 1113.
$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 в месяц.

Лимиты теперь считаются в кредитах, а не в числе запросов. У каждого тарифа есть окно на 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.

Главная деталь тарифа это часы пик. С понедельника по пятницу с 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.

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

Я посчитал типичный кусок работы агента: 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.
Как получить API-ключ Z.ai
Ключ привязан к подписке, поэтому порядок такой: сначала тариф, потом ключ.
Первый: зарегистрироваться. Зайди на z.ai и войди через Google или GitHub, так быстрее всего.
Второй: оформить GLM Coding Plan. На z.ai/subscribe выбери Lite и период «Monthly». Оплата идёт картой или PayPal, с баланса кредитов списание идёт первым.
Третий: создать ключ. В личном кабинете открой Personal Coding Plan → Plan Overview и нажми создание ключа. Назови его по месту использования, например claude-code. Ключ показывается один раз, сразу сохрани его в менеджер паролей.

Обрати внимание на нижнюю часть кадра. Если ничего не настраивать, 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 на максимальном уровне рассуждений иногда в него не укладываются.

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

Есть и автоматический путь. 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 -p "объясни этот код", glm --model sonnet, glm --continue работают как с обычным claude.
Почему ключ передаётся через ANTHROPIC_AUTH_TOKEN, а не через ANTHROPIC_API_KEY? Первая переменная отправляет ключ в заголовке Authorization: Bearer, и именно так его ждёт Z.ai. Это видно в справочнике Claude Code.

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

Какую модель выбрать: старшую или 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.

Проверить, что всё подхватилось, можно командой /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.

Ошибка «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.
Читайте также
- Обзор GLM-5.3 от Z.ai: бенчмарки модели, на которой теперь работает Coding Plan, и её находки по безопасности
- GLM-5.3-Flash: обзор модели: чем лёгкая модель с картинками отличается от старшей
- DeepSeek + Claude Code: тот же приём с алиасом для второго китайского провайдера
- Настройка Claude Code через settings.json: где лежат файлы настроек и какой из них главнее