Советы по экономии токенов в Claude Code и что происходит при достижении лимита

Одно из первых наблюдений при работе с Claude Code — как стремительно расходуются токены. Знакомая мысль: «Я лишь отредактировал один файл — и лимит уже исчерпан»?

В этой статье разберём, почему Claude Code потребляет столько токенов, рассмотрим 10 практических способов экономии и объясним, что происходит при достижении лимита и как работает дополнительная тарификация.

Как использовать вместо Claude модели DeepSeek, GLM, Kimi и другие из Claude Code, чтобы снизить расходы, и на что обратить внимание (кэш, тарификация поиска, куда отправляется код), описано в статье Как использовать DeepSeek, GLM и Kimi в Claude Code.

1. Почему Claude Code потребляет так много токенов

В отличие от обычного чата, Claude Code — это агентная система. Одна инструкция пользователя запускает множество внутренних API-вызовов для выполнения задачи.

Конкретные причины высокого расхода токенов

• Системный промпт и история диалога включаются в каждый запрос: каждое сообщение повторно отправляет всю историю, поэтому чем длиннее разговор, тем быстрее растёт расход
• Содержимое файлов загружается в контекст: при редактировании кода содержимое целевого файла подтягивается в контекст. Чем больше файл, тем больше токенов
• Вызовы инструментов выстраиваются в цепочку: одна инструкция может запустить поиск файлов, чтение, редактирование и проверку. Согласно документации Anthropic, Claude Code отправляет весь диалог с каждым запросом, а каждый раз, когда Claude использует инструменты, отправляет ещё один запрос с их результатами (Manage costs effectively)
• Токены «размышления» тоже считаются: внутренний процесс «обдумывания» Claude Code также потребляет токены

Обработка этой модели происходит на серверах Anthropic, поэтому если заменить ПК на более мощный, расход токенов и время, которое ИИ тратит на размышления, не изменятся. На ПК меняется только время выполнения команд на локальной машине и то, хватает ли памяти (см. «Требования к ПК для Claude Code и Codex»).

Подробнее о различиях между режимами Claude читайте в нашей статье о различиях между Claude Chat, Cowork и Code.

2. Лимиты и тарифы по планам

Claude Code используют либо войдя в платный план Claude (Pro, Max, Team или Enterprise), либо с API-ключом из Claude Console. По данным страницы цен Claude, лимит любого плана считается в окне сессии, которое обновляется каждые пять часов, а у платных планов поверх него есть недельный лимит. Фиксированного числа сообщений нет: объём зависит от длины разговоров, выбранной модели и используемых функций (страница цен Claude, проверено 26 сентября 2026 года).

Источники: страница цен Claude, справочный центр Anthropic «What is the Pro plan?» и «What is the Max plan?», документация Claude Code «Manage costs effectively» (всё проверено 26 сентября 2026 года). Ultra — это тариф, который 31 октября 2026 года переименовали из Max 20x. Согласно статье «What is the Ultra plan?» (справочный центр Anthropic), его недельный лимит в 10 раз больше, чем у Pro, а у подтверждённых аккаунтов нет 5-часового лимита (проверено 31 октября). Подтверждение происходит автоматически по истории аккаунта и платежей; если на странице использования в настройках нет полосы «Current session», ваш аккаунт подтверждён.

Старшая модель Fable устроена отдельно. В сравнительной таблице на странице цен Pro может пользоваться ею только через кредиты использования, а Max и Ultra — в пределах 50% недельного лимита. В Claude Code, в зависимости от плана, использование Fable может списываться с кредитов использования, а не с квоты плана; тогда в строке Fable в /model написано «Requires usage credits», и Claude Code спрашивает подтверждение перед списанием (Model configuration).

Подробное сравнение тарифов — в нашей статье о сравнении цен Claude и ChatGPT.

3. 10 способов экономии токенов

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

