Claude Code 2.1.323: ошибка контекста 1M у неизвестных моделей

В Claude Code 2.1.323 неизвестные Model ID получили контекст 1M вместо 200K, и запросы к шлюзам с меньшим окном могли начать падать на каждом ходе. Проверьте исправление 2.1.325, задайте реальный предел через CLAUDE_CODE_MAX_CONTEXT_TOKENS или настройте раннее автосжатие. Примеры для BetterToken, DeepSeek и Kimi, правила [1m], приоритет настроек и восстановление переписки.

Содержание
Claude Code 2.1.323: ошибка контекста 1M у неизвестных моделей

В Claude Code 2.1.323 контекстное окно для неизвестных Model ID по умолчанию выросло с 200K до 1M токенов. Если сторонняя модель или API-шлюз принимает меньше токенов, Claude Code может слишком поздно сжать историю, после чего запросы начинают постоянно завершаться ошибкой. Обновите Claude Code до 2.1.325 или новее, затем задайте реальное контекстное окно модели либо более ранний порог автосжатия.

Правильное решение зависит от фактического лимита модели и шлюза. Не нужно автоматически ограничивать все сессии с DeepSeek, GLM или Kimi до 200K. Некоторые модели поддерживают контекст 1M. Искусственное ограничение такого окна заставит Claude Code раньше сокращать историю работы с проектом.

Ниже разберём изменения версий 2.1.323–2.1.325, три способа настройки и восстановление сессии, которая уже перестала принимать запросы.

Что изменилось в Claude Code 2.1.323, 2.1.324 и 2.1.325?

Версия 2.1.323 изменила предполагаемый размер контекста для неизвестных моделей. В двух следующих выпусках Anthropic исправила связанные проблемы с идентификаторами моделей и ошибками шлюзов.

В официальном CHANGELOG Claude Code перечислены такие изменения:

ВерсияИзменениеДействие
2.1.323Для неизвестных Model ID теперь предполагается окно 1M вместо 200K.Проверьте фактический лимит модели перед длительной сессией.
2.1.323При переполнении контекста сторонней модели каждый следующий запрос может завершаться ошибкой вплоть до /clear.Настройте окно до переполнения истории.
2.1.324CLAUDE_CODE_MAX_CONTEXT_TOKENS начал применяться и к неизвестным идентификаторам с префиксом claude-.Обновите клиент, если шлюз использует такой псевдоним модели.
2.1.325Исправлены повторяющиеся ошибки длины контекста вместо сжатия на многих сторонних шлюзах и в Foundry.Сначала попробуйте обновление, затем остальные настройки.

По состоянию на 2026-11-15 у пакета @anthropic-ai/claude-code в npm тег latest указывает на 2.1.325, а stable — на 2.1.311.

В стабильной версии 2.1.311 нового поведения из 2.1.323 ещё нет. Но и последующие исправления в ней отсутствуют.

Проверьте установленную версию в терминале:

claude --version

Если Claude Code установлен нативным способом, используйте штатную команду обновления:

claude update
claude --version

Если вы намеренно используете канал stable, сначала проверьте версию установленного клиента. Не меняйте настройки только потому, что новая версия появилась в latest.

Исправление 2.1.325 касается многих сторонних шлюзов. Anthropic не гарантирует, что оно устранит проблему на любом API-маршруте или определит реальный лимит вышестоящей модели.

Почему неизвестный Model ID может сломать длинную сессию?

Claude Code определяет момент сжатия истории по известным ему моделям и настройкам контекстного окна.

Автосжатие сокращает предыдущие сообщения, чтобы следующий запрос поместился в контекст модели. Если шлюз передаёт неизвестный идентификатор, Claude Code не всегда может определить реальный размер окна.

Предположим, шлюз предоставляет модель под именем my-coding-model. Её фактический лимит — 200,000 токенов.

До 2.1.323 Claude Code предполагал для такого неизвестного ID окно 200K. Начиная с 2.1.323 он предполагает 1M, если другая настройка не меняет это значение.

При этом сама модель не получила больший контекст. Изменилась только оценка внутри Claude Code.

История переписки может превысить лимит шлюза раньше, чем клиент запустит сжатие. API отклоняет запрос, но переполненная история остаётся в сессии. Поэтому следующий запрос может завершиться той же ошибкой.

