Переменные окружения Claude Code для субагентов и моделей по умолчанию: 5 ключей для управления маршрутизацией и расходом токенов
По состоянию на 22 ноября 2026 года Claude Code управляет маршрутизацией моделей основной сессии и субагентов через 5 базовых переменных окружения: ANTHROPIC_MODEL задаёт основную модель, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL фиксируют псевдонимы opus, sonnet и haiku, а CLAUDE_CODE_SUBAGENT_MODEL переводит всех субагентов на одну модель. При маршрутизации через пользовательский шлюз ANTHROPIC_BASE_URL запись этих 5 ключей в блок env файла ~/.claude/settings.json предотвращает ошибки смещения псевдонимов и не даёт параллельным субагентам использовать флагманские тарифы.
Обновлено 2026-11-22
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре ключевых факта, которые важно знать в первую очередь
Основная модель, три псевдонима уровней и глобальное переопределение для субагентов
ANTHROPIC_MODEL задаёт модель основной сессии, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL управляют разрешением псевдонимов, а CLAUDE_CODE_SUBAGENT_MODEL закрепляет Explore, Plan и всех остальных субагентов за одной моделью; ANTHROPIC_DEFAULT_FABLE_MODEL фиксирует псевдоним fable.
Разница официальных ставок API Anthropic на вход (за 1M токенов)
На официальной странице тарифов Anthropic (проверено 2026-11-22): Claude Haiku 5.5 тарифицируется по $0.10 за вход и $0.50 за выход для запросов до 100,000 токенов; Sonnet 5.5 — $2 / $10; Opus 5.5 — $4 / $20; Fable 5.2 — $8 / $40. Использование флагманской модели в основном потоке и перевод поисковых субагентов на более лёгкие уровни радикально меняют расходы за сессию.
Выпуск от 2026-11-20 с исправлениями субагентов и переключения моделей
В Claude Code v2.1.330 исправлено преждевременное завершение работы MCP-серверов, объявленных субагентами, пока их используют другие субагенты, проблема с выходом остановленных фоновых субагентов из состояния остановки, устаревшие инструкции системного промпта после переключения модели вслед за /context, а также потеря переменных окружения из хука SessionStart при запуске claude -p --continue.
Глобальный блок env, переопределяющий экспорты оболочки
Если одна и та же переменная задана и в оболочке, и в блоке env файла настроек, в большинстве сессий приоритет остаётся за файлом настроек, и его значения также передаются фоновым агентам. Никогда не размещайте учётные данные API в файле проекта .claude/settings.json, который попадает в репозиторий; для переопределений в рамках одного проекта используйте .claude/settings.local.json.
Назначение, приоритет и разрешение псевдонимов для 5 переменных окружения
Claude Code выбирает модель по пяти уровням приоритета: сначала учитывается команда /model внутри сессии, затем флаг запуска claude --model, переменная окружения ANTHROPIC_MODEL, поле model в настройках и, наконец, ANTHROPIC_DEFAULT_MODEL для новых сессий (требуется v2.1.236 или новее). Когда вы передаёте псевдоним вроде opus, sonnet, haiku, fable или opusplan либо указываете model: sonnet или model: haiku в YAML-заголовке пользовательского субагента, Claude Code преобразует этот псевдоним в полный идентификатор модели.
В Anthropic API псевдонимы opus, sonnet и haiku разрешаются в Opus 5.5 (v2.1.280+), Sonnet 5.5 (v2.1.284+) и Haiku 5.5 (v2.1.293+), а fable — в Fable 5.2 (v2.1.321+). В Amazon Bedrock, Microsoft Foundry или пользовательских LLM-шлюзах сопоставления по умолчанию могут указывать на устаревшие или не настроенные идентификаторы, поэтому критически важно жёстко задать полные ID через ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL и ANTHROPIC_DEFAULT_FABLE_MODEL. Что касается субагентов, встроенный Explore использует модель родительского диалога (переключаясь с Fable на псевдоним opus при работе через подписку, Anthropic Console или шлюзы ANTHROPIC_BASE_URL), Plan наследует модель родительского диалога, statusline-setup работает на Sonnet, а claude-code-guide и web-fetch — на Haiku.
Установка CLAUDE_CODE_SUBAGENT_MODEL принудительно переводит каждого субагента, включая Explore и Plan, на эту единственную модель. Устаревшая переменная ANTHROPIC_SMALL_FAST_MODEL больше не рекомендуется; фоновые задачи теперь используют ANTHROPIC_DEFAULT_HAIKU_MODEL.
Обновление от 2026-11-20: исправления субагентов в v2.1.330 и нагрузка на квоты в сообществе
По состоянию на 2026-11-22 последний релиз Claude Code v2.1.330 (вышел 2026-11-20) содержит ряд исправлений, напрямую влияющих на рабочие процессы с несколькими субагентами и зафиксированными моделями.
- 1Жизненный цикл MCP субагентов: исправлено отключение MCP-сервера, объявленного субагентами, при завершении одного субагента, пока другие субагенты или сессия всё ещё его используют.
- 2Состояние фоновых субагентов: исправлено поведение, при котором остановленные фоновые субагенты не всегда оставались остановленными, а также ожидание со стороны Claude фонового агента, остановленного в момент завершения в сессиях приложения или SDK.
- 3Переключение моделей и настройки: исправлено сохранение инструкций предыдущей модели в системном промпте при смене модели после /context до первого сообщения, а также потеря изменений пользовательских настроек при одновременном сохранении несколькими процессами Claude Code.
- 4Хуки и зафиксированные резервные модели: исправлена потеря переменных окружения, записанных хуком SessionStart, при выполнении claude -p
--continue, а также игнорирование зафиксированной модели Opus в терминальных сессиях Amazon Bedrock (Mantle), запущенных без выбранной модели. Со стороны сообщества разработчики на форумах и в X в период с 2026-11-19 по 2026-11-20 сообщали о полном исчерпании недельных лимитов подписки за 1–2 дня при сочетании флагманских координаторов с параллельными субагентами, что ускорило переход на схему разделения с координатором на Opus 5.5 и исполнителями на Sonnet или более дешёвых моделях.
Три контрольные точки: давление на квоты, исправления v2.1.330 и текущий ориентир
В период с 2026-11-19 по 2026-11-20 активные пользователи на форумах сообщества сообщали об исчерпании недельных лимитов подписки за 1–2 дня при параллельных мультиагентных запусках, достигая порога сессии примерно на 800k токенов; обсуждения быстро сместились к схеме с координацией в основном потоке и делегированием рутинных задач более дешёвым субагентам.
Релиз Claude Code v2.1.330 вышел 2026-11-20 и исправил преждевременное отключение общих MCP-серверов субагентов, обработку остановки фоновых субагентов, конкурентную запись пользовательских настроек и потерю переменных окружения хука SessionStart при работе claude -p --continue.
По состоянию на 2026-11-22 псевдонимы Anthropic API opus, sonnet, haiku и fable разрешаются в Opus 5.5, Sonnet 5.5, Haiku 5.5 и Fable 5.2; при работе через пользовательский шлюз фиксация всех трёх переменных псевдонимов по умолчанию и CLAUDE_CODE_SUBAGENT_MODEL в ~/.claude/settings.json служит стандартной защитой от ошибочной маршрутизации и непредвиденных расходов.
Подтверждённые факты из документации против частых заблуждений и сообщений сообщества
Подтверждено (документация Claude Code, заметки к выпуску v2.1.330 и официальные прайс-листы поставщиков)
- 1Шлюз и выбор модели: в официальной документации указано, что
ANTHROPIC_BASE_URLменяет адрес отправки запросов, а не модель, которая на них отвечает, и начиная с v2.1.196 функция Remote Control отключается, если переменная указывает на любой хост, отличный от api.anthropic.com. - 2Ограничения параллельности и описаний:
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS(v2.1.217+) ограничивает число одновременных субагентов на сессию значением 20 по умолчанию; переменнаяCLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION(ранее 200) удалена в v2.1.224 и больше не действует; суммарный объём описаний пользовательских субагентов свыше 15,000 токенов вызывает предупреждение при запуске. - 3Настройка моделей шлюза: для идентификаторов моделей, которые Claude Code не распознаёт,
CLAUDE_CODE_MAX_OUTPUT_TOKENSпо умолчанию равен 32000 при максимуме 128000;CLAUDE_CODE_MAX_CONTEXT_TOKENSпереопределяет предполагаемое контекстное окно;CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1заполняет список /model из /v1/models;CLAUDE_CODE_PROMPT_CACHE_TTL(v2.1.242+) принимает значения 5m или 1h. - 4Официальные тарифы API (за 1M токенов вход / выход): официальные ставки Anthropic составляют $8 / $40 для Claude Fable 5.2, $4 / $20 для Opus 5.5, $2 / $10 для Sonnet 5.5 и $0.10 / $0.50 для Haiku 5.5 при объёме до 100,000 токенов ($0.50 / $2.50 свыше 100,000 токенов). Официальные ставки Z.AI: GLM-5.3 — $1.4 за вход, $0.26 за кэшированный вход и $4.4 за выход; GLM-5.3-Flash — $0.15 за вход, $0.03 за кэшированный вход и $0.50 за выход.
Частые заблуждения и поведение, описанное в сообществе
- 1«Установка
ANTHROPIC_BASE_URLавтоматически выбирает рекомендованную модель шлюза» — неверно. Официальная документация подтверждает, что переменная меняет только конечную точку; если не зафиксироватьANTHROPIC_DEFAULT_*_MODEL, Claude Code будет отправлять несопоставленные значения по умолчанию или старые идентификаторы, которые шлюз отклонит. - 2«Экспорты оболочки всегда имеют приоритет над
settings.json» — неверно. В официальной документации указано, что при наличии переменной и в оболочке, и в блоке env файла настроек файл настроек записывает значение в окружение процесса и побеждает в большинстве сессий. - 3«Встроенный Explore по умолчанию всегда работает на Haiku» — неверно. Explore использует модель родительского диалога (или псевдоним opus, если родитель работает на Fable через подписку, Console или шлюз
ANTHROPIC_BASE_URL); чтобы перевести его на Haiku, задайтеCLAUDE_CODE_SUBAGENT_MODELили создайте пользовательский файл Explore в~/.claude/agents/ с параметром model: haiku. - 4«Переключение /model на Sonnet восстанавливает исчерпанный недельный лимит подписки» — участники сообщества отмечают, что 5-часовые и недельные лимиты общие для всех моделей; смена семейства помогает только при сообщении об ограничении конкретного семейства, например "You've hit your Opus limit".
- 5«Используйте
ANTHROPIC_SMALL_FAST_MODELдля фоновых задач» — устарело; в официальной документации эта переменная помечена как нерекомендуемая в пользуANTHROPIC_DEFAULT_HAIKU_MODEL.
Две схемы контроля расходов на субагентов: глобальное переопределение и маршрутизация по агентам
A: фиксация всех субагентов через CLAUDE_CODE_SUBAGENT_MODEL
Задайте CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5 (или claude-haiku-5-5) в блоке env файла settings.json, чтобы перевести Explore, Plan и всех пользовательских субагентов на один уровень. Одна строка исключает случайный расход Opus 5.5 или Fable 5.2 при фоновом делегировании, но не позволяет оставить более высокий уровень для специализированных субагентов проверки.
B: фиксация псевдонимов уровней и маршрутизация по агентам в ~/.claude/agents/
Оставьте глобальное переопределение незаданным, зафиксируйте ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL, затем создайте YAML frontmatter-файлы в ~/.claude/agents/ — например, переопределение Explore с model: haiku и code-reviewer с model: sonnet, а основной поток запускайте на opus или opusplan (Opus для планирования, Sonnet для выполнения). Изменения файлов применяются горячей перезагрузкой за считаные секунды без перезапуска.
Три шага: настройка шлюза и уровневой маршрутизации субагентов в ~/.claude/settings.json
- 1Откройте пользовательский файл
~/.claude/settings.json(в Windows: %USERPROFILE%\.claude\settings.json; для отдельного проекта используйте исключённый из git файл .claude/settings.local.json и никогда не сохраняйте учётные данные в коммитимый .claude/settings.json) и добавьте URL шлюза и ключ в блок "env": "ANTHROPIC_BASE_URL": "https://api.qcode.cc/api" (материковый Китай:https://asia.qcode.cc/api; Северная Америка и Европа:https://us.qcode.cc/api) и "ANTHROPIC_AUTH_TOKEN": "ваш-ключ-cr_". - 2В том же блоке "env" зафиксируйте основную модель, псевдонимы уровней и модель субагентов: "
ANTHROPIC_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5", "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-2" и "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-5-5" (илиclaude-haiku-5-5для задач с активным поиском; при желании добавьте "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1", чтобы загрузить /v1/models в /model). - 3Выполните быструю проверку в терминале: curl -sS -X POST "$
ANTHROPIC_BASE_URL/v1/messages" -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model": "claude-sonnet-5-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}' — JSON-ответ с "id":"msg_ и "content" подтверждает работу эндпоинта и ключа (при ошибке 401 проверьте переменную с ключом или выполните /logout для сброса старой авторизации). Запустите claude, выполните /status для проверки Anthropic base URL и Auth token и в любой момент переключайтесь с помощью /modelclaude-fable-5-2, /modelglm-5.3или /modelkimi-k3.1-pro(нажмите s в списке выбора, чтобы переключить модель только для текущей сессии).
Мультимодельный уровневый рабочий процесс с одним ключом QCode API
QCode.cc — независимый сервис доступа к API, не аффилированный с Anthropic, OpenAI или Z.AI. Указав в Claude Code переменную ANTHROPIC_BASE_URL равной https://api.qcode.cc/api (https://asia.qcode.cc/api для материкового Китая, https://us.qcode.cc/api для Северной Америки и Европы), вы можете одним ключом cr_ управлять всеми уровнями в едином рабочем процессе: запускать claude-opus-5-5 или claude-fable-5-2 в основном потоке для архитектуры и сложной отладки, назначать субагентам claude-sonnet-5-5 или claude-haiku-5-5 и переключаться через /model на glm-5.3, glm-5.3-flash, kimi-k3.1-pro или deepseek-v4.1-flash без переключения между аккаунтами провайдеров и без 5-часовых и недельных ограничений подписок.
Этот же ключ подключает Codex CLI (https://api.qcode.cc/openai) и OpenAI-совместимые клиенты (https://api.qcode.cc/openai/v1) к таким моделям, как gpt-6.2-sol и qwen3.8-max. Тарификация идёт за токены по актуальным ценам моделей на /models. Поддерживаются Visa / Mastercard, Apple Pay, Google Pay, Alipay, WeChat Pay, российские банковские карты и СБП, банковские карты стран СНГ и мультивалютный USDT в 18 сетях (комиссия платформы 0%, зачисление обычно за несколько минут и до 12 часов).
Не готовы к ежемесячному тарифу? «Разовые пакеты» от $4 дают разовую квоту на 7 дней; если у вас уже есть личный тариф, докупите бустер-пакет, когда потребуется дополнительная квота.
Часто задаваемые вопросы
В чём разница между ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_*_MODEL и CLAUDE_CODE_SUBAGENT_MODEL?
Каждая группа управляет отдельным уровнем: основной сессией, разрешением псевдонимов и субагентами. ANTHROPIC_MODEL задаёт основную модель сессии (приоритет выше поля model в настройках и ANTHROPIC_DEFAULT_MODEL, но ниже --model и /model). ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL и ANTHROPIC_DEFAULT_FABLE_MODEL определяют, в какой полный ID модели преобразуется каждый псевдоним (opus, sonnet, haiku, fable), при этом ANTHROPIC_DEFAULT_HAIKU_MODEL также отвечает за фоновые функции. CLAUDE_CODE_SUBAGENT_MODEL принудительно переводит Explore, Plan и всех пользовательских субагентов на одну модель.
Почему export переменных окружения для моделей в оболочке не сработал в Claude Code?
Чаще всего значение из оболочки перезаписывается блоком env в ~/.claude/settings.json (или управляемыми настройками). Согласно официальной документации, если одна и та же переменная задана и в оболочке, и в блоке env файла настроек, файл настроек записывается в окружение процесса и побеждает в большинстве сессий. Кроме того, /model (нажатие Enter сохраняет выбор по умолчанию для пользователя) и флаг --model переопределяют ANTHROPIC_MODEL. Храните переменные централизованно в блоке env файла ~/.claude/settings.json и проверяйте активные параметры командами /status и /model.
Как запретить встроенным субагентам Explore и Plan расходовать токены Opus или Fable?
Работают два прямых способа. Первый: задайте CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5 или claude-haiku-5-5 в блоке env файла ~/.claude/settings.json, чтобы перевести Explore, Plan и всех остальных субагентов на более дешёвый уровень. Второй: создайте Markdown-файл с именем Explore в ~/.claude/agents/ (уровень пользователя) или .claude/agents/ (уровень проекта) и укажите model: haiku в его YAML frontmatter, чтобы переопределить встроенного агента Explore. Параллельный запуск также можно ограничить с помощью CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (по умолчанию 20).
Как диагностировать ошибку 401 или ошибку неизвестной модели при работе через пользовательский шлюз?
Код 401 обычно указывает на несоответствие заголовка авторизации или устаревшую сессию входа, а ошибка неизвестной модели означает, что псевдоним разрешился в несопоставленный ID модели. ANTHROPIC_AUTH_TOKEN отправляет Authorization: Bearer и сразу переопределяет сохранённый вход claude.ai, тогда как ANTHROPIC_API_KEY отправляет x-api-key и запрашивает подтверждение один раз в интерактивном режиме. При 401 выполните /status для проверки активных учётных данных, выполните /logout при конфликте сохранённого входа и проверьте запрос через curl к "$ANTHROPIC_BASE_URL/v1/messages". При ошибке неизвестной модели зафиксируйте ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL на точных ID, которые обслуживает ваш шлюз, например claude-sonnet-5-5.
Требуется ли в QCode ежемесячная подписка и как работают пакеты и продление?
Ежемесячный тариф не требуется: QCode тарифицирует по токенам с актуальными ставками для каждой модели на /models. «Разовые пакеты» действуют 7 дней с лимитом одновременных запросов 5, отвечают кодом HTTP 402 при исчерпании квоты и HTTP 401 по истечении срока, а покупка нового пакета восстанавливает и суммирует квоту на том же API-ключе (средства за пакеты не возвращаются). Личный тариф работает по месячному циклу с возможностью докупить бустер-пакеты в течение срока действия, а истёкшие ключи личного тарифа нельзя продлить на месте — требуется выпустить новый ключ.
Какие способы оплаты, минимальные суммы пополнения и сроки зачисления поддерживает QCode?
QCode принимает международные банковские карты (Visa / Mastercard), Apple Pay, Google Pay, Alipay, WeChat Pay, российские банковские карты и СБП, банковские карты стран СНГ и мультивалютную криптовалюту (USDT в 18 сетях, комиссия платформы 0%, ручная ончейн-проверка, зачисление обычно за несколько минут и до 12 часов). Единая страница пополнения qcode.cc/recharge ведёт балансы в USD и CNY раздельно: пополнение в USD начинается от $5 (до $2,000 за транзакцию), а в CNY — от ¥30.
Источники
Официальная документация Claude Code: Model configuration (code.claude.com/docs/en/model-config), Environment variables (code.claude.com/docs/en/env-vars), Sub-agents (code.claude.com/docs/en/sub-agents) и LLM gateway connect (code.claude.com/docs/en/llm-gateway-connect); релиз Claude Code v2.1.330 (github.com/anthropics/claude-code/releases/tag/v2.1.330, 2026-11-20); Anthropic API Pricing (platform.claude.com/docs/en/about-claude/pricing); Z.AI Pricing (docs.z.ai/guides/overview/pricing); обсуждения сообщества на Reddit и X (с 2026-11-19 по 2026-11-20, использованы только как пользовательский контекст, а не официальная позиция). Всё проверено 2026-11-22.
Настройте уровневую маршрутизацию в settings.json и запускайте все уровни на одном ключе
Без ежемесячных обязательств: создайте аккаунт QCode для получения API-ключа cr_, добавьте его в ~/.claude/settings.json за 30 секунд и комбинируйте Opus 5.5, Sonnet 5.5, Haiku 5.5 и GLM-5.3 в одном рабочем процессе; актуальные тарифы — на /models.
Материалы по теме
«Разовые пакеты»: без ежемесячного тарифа, срок действия 7 дней
Купите разовую квоту на 7 дней или добавьте бустер-пакет к личному тарифу; ставки по моделям указаны на /models.
Настройка своего эндпоинта в Claude Code
Две переменные окружения, форма settings.json, apiKeyHelper и ограничение по веб-сессиям.
Claude Code 401 на своём базовом URL: разбор Invalid API Key (2026-11)
Проверено 2026-11-20: 401 на своём адресе имеет три формы, поэтому сначала прочитайте строки адреса и учётных данных в /status, затем блок env в settings.json, заголовок каждой переменной и /v1.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Документация Claude Code по настройке моделей, переменным окружения, субагентам и LLM-шлюзу, примечания к релизу v2.1.330, а также страницы тарифов Anthropic и Z.AI проверены 2026-11-22 и являются официальными источниками на code.claude.com, platform.claude.com, github.com/anthropics/claude-code и docs.z.ai. QCode.cc — независимый сервис доступа к API, не связанный с Anthropic, OpenAI или Z.AI и не одобренный ими. Доступность моделей QCode и актуальные ставки публикуются на qcode.cc/models.