Но прежде чем начинать экономить, стоит измерить, что именно занимает контекст. Разбивку покажет /context, реальный расход — /usage, а стоимость каждого навыка — /skill-doctor. Подробно об этом мы пишем в статье что на самом деле съедает ваш контекст в Claude Code.

Совет 1: Регулярно сбрасывайте контекст командой /clear

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

# После завершения работы над авторизацией
/clear

# Начинаем следующую задачу
"Добавь функцию оплаты"

Совет 2: Сжимайте диалог командой /compact

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

# Базовое сжатие
/compact

# Сжатие с указаниями
/compact Оставь только изменения кода и спецификации API

При этом чем чаще вы её нажимаете, тем больше вы не выигрываете. Стоимость сжатия сильно зависит от того, прогрет ли кэш промпта, и нажатие сразу после перерыва обходится дороже всего. О том, где именно её нажимать, подробно рассказано в статье когда нажимать /compact.

Совет 3: Прямо называйте, что читать

Если запрос расплывчатый, Claude Code широко ищет файлы, которые могут оказаться нужными, и читает их, а контекст соответственно растёт. Документация Anthropic говорит о том же: расплывчатый запрос вроде «улучши эту кодовую базу» запускает широкое сканирование, а конкретный вроде «добавь проверку ввода в функцию login в auth.ts» позволяет обойтись минимумом чтения файлов (Manage costs effectively). Если вы уже знаете, какой файл нужен, укажите его через @, и Claude добавит его в диалог, не разыскивая сам (Common workflows). Файл, указанный через @, попадает в контекст целиком, а каталог даёт список файлов, а не их содержимое, поэтому указывайте только нужные файлы.

❌ «Улучши эту кодовую базу»
→ Claude широко ищет и читает всё, что кажется связанным (больше входных токенов)

✅ «Добавь проверку ввода в функцию login в @src/auth.ts»
→ Работа идёт только с нужным файлом

Совет 4: Переключайте модели в зависимости от задачи

Не для каждой задачи нужна старшая модель. На 26 сентября 2026 года модель Claude Code по умолчанию — Opus 5.5, одинаково на Pro, Max, Team, Enterprise и в API (Model configuration). При этом за токен средняя Sonnet стоит примерно вдвое дешевле Opus, а лёгкая Haiku ещё дешевле: на 12 октября 2026 года Haiku 5.5 при промптах до 100 тыс. токенов стоит в 40 раз дешевле Opus (см. таблицу в разделе 5). Документация Anthropic тоже говорит, что Sonnet хорошо справляется с большинством задач программирования и стоит меньше Opus, советует оставлять Opus для сложных архитектурных решений и многошаговых рассуждений, а для простых задач субагентов указывать Haiku (Manage costs effectively). И на подписке объём, который вам доступен, зависит от выбранной модели. Даже если с новой версией соотношения сдвинутся, правило остаётся тем же: выбирайте уровень по сложности задачи.

# Sonnet для повседневного кодирования
/model sonnet

# Opus для проектных решений или сложного рефакторинга
/model opus

Совет 5: Просите краткий ответ

Более длинные ответы ИИ — это больше выходных токенов. Указания вроде «только код» или «ответь одной строкой» сокращают лишний вывод.

❌ "Исправь эту функцию"
→ ИИ генерирует длинное объяснение + код + примечания (много выходных токенов)

✅ "Исправь эту функцию. Без пояснений, только код"
→ Только код (значительно меньше выходных токенов)

Совет 6: Ограничьте токены «размышления»

В Claude Code расширенное мышление (extended thinking) включено по умолчанию, а токены мышления оплачиваются как выходные. В зависимости от модели бюджет по умолчанию может составлять десятки тысяч токенов на запрос. Для работы, где глубокие рассуждения не нужны, стоимость снижается, если понизить уровень effort командой /effort (или в /model). Opus 5.5 и модели Fable думают всегда, поэтому для них регулируют effort (Manage costs effectively). Уровень effort по умолчанию у Opus 5.5 — medium, у большинства других моделей — high (Model configuration).