Anthropic описала этот сценарий в CHANGELOG 2.1.323. Исправление 2.1.325 улучшает восстановление на многих шлюзах, однако для маршрутов с меньшим окном по-прежнему полезно задать правильный лимит.

Какие идентификаторы моделей попадают в группу риска?

Проблема возникает, когда предполагаемое окно Claude Code больше того, которое фактически принимает модель или шлюз.

Проверьте такие случаи:

  • Сторонняя модель с ID вроде deepseek-v4.1-flash-1017 или kimi-k3.1-pro, если Claude Code не распознаёт этот идентификатор.
  • Псевдоним шлюза, например my-coding-model, даже если за ним работает настоящая модель Claude.
  • Неизвестный ID с префиксом claude-, например claude-sonnet-latest. Для таких имён важно изменение из 2.1.324.
  • ID с суффиксом [1m]. Для него действуют отдельные правила переопределения окна.

Неизвестный ID сам по себе ещё не означает ошибку контекста.

Если модель и API-маршрут действительно принимают 1M токенов, новый размер окна может подходить. Ошибка появляется, когда реальный предел модели, прокси или развёртывания ниже.

Псевдоним известной модели Claude также отличается от имени совершенно другой модели. Иногда Claude Code распознаёт модель внутри составного идентификатора провайдера. От этого зависит действие переменных настройки.

Перед изменением параметров сверьтесь с официальными правилами определения окна для пользовательских Model ID.

Как исправить неверное контекстное окно?

Если реальный лимит известен, начните с CLAUDE_CODE_MAX_CONTEXT_TOKENS. Для быстрого ограничения до 200K используйте CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Если нужен запас до переполнения, настройте более раннее автосжатие.

СпособКогда подходитОграничения
CLAUDE_CODE_DISABLE_1M_CONTEXT=1Шлюз принимает не менее 200K токенов, а вам нужно вернуть прежнее ограничение.Ограничивает некоторые модели с настоящим окном 1M до 200K. Не решает проблему моделей с окном меньше 200K.
CLAUDE_CODE_MAX_CONTEXT_TOKENSИзвестен реальный лимит модели или шлюза.Применение зависит от распознавания Model ID, версии клиента и суффикса [1m].
/autocompact, --autocompact или CLAUDE_CODE_AUTO_COMPACT_WINDOWНужно сжимать историю раньше предполагаемой границы.Диапазон настройки начинается с 100K. Порог должен соответствовать реальному лимиту.

Эти способы управляют разными параметрами. Первый ограничивает окно до 200K, второй задаёт размер окна, а третий определяет момент сжатия истории.

Способ 1. Вернуть ограничение 200K

Если ваш API-маршрут принимает не менее 200K токенов, запустите Claude Code с переменной:

export CLAUDE_CODE_DISABLE_1M_CONTEXT=1
claude

Именно это временное решение Anthropic предложила в CHANGELOG 2.1.323.

Чтобы сохранить настройку между запусками, добавьте переменную в раздел env файла ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
  }
}

При включённой переменной Claude Code также убирает варианты [1m] из списка выбора моделей.

Для моделей с собственным окном 1M и включённым автосжатием клиент ограничивает сессию границей 200K. Если автосжатие отключено, при достижении границы вместо сжатия возникает ошибка лимита контекста.

Но для неизвестных моделей возможны исключения. Другие переменные могут мешать удерживать историю в пределах 200K.

Обратите внимание на предупреждение:

CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it.

Если оно появилось, проверьте, не задано ли слишком большое значение CLAUDE_CODE_MAX_CONTEXT_TOKENS. Также проверьте, не отключено ли ограничение окна для неизвестных моделей.

В документации ошибок Claude Code Anthropic предлагает установить CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000, если нужно принудительно удерживать сессию в этих пределах.

Если реальное окно меньше 200K, одной переменной CLAUDE_CODE_DISABLE_1M_CONTEXT=1 недостаточно.

Способ 2. Указать реальное окно через CLAUDE_CODE_MAX_CONTEXT_TOKENS

Когда фактический лимит известен, лучше явно сообщить его Claude Code.

Допустим, администратор вашего шлюза подтвердил ограничение конкретного маршрута в 200,000 токенов. В Bash задайте переменную перед запуском клиента:

export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
claude

Значение 200,000 здесь условное. Это пример настройки для шлюза с подтверждённым лимитом, а не универсальная рекомендация для DeepSeek, GLM или Kimi.

