Разбор CLAUDE_CODE_MAX_OUTPUT_TOKENS: ограничения вывода и папки плагинов в Claude Code 2.1.265

Что регулирует claude_code_max_output_tokens

Справочник переменных окружения описывает CLAUDE_CODE_MAX_OUTPUT_TOKENS как переменную, задающую «максимальное количество выходных токенов для большинства запросов». Эта формулировка важна: речь идёт о бюджете выходных токенов запроса, значения по умолчанию и верхние пределы которого зависят от модели.

Таким образом, эта переменная важна при исследовании ограничения на вывод Claude Code. Её не следует считать универсальным ограничением для всех типов данных, с которыми работает Claude Code. Версия 2.1.265 также вводит ограничение объёма сохранённых результатов инструментов на диске, но оно измеряет объём сохранённых данных инструментов в гигабайтах, а не сгенерированный вывод в токенах.

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

Для статьи, привязанной к определённой дате, наиболее надёжные числовые данные содержатся в примечаниях к выпуску с тегами версий. Эти примечания подтверждают конкретные более ранние изменения, не требуя выводить полную таблицу значений по умолчанию из текущей документации.

Три ограничения, которые следует различать

При диагностике ограничения сначала определите, какое из них действует. Настройку бюджета токенов и ограничение объёма хранения на диске нужно трактовать по-разному, даже если оба проявляются в одной сессии разработки.

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

В Примечания к выпуску v2.1.77, датированные 17 марта 2026 года, описывают два существенных изменения: значение по умолчанию для Claude Opus 4.6 увеличено до 64k выходных токенов, а верхний предел для Opus 4.6 и Sonnet 4.6 увеличен до 128k токенов. Эти изменения также сохранены в журнале изменений с тегом v2.1.265.

Эти данные исключают возможность представлять «32,000 по умолчанию, 64,000 максимум» как универсальное правило Claude Code. Они также не дают оснований заполнять отсутствующие значения по умолчанию для других моделей.

Важно чётко различать задокументированное изменение и полный справочник конфигурации. Мартовский выпуск подтверждает перечисленные выше изменения; доступные датированные источники не позволяют составить полную таблицу значений по умолчанию для каждой модели в v2.1.265.

Спецификации более новых моделей не определяют значения по умолчанию в CLI

В примечания к выпускам моделей указывают максимальный вывод в 128k токенов и контекстное окно на 1 млн токенов для Claude Sonnet 5, Claude Opus 5 и Claude Fable 5.1. Их точные идентификаторы API — claude-sonnet-5, claude-opus-5и claude-fable-5-1 соответственно.

Эти анонсы были доступны до даты отсечения для публикации: Sonnet 5 — 30 июня, Opus 5 — 24 июля, а Fable 5.1 — 1 сентября 2026 года. Однако спецификации этих моделей не подтверждают бюджет запроса по умолчанию в Claude Code.

Для разработчиков, выбирающих модель, руководстве по моделям Claude Code содержит дополнительные материалы. Различайте опубликованный максимум модели и бюджет выходных токенов по умолчанию, используемый CLI.

Настройка переменной и понимание сжатия контекста

Текущая документация предусматривает настройку переменной перед запуском claude или её размещение в разделе с ключом env в settings.json. Поскольку точную редакцию документации, доступную 10 сентября, восстановить не удалось, приведённые ниже примеры представляют задокументированные способы настройки с учётом этой исторической оговорки.

Настройка в оболочке

Приведённый пример для оболочки задаёт бюджет вывода в 64,000 токенов:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

Задокументированный способ — задать переменную перед запуском Claude Code. Число в этом примере является выбранным значением конфигурации; оно не означает, что 64,000 — значение по умолчанию или максимум для каждой модели.

При фиксации конфигурации проекта или сессии диагностики указывайте выбранную модель вместе с запрошенным бюджетом. Без модели одно лишь значение не позволяет определить, соответствует ли оно задокументированному значению по умолчанию или укладывается ли в задокументированный верхний предел.

Настройка в settings.json

В приведённом эквивалентном примере JSON переменная размещается в разделе env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