# Низкий уровень усилий для простых задач
/effort low

Совет 7: Держите CLAUDE.md кратким

CLAUDE.md (файл инструкций проекта) загружается в контекст при старте сессии и затем передаётся в каждом следующем запросе. Если в нём расписаны пошаговые инструкции для отдельных процессов, например ревью PR или миграций базы данных, вы платите за эти токены даже во время посторонней работы. Официальная рекомендация — вынести такие инструкции в skills, которые загружаются только при вызове (Manage costs effectively).

Совет 8: Используйте субагентов

Работу с объёмным выводом — запуск тестов, получение документации, разбор логов — передавайте субагенту. Длинный вывод остаётся в контексте субагента, а в основной разговор возвращается только сводка. Однако запросы самого субагента тоже засчитываются в ваше использование; чтобы тратить на них меньше, назначьте субагенту модель поменьше, например Haiku (Manage costs effectively).

Совет 9: Давайте спецификации сразу, чтобы избежать переделок

Цикл «сделай — исправь — переделай» расходует токены впустую. Чёткие спецификации с самого начала предотвращают переработки и удерживают расход токенов линейным.

❌ Паттерн диалога (экспоненциальный рост токенов):
"Сделай вход в систему" → "Добавь валидацию"
→ "На самом деле, перейди на email-аутентификацию" → "Ещё и UI измени"

✅ Паттерн «спецификация в начале» (линейный рост токенов):
"Сделай вход в систему по этим требованиям:
- Аутентификация по email + пароль
- Валидация email (формат + проверка дубликатов)
- Требования к паролю: 8+ символов, буквы и цифры
- UI формы входа: по центру, в стиле карточки"

Подробнее о написании эффективных промптов — в нашей статье советы по промптам для разработки с ИИ.

Совет 10: Следите за форматами файлов

В API Claude каждая страница PDF стоит токенов за извлечённый текст (обычно 1500–3000 токенов на страницу) плюс токенов за страницу, преобразованную в изображение (документация API Claude, «PDF support»). Claude Code читает короткие PDF целиком, а файлы длиннее 10 страниц — фрагментами до 20 страниц (Tools reference). Указывайте только нужные страницы или заранее переводите файл в текст.

4. Что происходит при достижении лимита: 5-часовое окно, недельный лимит и кредиты использования

Главное сразу: на подписке доплаты возможны, но сами по себе они не возникают. Чтобы продолжать работу сверх лимита, нужно самому включить кредиты использования (usage credits) и заранее пополнить баланс. Если вы этого не сделали, Claude Code просто остановится на лимите, вы подождёте обновления окна, и счёт не изменится (справочный центр Anthropic, «Manage usage credits for paid Claude plans»).

Два уровня лимитов: 5-часовое окно и недельный лимит

• 5-часовое окно (лимит сессии): квота, которая обновляется каждые пять часов. Есть у Pro, Max и Team
• Недельный лимит: недельный потолок, общий для всех моделей. Он сбрасывается в фиксированные день и время, закреплённые за вашим аккаунтом, и не зависит от того, когда вы начали пользоваться Claude или оформили подписку. Время следующего сброса видно в Settings > Usage на claude.ai (справочный центр, «What is the Pro plan?» и «What is the Max plan?»)
• Лимиты по моделям: некоторые лимиты действуют только для Opus или только для Sonnet

Использование списывается одновременно и из 5-часового окна, и из недельного лимита. Один всплеск интенсивной работы, например запуск множества субагентов сразу, может исчерпать недельный лимит ещё до обновления 5-часового окна. При приближении к лимиту появляется предупреждение вроде You've used 85% of your session limit · resets 3:45pm, а при достижении Claude Code останавливается с такими сообщениями (документация Claude Code, «Error reference»):

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

Что можно сделать при достижении лимита на Pro или Max