Если Claude Code не распознаёт ID без префикса claude- и суффикса [1m], переменная применяется напрямую. При этом сохраняется автоматическое сжатие на основе заданного окна.

В документации условий применения CLAUDE_CODE_MAX_CONTEXT_TOKENS описаны два важных исключения:

  • Для неизвестного ID с [1m] дополнительно установите CLAUDE_CODE_DISABLE_1M_CONTEXT=1, если нужно уменьшить окно и сохранить автосжатие.
  • Для ID, который Claude Code распознаёт как известную модель Claude, переопределение работает только вместе с DISABLE_COMPACT. Эта переменная полностью отключает сжатие, поэтому для обычной длинной сессии такой вариант нежелателен.

Начиная с 2.1.324 можно напрямую переопределять окно неизвестных ID с префиксом claude-. В более ранних версиях поведение отличается.

Если шлюз использует собственное имя для настоящей модели Claude, можно задать соответствие через modelOverrides или modelPicker.behavesAs. Тогда Claude Code будет обрабатывать псевдоним как известную модель.

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

Для настройки нужен реальный лимит конкретного API-маршрута. Если прокси принимает меньше токенов, чем указано в характеристиках модели, ориентируйтесь на ограничение прокси.

Способ 3. Запускать автосжатие раньше через /autocompact

Ранний порог сжатия помогает сохранить запас контекста до того, как шлюз начнёт отклонять запросы.

Для маршрута с подтверждённым окном 200K можно использовать такой пример:

/autocompact 150k

Введите команду внутри Claude Code. Обычно она сохраняет порог для текущей модели в modelSettings и применяет его к открытой сессии.

Проверьте ответ /autocompact, прежде чем считать настройку активной. Если в настройках более высокого приоритета, например управляемых администратором, задан другой порог, команда сохранит ваше значение, но сессия продолжит использовать прежнее. Claude Code сообщит об этом в ответе.

В таком случае обратитесь к администратору, чтобы проверить политику. Согласно документации настройки автосжатия, флаг --autocompact для отдельного запуска не перекрывается управляемыми настройками.

Для одного запуска используйте:

claude --autocompact 150k

Для скрипта, контейнера или другой автоматизированной среды можно задать переменную:

export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
claude

Команда /autocompact и флаг --autocompact принимают значения от 100K до 1M токенов. Для CLAUDE_CODE_AUTO_COMPACT_WINDOW допустим диапазон 100000–1000000.

Если значение переменной допустимо, она имеет приоритет над командой, флагом и сохранёнными настройками. При активной переменной /autocompact сообщает о переопределении и не сохраняет новый порог.

Для всех моделей можно задать autoCompactWindow в ~/.claude/settings.json. Однако значение, сохранённое через /autocompact для конкретной модели, имеет приоритет над общим параметром в том же файле.

Порог 150k приведён как пример запаса для окна 200K. Не переносите его на модели с меньшим лимитом без проверки.

Минимальное настраиваемое значение — 100K. Если окно вашей модели меньше 100K, учитывайте правила переопределения Model ID и ограничения клиента. Не рассчитывайте, что /autocompact 50k будет поддерживаться.

Пример BetterToken: подключаем DeepSeek или Kimi к Claude Code

Для поддерживаемых моделей BetterToken предоставляет Anthropic-совместимый API по адресу https://bettertoken.ai. В ANTHROPIC_BASE_URL для Claude Code не нужно добавлять /v1.

При этом нужно различать документацию BetterToken и официальную поддержку Anthropic. В документации LLM-шлюзов Anthropic прямо указывает, что не поддерживает маршрутизацию Claude Code к моделям других производителей через какой-либо шлюз.

BetterToken описывает собственное стороннее подключение. Это не делает работу Claude Code с DeepSeek или Kimi официально поддерживаемым Anthropic сценарием. Совместимость инструментов, передачу вызовов и ограничения шлюза проверяйте отдельно.

По состоянию на 2026-11-15 документация и каталог BetterToken содержат следующие сведения:

BetterToken Model IDЗаявленный контекст моделиДоступ через Anthropic Messages
deepseek-v4.1-flash-10171M токеновУказан
kimi-k3.1-pro1M токеновУказан
glm-5.31M токеновДля этой модели не указан; в записи каталога есть OpenAI-совместимый доступ
qwen3.8-max1,000,000 токеновДля этой модели не указан; в записи каталога есть OpenAI-совместимый доступ