В этом примере значение является строкой. Как и настройка в оболочке, этот фрагмент задаёт запрошенный бюджет, а не подтверждает значение по умолчанию для конкретной модели.

Сведения об использовании командной строки приведены в справочнике CLI Claude Code. Исторические данные здесь подтверждают назначение переменной и приведённые примеры конфигурации, но полный набор значений по умолчанию для v2.1.265 остаётся неустановленным.

Что подтверждено относительно сжатия контекста?

Журнал изменений с тегом v2.1.265 содержит запись о более раннем исправлении в v2.1.69, устраняющем игнорирование CLAUDE_CODE_MAX_OUTPUT_TOKENS при сжатии контекста беседы. Это подтверждённая связь между данной настройкой и поведением при сжатии контекста.

Текущий справочник переменных окружения также объясняет, что увеличение этого значения уменьшает объём контекста, фактически доступного до автоматического сжатия. Дата публикации этого объяснения неизвестна, поэтому его нельзя представлять как подтверждённое описание по состоянию на 10 сентября.

Поэтому эту настройку не следует описывать как увеличивающую опубликованный размер контекстного окна модели. Датированные данные подтверждают управление бюджетом вывода и исправление, связанное со сжатием контекста; они не устанавливают точный порог сжатия для каждой модели в v2.1.265.

Как Claude Code 2.1.265 загружает папки плагинов

Claude Code v2.1.265 выпущен 8 сентября 2026 года с коммитом выпуска 8e02f6d. Изменение механизма загрузки папок позволяет --plugin-dir указывать на папку, содержащую несколько плагинов.

Приведённая команда запуска:

claude --plugin-dir ./plugins

В описании выпуска прямо сформулировано правило обнаружения: «загружается каждая дочерняя папка с манифестом». Там также указано, что добавления и удаления обнаруживаются во время работы Claude Code.

Таким образом, родительская папка становится удобной единицей управления несколькими плагинами. Задокументированное поведение относится к дочерним папкам, содержащим манифесты; примечания к выпуску не указывают на рекурсивное обнаружение. Не предполагайте, что поиск будет охватывать дерево каталогов с произвольной глубиной вложенности.

Расположение манифеста и историческая оговорка

Текущий справочник плагинов указывает, что манифест размещается в .claude-plugin/plugin.json , а каталоги компонентов, такие как skills/, commands/и hooks/ , — в корне плагина. Восстановить этот справочник в виде датированного снимка для v2.1.265 не удалось.

В статье за 10 сентября следует отличать эти актуальные рекомендации по структуре от явной гарантии выпуска: дочерние папки с манифестами загружаются. Выпуск подтверждает обнаружение нескольких плагинов в папке, но не устанавливает все детали документации по структуре, действовавшей в тот момент.

Исправления плагинов, включённые в выпуск

Версия 2.1.265 также исправляет три проблемы с плагинами:

• Путь плагина, содержащий обратные косые черты, мог обходить проверку того, что символическая ссылка остаётся в пределах разрешённого каталога, на macOS и Linux.
• Каталоги, имена которых начинались с двух точек, ошибочно отклонялись.
• Недоступные для чтения стандартные папки компонентов молча пропускались; теперь они отображаются в /plugin с кодом ошибки.

Эти исправления касаются путей плагинов и загрузки компонентов. Если папка плагина не загружается, они дают полезный контекст выпуска, но настройка выходных токенов не объясняет эти проблемы обработки каталогов.

Ограничение в 1 ГБ для сохранённых результатов инструментов — отдельный предел

Версия 2.1.265 добавляет ограничение в 1 ГБ для результатов инструментов, сохраняемых на диск. Предварительный просмотр беседы сообщает об усечении.

Это ограничение относится к сохранённым данным инструментов. CLAUDE_CODE_MAX_OUTPUT_TOKENS относится к максимальному количеству выходных токенов для большинства запросов. В описании выпуска переменная окружения не представлена как средство управления ограничением объёма на диске, поэтому увеличение её значения не следует предлагать как способ устранения усечения сохранённых результатов инструментов.

