Коротко: как работают лимиты Claude Code
Если вы пользуетесь Claude Code по подписке Pro, Max или Team, у вас два ограничения одновременно: скользящее пятичасовое окно, которое отсчитывается от первого запроса, и недельный лимит поверх него. Оба лимита общие для Claude Code и чата claude.ai на всех устройствах — отсюда сообщение «limits shared with Claude Code».
Точного числа токенов в Pro или Max Anthropic не публикует. Официально известно только соотношение: Max 5x даёт примерно в 5 раз больше использования, чем Pro, Max 20x — примерно в 20 раз. Цифры вида «45 сообщений за пять часов», которые гуляют по интернету, — оценки сторонних авторов, а не данные Anthropic: реальный расход зависит от модели, размера контекста и длины сессии.
Безлимитного Claude Code не существует. Даже на Max 20x есть недельный потолок, а при оплате по API ограничением становится ваш баланс.
- Пятичасовое окно начинается с первого запроса, а не по часам.
- Недельный лимит действует поверх пятичасовых окон.
- Лимит общий: claude.ai в браузере, приложения и Claude Code.
- Точные цифры в токенах официально не раскрываются.
Что значит «limits shared with Claude Code»
Это напоминание о том, что у подписки один общий пул использования. Длинный разговор в чате claude.ai утром уменьшает то, что останется для агента днём, и наоборот: пара часов работы Claude Code по репозиторию может исчерпать окно так, что в чате вы тоже упрётесь в лимит.
Практический вывод: если Claude Code — основной рабочий инструмент, тяжёлые обсуждения в чате лучше переносить на время, когда агент не нужен, или разводить их по разным способам доступа. Например, чат оставить на подписке, а агента подключить к API, у которого нет пятичасовых и недельных окон.
У командных тарифов логика та же: лимит места обновляется в пятичасовом и недельном окне и делится между чатом, Claude Code и другими инструментами Anthropic. Его размер зависит от типа места — Standard или Premium.
Лимиты подписки и лимиты API — это разные вещи
Под словом «лимиты» в Claude Code прячутся три разных ограничения, и путать их — частая причина неверных решений.
Первое — лимиты использования подписки: пятичасовое окно и недельный потолок. Они считают, сколько работы вы сделали, и сбрасываются по времени. Второе — ограничения скорости API: сколько запросов и токенов в минуту разрешено ключу. Они не про объём за день, а про темп, и при обычной работе одного человека почти не мешают. Третье — контекстное окно модели: сколько токенов помещается в один запрос. Предупреждение о скором автоматическом сжатии контекста — это не лимит тарифа, а сигнал, что сессия разрослась.
Поэтому «упёрся в лимит» может означать совсем разное: на подписке нужно ждать сброса окна, на API — пополнить баланс или немного сбавить темп, а при переполненном контексте достаточно /compact или /clear.
- Лимит подписки — объём работы за 5 часов и за неделю.
- Rate limit API — темп запросов в минуту.
- Контекстное окно — объём одного запроса, лечится сжатием или новой сессией.
Что такое токен и что их съедает в Claude Code
Токен — это кусочек текста, с которым работает модель: от части слова до короткого слова. Для английского текста в среднем около четырёх символов на токен, русский текст и код дробятся мельче. Считаются и входящие токены — всё, что агент отправляет модели, — и исходящие: ответ, код и рассуждение модели.
Главная особенность агента в том, что он на каждом шаге отправляет модели всю историю сессии заново. Короткий вопрос в сессии, открытой с утра, тянет за собой весь накопленный контекст: прочитанные файлы, вывод тестов, прошлые ответы. Кеширование делает повторное чтение дешёвым, но не бесплатным.
Поэтому один час плотной работы Claude Code по проекту — это единицы миллионов токенов, а по расходу он может превзойти день переписки в чате.
- Длинный контекст: весь диалог и результаты инструментов уходят с каждым запросом.
- Чтение файлов: расплывчатая задача вроде «улучши код» заставляет агента читать всё подряд.
- Вывод команд: длинные логи и полный вывод тестов попадают в контекст целиком.
- Рассуждение: мышление модели тарифицируется как исходящие токены, самые дорогие.
- Промахи кеша: первый запрос после долгой паузы заново обрабатывает весь контекст.
- Субагенты, MCP-серверы и фоновые задачи отправляют собственные запросы.
Подробнее: Сколько токенов уходит на типовые задачи
Как посмотреть расход: /usage, /status и /context
Главная команда — /usage. Старое название /cost осталось как псевдоним. Для работы по API она показывает блок текущей сессии: сколько токенов ушло на вход, выход, чтение и запись кеша по каждой модели и оценку стоимости в долларах по прайсу. Оценка считается локально, итоговые цифры всегда сверяйте с биллингом.
На подписке Pro, Max или Team та же команда показывает полосы использования лимитов и разбивку расхода: какую долю съели навыки, субагенты и отдельные MCP-серверы, а также флаги вроде длинного контекста или промахов кеша, если они дают больше 10% расхода. Клавишами d и w переключаются последние сутки и неделя. Учитывается только этот компьютер: расход в claude.ai и на других устройствах в разбивку не попадает.
Команда /status показывает состояние сессии и предупреждения об оставшемся запасе, а /context рисует сетку заполнения контекстного окна и подсказывает, что занимает больше всего места.
/usage # расход сессии и полосы лимитов подписки
/cost # то же самое, старое название
/status # состояние сессии и аккаунта
/context # что занимает контекстное окноКак экономить токены в Claude Code
Экономия — это не отказ от возможностей агента, а контроль над контекстом. Приёмы ниже рекомендует сама документация Claude Code, и они одинаково работают и на подписке, и по API.
Между несвязанными задачами начинайте новую сессию командой /clear — она ничего не стоит. Если нужно продолжить ту же задачу, но контекст раздулся, используйте /compact с указанием, что сохранить. Учтите, что сжатие само по себе — крупный запрос: агент читает весь диалог, чтобы его пересказать.
Модель выбирайте под задачу: Sonnet 5 закрывает большую часть повседневной разработки, Opus 5.5 нужен для архитектуры и сложных многошаговых задач, Haiku 4.5 — для простых подзадач. Уровень рассуждения меняется командой /effort: на рутине low или medium заметно сокращают исходящие токены. У Opus 5.5 и моделей Fable мышление отключить нельзя — только понизить усилие.
Держите CLAUDE.md коротким — он загружается в каждую сессию целиком. Документация советует укладываться примерно в 200 строк, а подробные регламенты выносить в навыки, которые подгружаются только по требованию. Отключите через /mcp серверы, которыми сейчас не пользуетесь, а объёмный вывод тестов и логов поручайте субагентам — в основной диалог вернётся только краткий итог.
- Пишите конкретные задачи: «добавь валидацию в функцию login в auth.ts», а не «улучши проект».
- Для сложной работы включайте режим планирования (Shift+Tab): дешевле согласовать план, чем переделывать.
- Останавливайте агента клавишей Escape, как только он пошёл не туда, и откатывайтесь через /rewind.
- Не меняйте модель посреди длинной сессии без нужды — это сбрасывает кеш.
/clear # новая сессия, контекст с нуля
/compact сохрани изменения в коде и вывод тестов
/model claude-sonnet-5 # модель для рутины
/effort low # меньше рассуждений на простых шагах
/mcp # отключить лишние MCP-серверыПодробнее: Выбор модели в Claude Code: Opus, Sonnet или Haiku · Навыки, субагенты и MCP в Claude Code
Кеширование и паузы: скрытая причина быстрого расхода
Claude Code кеширует стабильную часть запроса автоматически, и повторное чтение из кеша стоит примерно на порядок дешевле обычного входа. Например, у Opus 5.5 чтение кеша — 0,20 доллара за миллион токенов против 4 долларов за обычный вход.
Но кеш живёт ограниченное время. По документации, на подписке срок жизни — час, а при работе через API-ключ по умолчанию — пять минут. Если вы отошли на обед и вернулись к огромной сессии, первый же запрос заново обработает весь контекст по полной цене. На Pro и Max Claude Code в таком случае может предложить продолжить с краткого пересказа вместо полной истории.
Что ещё ломает кеш: смена модели, изменение набора инструментов и MCP-серверов, сжатие контекста. В блоке сессии команды /usage есть строка статистики кеша — какая доля входа пришла из кеша и сколько было промахов. Если доля низкая, ищите причину там.
Подробнее: Цена Opus 5.5 с кешем и без
Что делать, если Claude Code упёрся в лимит
Сообщения «You've hit your session limit» и «You've hit your weekly limit» означают, что исчерпано общее окно подписки. Оно одно на все модели, поэтому переключение модели через /model не поможет. В сообщении указано время сброса. Если же вы видите лимит на конкретное семейство моделей, например «You've hit your Opus limit», переход на модель другого семейства позволит продолжить работу.
Вариантов дальше четыре. Первый — подождать: новые версии Claude Code умеют дождаться сброса и продолжить прерванную задачу автоматически. Второй — включить платное использование сверх лимита: на Pro и Max это настраивается командой /usage-credits в разделе использования на claude.ai. Третий — перейти на тариф выше: с Pro на Max 5x или с Max 5x на Max 20x. Четвёртый — подключить агента к API с оплатой за токены: пятичасовых и недельных окон там нет, есть только баланс.
Из России первые три варианта упираются в оплату зарубежной картой. Четвёртый можно сделать через российский шлюз claude-gateway.ru: тариф оплачивается в рублях, токен из личного кабинета прописывается в переменную ANTHROPIC_AUTH_TOKEN, и агент продолжает работать с теми же идентификаторами моделей. Если захотите вернуться к подписке, уберите переменные окружения и войдите через /login.
# переключить Claude Code на оплату по токенам через шлюз
export ANTHROPIC_BASE_URL="https://claude-gateway.ru/api"
export ANTHROPIC_AUTH_TOKEN="ваш_токен_из_кабинета"
claude
# вернуться к подписке
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
claude
/loginПодробнее: Claude Code по API без VPN · Ошибки и блокировки Claude Code: разбор сообщений
Подписка или токены: что выбрать при постоянных лимитах
Если лимит заканчивается раз в неделю на час-другой, проще подождать или скорректировать привычки: /clear между задачами, Sonnet 5 по умолчанию, короткий CLAUDE.md. Обычно этого хватает, чтобы уложиться в окно.
Если лимит обрывает работу каждый день, посчитайте. По данным Anthropic, в корпоративных внедрениях Claude Code по API средний расход — около 13 долларов на разработчика за активный день, у 90% пользователей — меньше 30 долларов. Для кого-то это дешевле перехода на Max 20x, для кого-то дороже — всё решают ваша модель и размер контекста.
Удобная стратегия — комбинировать: основная работа идёт по подписке, а когда окно закончилось посреди важной задачи, агент переключается на API и доделывает её по токенам. В шлюзе начать можно с пробного тарифа за 150 ₽ на один день, а расход по каждому запросу виден в кабинете — так проще понять, сколько вам на самом деле нужно.
Подробнее: Сколько стоит доступ по токенам в рублях · Сравнение цен: подписка Pro, Max или API