Источники: документация Claude Code «Error reference» и «Wait for a usage limit to reset», справочный центр Anthropic «Use Claude Code with your Pro or Max plan» и FAQ на странице цен Claude (проверено 26 сентября 2026 года). Что делать при каждом сообщении, разобрано в статье You've hit your session limit в Claude Code: что это значит и что делать.

Как работают кредиты использования (Pro и Max)

• Где включить: в разделе «Usage credits» в Settings > Usage на claude.ai. В Claude Code команда /usage-credits открывает эту страницу в браузере (только при входе через подписку claude.ai; с API-ключом недоступна)
• Оплата: предоплата. Баланс покупается кнопкой «Add funds»; можно включить автопополнение (auto-reload), когда баланс снижается
• Ограничитель: можно задать месячный лимит расходов (или выбрать «Set to unlimited»). Если вы его достигли, а кредиты ещё остались, Claude Code спросит, поднять или снять лимит
• Тариф: стандартные тарифы API (таблица в разделе 5), отдельной строкой в счёте помимо подписки. 5-часовое окно по-прежнему обновляется как обычно
• Подтверждение: при приближении к лимиту и при его достижении приходят уведомления, и перед продолжением за счёт кредитов нужно подтвердить
• Отключение: в любой момент в Settings > Usage; после этого вы пользуетесь только квотой плана

Две детали легко упустить. Первая — время жизни кеша. В пределах квоты плана кеш основного разговора Claude Code живёт час, а пока вы тратите кредиты использования — только пять минут. Если сделать паузу дольше пяти минут, следующее сообщение перечитает весь разговор, и кредиты уйдут быстрее (Manage costs effectively). Вторая — срок действия. В большинстве стран купленные кредиты не сгорают, но в некоторых юрисдикциях, например в Японии, с 10 сентября 2026 года они сгорают через шесть месяцев после покупки; за семь дней приходит письмо.

Если вы не хотите доплачивать никогда

• Не включайте кредиты использования (если включены — выключите в Settings > Usage)
• Не оставляйте заданной переменную окружения ANTHROPIC_API_KEY. Если она задана, Claude Code авторизуется по этому API-ключу вместо подписки, и ваше использование оплачивается как использование API (справочный центр, «Use Claude Code with your Pro or Max plan»). Под каким аккаунтом вы сейчас работаете, показывает /status
• Входите только с аккаунтом Pro или Max, не добавляя учётные данные Claude Console (API) (та же статья)

Team и Enterprise

• Team и Enterprise с оплатой за места: использование каждого участника списывается с квоты места, которая обновляется в 5-часовом окне и еженедельно. Квота общая с чатом и Cowork, а её размер зависит от типа места (стандартное или премиум). Продолжать сверх неё можно, только если администратор включил кредиты использования, с лимитами расходов на уровне организации, группы или участника (Manage costs effectively). В Team кредиты покупаются заранее; в Enterprise с оплатой за места фактическое использование выставляется в счёт в конце месяца (справочный центр, «Manage usage credits for Team and seat-based Enterprise plans»)
• Если участник без доступа к оплате запускает /usage-credits, Claude Code просит подтвердить и отправляет запрос администраторам
• Enterprise с оплатой по потреблению (новые и self-service-планы): квоты на место нет; всё использование оплачивается по тарифам API с первого токена. Оно останавливается при достижении лимита расходов организации или участника (справочный центр, «How am I billed for my Enterprise plan?»)

API-ключ (оплата по факту)

• Нет ни 5-часового окна, ни недельного лимита; оплачивается всё, что вы используете
• При превышении лимита скорости в минуту (запросы, входные или выходные токены в минуту) возвращается ошибка 429 с заголовком retry-after, где указано, сколько ждать
• У каждого уровня использования, который зависит от истории вашего аккаунта, есть месячный потолок расходов (Start — $500, Build — $1000, Scale — $200 000). Когда он достигнут, использование приостанавливается до 00:00 UTC первого числа следующего месяца. Можно также задать собственный, более низкий лимит (документация API Claude, «Rate limits»)
• В организации можно также ограничить расходы рабочих пространств в Claude Console (Manage costs effectively)
• К тарифам Max и Team каждый месяц прилагаются кредиты для API ($100 на Max и $200 на Ultra). Их получают, привязав организацию в Claude Console; они покрывают и claude -p, запущенный с API-ключом, но не интерактивный Claude Code («Ежемесячные API-кредиты на тарифах Claude Max и Team»)