Эти модели нельзя автоматически считать примерами контекста меньше 1M. Но фактический лимит может зависеть от используемого API-маршрута.

Наличие модели в каталоге BetterToken также не означает поддержку всех протоколов. Перед настройкой Claude Code проверьте актуальный каталог моделей и тарифов.

Есть и дополнительная оговорка для читателей русской версии. В русскоязычном описании Claude Code API BetterToken сообщает, что работу DeepSeek и GLM внутри Claude Code пока не проверяли. Для них там рекомендуются инструменты с OpenAI-совместимым API.

При этом отдельная документация DeepSeek V4.1 Flash 1017 описывает маршрут Anthropic Messages. Это подтверждает наличие задокументированного API-маршрута, но не полную совместимость Claude Code со всеми возможностями модели. Следующий пример следует использовать для проверки подключения, а не считать гарантией работы длительной агентной сессии.

Для примера используем deepseek-v4.1-flash-1017, у которого в каталоге указан Anthropic-совместимый маршрут. Настройка основана на инструкции BetterToken для Claude Code.

Сначала установите Claude Code и создайте собственный BetterToken API Key. Затем выполните команды в отдельной сессии Bash:

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY

export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash-1017"

export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"

unset CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT

claude -p "Reply with only: OK"
claude

Первая команда ожидает ввод API-ключа. Введите его и нажмите Enter. Bash не выводит введённое значение на экран.

Переменная ANTHROPIC_AUTH_TOKEN передаёт ключ Claude Code. Три переменные ANTHROPIC_DEFAULT_*_MODEL направляют встроенные роли Haiku, Sonnet и Opus на выбранную модель BetterToken. При необходимости для этих ролей можно настроить разные поддерживаемые модели.

Чтобы использовать Kimi, выберите kimi-k3.1-pro до выполнения трёх команд экспорта ролей.

Если вы уже запустили пример с DeepSeek, повторите четыре команды в той же сессии Bash перед запуском нового процесса Claude Code:

export ANTHROPIC_MODEL="kimi-k3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"

Если изменить только ANTHROPIC_MODEL, уже сохранённые значения трёх переменных ролей останутся прежними. Поэтому вызовы этих ролей могут продолжить использовать DeepSeek. Идентификатор Kimi и способ подключения приведены в документации Kimi K3.1 Pro от BetterToken.

Для неизвестного ID без [1m] можно дополнительно указать фактическое окно. Если выбранный маршрут действительно принимает 1,000,000 токенов:

export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000

Установите переменную до запуска Claude Code. Если шлюз ограничивает контекст меньшим значением, замените 1000000 его подтверждённым лимитом.

При необходимости задайте более ранний порог сжатия.

Следующий пример предназначен только для условного шлюза с подтверждённым лимитом 200K. Не применяйте его автоматически к DeepSeek или Kimi:

# Example only: the gateway's verified limit is 200000 tokens.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000

Первая переменная задаёт предполагаемое окно модели. Вторая запускает автосжатие заранее. Для другого шлюза оба значения нужно подобрать по его реальному ограничению.

Разработчикам из России полезно учитывать границу между API и самим инструментом. BetterToken указывает, что к его API Endpoint можно подключаться из России без VPN и пополнять баланс в рублях. Это не гарантирует доступ к сайтам Anthropic, загрузке Claude Code, входу в сторонние аккаунты или обновлениям клиента. Доступные способы оплаты и условия пополнения проверяйте в личном кабинете BetterToken во время платежа.

Как проверить модель и маршрут запросов?

После запуска Claude Code выполните:

/status

Найдите строку Anthropic base URL. В ней должен отображаться https://bettertoken.ai.

Затем проверьте, что для аутентификации используется ANTHROPIC_AUTH_TOKEN, а не сохранённый вход в claude.ai.

Посмотрите, какая модель активна. При необходимости выберите нужный Model ID через /model.

Если вы изменили переменные ролей, перезапустите Claude Code. Новый процесс должен получить обновлённое окружение Bash.

Команда claude -p "Reply with only: OK" из примера проверяет базовое подключение. Нормальный ответ означает, что короткий запрос прошёл. Он ничего не доказывает о возможности обработать контекст размером 1M.

