Руководство по настройке · По состоянию на 2026-11-22

Переменные окружения 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 и китайских моделей.

#CLAUDE_CODE_SUBAGENT_MODEL#ANTHROPIC_DEFAULT_*_MODEL#v2.1.330#settings.json env

Четыре ключевых факта, которые важно знать в первую очередь

5 базовых переменных

Основная модель, три псевдонима уровней и глобальное переопределение для субагентов

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.

$0.10 / $4

Разница официальных ставок 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. Использование флагманской модели в основном потоке и перевод поисковых субагентов на более лёгкие уровни радикально меняют расходы за сессию.

v2.1.330

Выпуск от 2026-11-20 с исправлениями субагентов и переключения моделей

В Claude Code v2.1.330 исправлено преждевременное завершение работы MCP-серверов, объявленных субагентами, пока их используют другие субагенты, проблема с выходом остановленных фоновых субагентов из состояния остановки, устаревшие инструкции системного промпта после переключения модели вслед за /context, а также потеря переменных окружения из хука SessionStart при запуске claude -p --continue.

~/.claude/settings.json

Глобальный блок 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. 1Жизненный цикл MCP субагентов: исправлено отключение MCP-сервера, объявленного субагентами, при завершении одного субагента, пока другие субагенты или сессия всё ещё его используют.
  2. 2Состояние фоновых субагентов: исправлено поведение, при котором остановленные фоновые субагенты не всегда оставались остановленными, а также ожидание со стороны Claude фонового агента, остановленного в момент завершения в сессиях приложения или SDK.
  3. 3Переключение моделей и настройки: исправлено сохранение инструкций предыдущей модели в системном промпте при смене модели после /context до первого сообщения, а также потеря изменений пользовательских настроек при одновременном сохранении несколькими процессами Claude Code.
  4. 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-19 по 2026-11-20 активные пользователи на форумах сообщества сообщали об исчерпании недельных лимитов подписки за 1–2 дня при параллельных мультиагентных запусках, достигая порога сессии примерно на 800k токенов; обсуждения быстро сместились к схеме с координацией в основном потоке и делегированием рутинных задач более дешёвым субагентам.

2026-11-20

Релиз Claude Code v2.1.330 вышел 2026-11-20 и исправил преждевременное отключение общих MCP-серверов субагентов, обработку остановки фоновых субагентов, конкурентную запись пользовательских настроек и потерю переменных окружения хука SessionStart при работе claude -p --continue.

2026-11-22

По состоянию на 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. 1Шлюз и выбор модели: в официальной документации указано, что ANTHROPIC_BASE_URL меняет адрес отправки запросов, а не модель, которая на них отвечает, и начиная с v2.1.196 функция Remote Control отключается, если переменная указывает на любой хост, отличный от api.anthropic.com.
  2. 2Ограничения параллельности и описаний: CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (v2.1.217+) ограничивает число одновременных субагентов на сессию значением 20 по умолчанию; переменная CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION (ранее 200) удалена в v2.1.224 и больше не действует; суммарный объём описаний пользовательских субагентов свыше 15,000 токенов вызывает предупреждение при запуске.
  3. 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. 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. 1«Установка ANTHROPIC_BASE_URL автоматически выбирает рекомендованную модель шлюза» — неверно. Официальная документация подтверждает, что переменная меняет только конечную точку; если не зафиксировать ANTHROPIC_DEFAULT_*_MODEL, Claude Code будет отправлять несопоставленные значения по умолчанию или старые идентификаторы, которые шлюз отклонит.
  2. 2«Экспорты оболочки всегда имеют приоритет над settings.json» — неверно. В официальной документации указано, что при наличии переменной и в оболочке, и в блоке env файла настроек файл настроек записывает значение в окружение процесса и побеждает в большинстве сессий.
  3. 3«Встроенный Explore по умолчанию всегда работает на Haiku» — неверно. Explore использует модель родительского диалога (или псевдоним opus, если родитель работает на Fable через подписку, Console или шлюз ANTHROPIC_BASE_URL); чтобы перевести его на Haiku, задайте CLAUDE_CODE_SUBAGENT_MODEL или создайте пользовательский файл Explore в ~/.claude/agents/ с параметром model: haiku.
  4. 4«Переключение /model на Sonnet восстанавливает исчерпанный недельный лимит подписки» — участники сообщества отмечают, что 5-часовые и недельные лимиты общие для всех моделей; смена семейства помогает только при сообщении об ограничении конкретного семейства, например "You've hit your Opus limit".
  5. 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. 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. 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. 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 и в любой момент переключайтесь с помощью /model claude-fable-5-2, /model glm-5.3 или /model kimi-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.

Материалы по теме

Оплата криптовалютой

Девять монет, 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.

Не знаете, с чего начать?

Попробовать неделю

Пакет «Малый» — $4: квота $30 на 7 дней

Работаете каждый день

«Стартовый» — $9.00 в месяц и $5 квоты каждый день: всего $0.060 за $1 квоты, у пакета «Средний» — около $0.113