Примечания к выпуску также не уточняют, применяется ли ограничение в 1 ГБ к каждому результату, к каждой сессии или к иной группе данных. При описании поведения сохраняйте эту неопределённость: подтверждённая формулировка — «ограничение в 1 ГБ для результатов инструментов, сохраняемых на диск».

При диагностике полезно различать признаки, которые видит разработчик. Сообщение об усечении в предварительном просмотре беседы связано с новым поведением сохранения результатов. Вопрос о бюджете сгенерированного вывода модели следует рассматривать в связи с выбранной моделью и настройкой токенов. Код ошибки плагина в /plugin относится к загрузке плагинов.

Это отдельные механизмы управления и диагностики, появившиеся или обсуждавшиеся в контексте одного и того же выпуска. Их раздельное рассмотрение не позволяет объяснять изменением настройки токенов не связанное с ним поведение хранилища или папок.

Последующее исправление шлюза, доступное к 10 сентября

Версия 2.1.266 также вышла 8 сентября, поэтому она входит в период, рассматриваемый в этой статье. В Примечания к выпуску v2.1.266 исправлена регрессия аутентификации шлюза в v2.1.265, связанная с CLAUDE_CODE_USE_GATEWAY.

Речь идет об ошибке «Не выполнен вход в облачный шлюз». В описании выпуска указано, что изменение конфигурации не требуется.

Для разработчика, столкнувшегося именно с этой регрессией в v2.1.265, последующий выпуск имеет прямое значение. Увеличение бюджета выходных токенов или реорганизация папок плагинов не являются документированным исправлением.

Те же рабочие процессы могут выполняться через API-шлюз, например AI Prime Tech; см. использование Claude Code с ключом API для получения соответствующих рекомендаций по настройке. AI Prime Tech работает независимо и не связан с Anthropic или OpenAI.

Основные выводы

• CLAUDE_CODE_MAX_OUTPUT_TOKENS задает максимальное количество выходных токенов для большинства запросов; значения по умолчанию и предельные значения зависят от модели.
• В v2.1.77 значение по умолчанию для Opus 4.6 увеличено до 64k, а верхний предел для Opus 4.6/Sonnet 4.6 — до 128k. Полная таблица значений по умолчанию для v2.1.265 остается неподтвержденной.
• Максимальный объем вывода модели, емкость ее контекста и объем хранилища сохраненных результатов инструментов — отдельные ограничения.
• В v2.1.265 --plugin-dir может загружать несколько плагинов из дочерних папок с манифестами и обнаруживать добавление и удаление плагинов во время работы.
• В v2.1.265 введен лимит в 1 ГБ для сохраненных результатов инструментов; в v2.1.266 исправлена регрессия аутентификации шлюза, причем изменение конфигурации не требуется.

Частые вопросы

Что регулирует CLAUDE_CODE_MAX_OUTPUT_TOKENS?

CLAUDE_CODE_MAX_OUTPUT_TOKENS задает максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и предельные значения зависят от модели; эта настройка не связана с введенным в v2.1.265 лимитом в 1 ГБ для результатов инструментов, сохраняемых на диск.

Каковы ограничения вывода по умолчанию и максимальные ограничения?

В v2.1.77 значение по умолчанию для Claude Opus 4.6 увеличено до 64k выходных токенов, а верхний предел для Opus 4.6/Sonnet 4.6 — до 128k. Рассмотренные источники с указанными датами не позволяют установить значение по умолчанию для Sonnet 4.6 или составить полную таблицу значений по умолчанию для каждой модели в v2.1.265.

Увеличивает ли повышение значения настройки окно контекста?

Документированное назначение настройки — задать бюджет выходных токенов, а не увеличить опубликованный размер окна контекста модели. В v2.1.69 исправлено игнорирование переменной при сжатии контекста, однако дата публикации объяснения ее влияния на автоматическое сжатие контекста в текущей документации неизвестна.

Как --plugin-dir обнаруживает несколько плагинов?

В Claude Code 2.1.265 --plugin-dir может указывать на родительскую папку, при этом загружается каждая дочерняя папка с манифестом. Добавление и удаление обнаруживаются во время работы Claude Code; рекурсивное обнаружение в примечаниях к выпуску не описано.