Для проверки работы с кодом попросите Claude Code прочитать небольшой файл из репозитория и объяснить конкретную функцию, не изменяя её. Убедитесь, что ответ относится к нужному файлу.

Если короткий запрос завершается ошибкой авторизации или подключения, сначала исправьте её. Для HTTP 403 и сетевых проблем используйте инструкцию по диагностике Claude Code 403.

Дополнительные проверки моделей и подключения приведены в руководстве по Claude Code с DeepSeek Flash и Pro. Особенности Kimi описаны в руководстве по Kimi K3.1 Pro для программирования.

Что делать, если каждый запрос уже завершается ошибкой?

Сначала проверьте, действительно ли шлюз отклоняет запрос из-за длины контекста. CHANGELOG 2.1.323 предупреждает о повторяющихся сбоях, но не приводит единую строку ошибки.

Разные шлюзы могут возвращать разные сообщения. В документации Anthropic по ошибкам шлюзов приведены, например, такие варианты:

ContextWindowExceededError

и:

prompt token count of N exceeds the limit of M

Это примеры сообщений на стороне шлюза. Они не обозначены Anthropic как обязательные ошибки версии 2.1.323.

Постарайтесь восстановить работу без немедленного удаления истории:

  1. Если сессия ещё доступна, сохраните состояние задачи вне переписки. Запишите изменённые файлы, результаты тестов и следующий шаг.
  2. Обновите Claude Code до 2.1.325 или новее. Проверьте установленную версию.
  3. Уточните фактический лимит шлюза. Перед новым запуском задайте CLAUDE_CODE_MAX_CONTEXT_TOKENS либо подходящий порог автосжатия.
  4. Если текущая сессия отвечает на команды, попробуйте вручную выполнить /compact.
  5. Если продолжить работу или сжать историю не удаётся, используйте /clear и восстановите задачу по сохранённым заметкам.

Проблема может сохраняться, если шлюз возвращает ошибку превышения контекста в нестандартном формате. Тогда Claude Code не всегда распознаёт причину и не запускает автоматическое восстановление.

Исправление 2.1.325 помогает на многих шлюзах, но Anthropic не публикует исчерпывающий список совместимых маршрутов.

Если ручное сжатие тоже не работает, используйте подробный разбор восстановления Claude Code и DeepSeek после ошибки длины запроса.

Не устанавливайте CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 как универсальное решение. Эта переменная отключает предварительное автосжатие для неизвестных ID. Клиенту приходится ждать ошибки API, которую он сможет распознать. Если шлюз меняет её формат, восстановление становится менее надёжным.

Почему в старых инструкциях для неизвестных моделей указано 200K?

Документация менялась вместе с выпусками Claude Code.

В материалах, полученных 2026-11-13, раздел настройки неизвестных моделей ещё содержал предположение 200K. Но при проверке актуальной страницы настройки моделей 2026-11-15 предупреждение уже содержало context assumed to be 1m tokens.

Поэтому не ориентируйтесь на старую строку с 200K как на описание текущего поведения.

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

Если модель распознана или окно задано правильно, предупреждение о неизвестном ID может исчезнуть. Это подтверждает применение настройки клиентом, но не доказывает, что шлюз обработает запрос на весь заявленный объём.

Какую конфигурацию выбрать?

Если неизвестная модель работает через шлюз с окном меньше 1M, используйте Claude Code 2.1.325 или новее и задайте подтверждённый размер контекста. При необходимости добавьте ранний порог автосжатия.

Если шлюз принимает ровно 200K, CLAUDE_CODE_DISABLE_1M_CONTEXT=1 подходит как быстрое временное решение. Для точного контроля лучше явно задать окно и порог сжатия.

Если модель и маршрут действительно поддерживают 1M, не уменьшайте окно без причины. Сократите его, только если хотите более короткую историю или шлюз применяет меньший лимит.

Для неизвестных ID с [1m] и для распознаваемых Claude-моделей действуют особые правила. Не рассчитывайте, что одна переменная CLAUDE_CODE_MAX_CONTEXT_TOKENS изменит окно во всех случаях.

Главное — согласовать размер контекста, который предполагает Claude Code, с реальным лимитом вашего API-маршрута.

Готовы оптимизировать LLM workflow?

Подключите единый API, управляйте ключами и контролируйте расходы на AI-модели в BetterToken.

Начать бесплатно