Как проверить остаток и расходы

• /usage: полосы использования плана, расходы на кредиты использования за месяц и разбивка того, что израсходовало квоту (skills, субагенты, MCP-серверы и т. д.). /cost и /stats — псевдонимы. Разбивка считается по истории сессий на этом компьютере, поэтому использование на других устройствах и в claude.ai в неё не входит
• Settings > Usage на claude.ai: заполнение 5-часового окна и недельного лимита и время их сброса
• Строка состояния: добавьте поля rate_limits, чтобы остаток всегда был на экране
• /status: под каким аккаунтом вы сейчас работаете
• С API-ключом: страница Usage в Claude Console (platform.claude.com/usage)

Источники: Manage costs effectively, Error reference, Commands (проверено 26 сентября 2026 года).

5. Как устроена тарификация API

В API цена за токен определяется уровнем модели (высший, старший, средний, лёгкий). Конкретные цены меняются вместе с версиями, но соотношения — чем выше уровень, тем дороже; вывод стоит в пять раз больше ввода; чтение из кэша намного дешевле ввода — до сих пор сохранялись от поколения к поколению. Цены на 12 октября 2026 года:

* MTok = 1 миллион токенов. Источник: Claude Platform Docs, «Pricing» (проверено 12 октября 2026 года). Цены Haiku 5.5 действуют для промптов до 100 тыс. токенов; сверх этого — $0.50 за ввод, $2.50 за вывод и $0.05 за чтение из кэша. Чтение из кэша у Sonnet 5.5 подешевело с 10% до 5% от ввода 7 октября 2026 года. Прежняя Haiku 4.5 ($1 за ввод, $5 за вывод) переведена в разряд устаревших (Legacy), но по-прежнему доступна. Актуальные цены и сравнение моделей — в сравнении цен Opus, Sonnet и Haiku, текущие модели всех компаний — в списке текущих моделей и дат среза знаний.

Что такое кэширование промптов?

Anthropic предлагает функцию кэширования промптов: при повторном использовании того же контекста (системный промпт и недавний диалог) прочитанное из кэша стоит 10% базовой цены ввода (а у Opus 5.5 и Sonnet 5.5 — 5% и у Fable 5.1 — 2,5%, как в таблице выше). Взамен запись в кэш стоит в 1,25 раза больше ввода при сроке жизни 5 минут и вдвое больше — при сроке в один час.

Сколько живёт кеш, зависит от способа оплаты. В пределах квоты подписки Claude Code даёт основному разговору кеш на один час; при оплате кредитами использования, по API-ключу или через облачного провайдера по умолчанию это пять минут (документация Claude Code, «Prompt caching»). При пятиминутном сроке пауза дольше пяти минут приводит к истечению кеша, и следующее сообщение заново записывает весь контекст в кеш. Если задать promptCacheTtl равным 1h, основной разговор будет кешироваться на час (запись при этом дороже).

6. Итоги

FAQ

Источники

Проверенные первоисточники (получены 26 сентября 2026 года): документация Claude Code Manage costs effectively / Error reference / Interactive mode / Prompt caching / Model configuration / Commands / Tools reference; документация API Claude Pricing / Rate limits / PDF support; страница цен Claude; справочный центр Anthropic: кредиты использования (Pro и Max) / кредиты использования (Team и Enterprise) / Claude Code с Pro или Max / план Pro / план Max / оплата Enterprise. Цены, лимиты и условия могут меняться, поэтому перед оформлением проверьте официальные страницы.