Лимиты Claude Code: как проверить в /usage и где теряются токены

Остаток лимитов Claude Code показывает команда /usage: там две полоски, лимит сессии и недельный лимит, и у каждой время сброса. /cost и /stats открывают тот же экран. /status показывает версию, модель, аккаунт и подключение, поэтому по нему проверяют, через какой аккаунт идёт работа, а не сколько осталось. Те же полоски есть на claude.ai в разделе Settings > Usage: лимиты общие для claude.ai, Claude Code в терминале, Desktop и расширений IDE.

Если полоска тает быстрее, чем вы ожидаете, не начинайте с покупки более дорогого плана. Сначала выясните, что именно расходует лимит: длинная история, перестройка кэша, MCP, субагенты или тяжёлая модель с высоким effort. От ответа зависит, что поможет — /clear, другая модель, фильтр логов или обращение в поддержку.

Факты приведены по состоянию на 5 октября 2026 года по документации Claude Code и справке Claude о планах Pro и Max. Интерфейс меняется от версии к версии, поэтому при расхождении ориентируйтесь на установленный клиент (claude --version).

Где посмотреть лимиты Claude Code: /usage, а не /status

Остаток и время сброса обоих окон показывает /usage; он срабатывает сразу, даже пока Claude отвечает. Остальные экраны отвечают на другие вопросы:

В справке для Pro и Max до сих пор встречается совет следить за остатком через /status. В актуальном справочнике команд Claude Code /status описан как вкладка с версией, моделью, аккаунтом и подключением, а лимиты плана, стоимость сессии и статистику выводит /usage.

Разбивка в /usage доступна на Pro, Max, Team и Enterprise. Флаг поведения появляется, когда длинный контекст или промахи кэша дают 10 % недавнего расхода и больше; рядом Claude Code подсказывает, как это сократить. Тяжёлые /loop и другие запланированные задачи выводятся отдельными строками с числом запусков и токенами на запуск (с версии 2.1.242).

Строка состояния: проценты 5-часового и недельного окна в терминале

Claude Code передаёт скрипту строки состояния JSON. У подписчиков Pro и Max в нём есть объекты rate_limits.five_hour и rate_limits.seven_day с полями used_percentage (от 0 до 100) и resets_at (момент сброса в Unix-секундах). Минимальный скрипт по образцу из документации о строке состояния печатает оба процента:

#!/bin/bash
input=$(cat)
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

LIMITS=""
[ -n "$FIVE_H" ] && LIMITS="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LIMITS="${LIMITS:+$LIMITS }7d: $(printf '%.0f' "$WEEK")%"
echo "${LIMITS:-лимиты: нет данных}"

На тестовом JSON с used_percentage 23,4 и 41 скрипт выводит 5h: 23% 7d: 41%, а без объекта rate_limits — лимиты: нет данных. Нужен jq. Сохраните файл как ~/.claude/statusline.sh, выполните chmod +x ~/.claude/statusline.sh и добавьте в ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

Конструкция // empty нужна потому, что каждое окно может отсутствовать: до первого ответа в сессии, при работе по API-ключу и после того, как наступило время resets_at. Если писать скрипт не хочется, запустите /statusline и опишите словами, что показывать: Claude Code сам создаст скрипт и обновит настройки.

Как часто обновляются лимиты Claude: сессия раз в 5 часов, неделя — в свой день

Лимит сессии сбрасывается каждые пять часов. Недельный лимит сбрасывается в фиксированные день и час, закреплённые за вашим аккаунтом: они не зависят от того, когда вы начали работать или оформили подписку. Ближайший сброс виден в Settings > Usage и в /usage.

Для планирования важны ещё четыре правила из справки Claude и описания ошибок Claude Code:

• Каждый запрос расходует оба окна сразу. Один всплеск тяжёлой работы, например workflow, который раздаёт задачу множеству агентов, может исчерпать недельный лимит раньше, чем обновится окно сессии.
• Запас общий. claude.ai, Claude Code в терминале, Desktop и расширения для VS Code, Cursor и JetBrains тянут из одних и тех же лимитов.
• Лимиты сессии и недели действуют для всех моделей. Переход на другую модель доступ к ним не возвращает. Отдельно может сработать лимит Opus или Sonnet, и тогда сообщение называет семейство модели.
• Числа часов или сообщений Anthropic не публикует. Расход зависит от длины и сложности задач, используемых функций, модели и уровня effort, а компания оставляет за собой право ограничивать использование и другими способами, в том числе по моделям и функциям.

Планы отличаются множителем: Max 5x даёт в пять раз больше лимита сессии, чем Pro, Max 20x — в двадцать раз больше. Цены и окупаемость сравниваются в разборе Claude Pro vs Max в 2026 году, разница с бесплатным планом — в материале Claude Free или Pro: как сравнить лимиты.

Почему лимит Claude Code тает быстро: чей это счётчик

Быстрый расход нельзя объяснить одной цифрой. Полоски плана, локальная оценка стоимости сессии, счёт Claude Console и биллинг облачного провайдера относятся к разным договорам, поэтому аудит начинается с вопроса, какой из них вы видите.

Отдельная причина «внезапно дорогого» Claude Code — незаметная смена способа оплаты. Если в системе задана переменная ANTHROPIC_API_KEY, Claude Code использует ключ вместо подписки, и работа оплачивается по ставкам API, а не из включённого лимита. Проверьте аккаунт в /status, переменные окружения, base URL и провайдера. Подробная развилка — в руководстве Claude Code: API-ключ или подписка.

Журнал аудита Claude Code: что записать до закрытия сессии

Не закрывайте проблемную сессию. Запишите claude --version, выполните /usage, /context и /mcp, сохраните модель, effort, способ входа, session ID, процент контекста, input и output, cache creation и cache read, а также точный текст лимита или ошибки. Отметьте время с часовым поясом, рабочий каталог и недавние события: переключение модели, новый MCP-сервер, /compact, обновление, восстановление старой сессии, долгий перерыв. Ключи, приватные диалоги и код клиента к записи не прикладывайте.

С версии 2.1.251 в блоке Session есть строка Prompt cache (main): доля входных токенов из кэша, число промахов, ожидаемые перестройки после compact и состояние кэша (тёплый или холодный, с текущим TTL). С версии 2.1.260 строка ещё и называет вероятную причину последнего промаха, например likely cause: tool definitions changed. Она описывает только основной диалог, без субагентов.

Атрибуция в /usage относит недавний расход к навыкам, субагентам, плагинам и MCP-серверам. Это диагноз по локальной истории, а не финансовый отчёт организации.

Рост контекста или перестройка кэша: как отличить по токенам

Claude Code отправляет в каждом запросе весь диалог: системные инструкции, CLAUDE.md, историю и результаты инструментов. Кэш снижает цену повторного чтения, но не обнуляет её, поэтому вопрос в одну строку в сессии, открытой с утра, всё равно расходует лимит на весь накопленный контекст. /context показывает, что занимает окно: CLAUDE.md, memory, MCP-инструменты, навыки, файлы и сообщения.

В токенах это видно так: cache_read_input_tokens — дешёвое чтение уже сохранённого префикса, cache_creation_input_tokens — запись или перестройка, output — отдельная генерация. Высокое отношение read к creation значит, что кэш работает.

Однократная перестройка нормальна после смены модели, включения fast mode, /compact, обновления Claude Code или подключения MCP-сервера, если инструменты загружаются сразу. Смена effort перестраивает кэш на большинстве моделей, но на Opus 5.5, Sonnet 5.5 и Fable 5.1 с подпиской или API-ключом кэш сохраняется. Ещё одна частая причина — перерыв дольше срока жизни кэша: на подписке в пределах лимита это час для основного диалога, при оплате кредитами использования, по API-ключу и у облачных провайдеров — пять минут.

Подозрительна повторяющаяся высокая creation при низком read в похожих запросах с теми же настройками. Подробная математика — в руководстве Claude Code cache miss и стоимость токенов.

Расход может расти и без ваших сообщений. Запланированная задача срабатывает по расписанию, сообщение из другой вашей сессии приходит как новый ход, проверки цели запускаются, пока ждёт фоновая работа, — и каждый раз уходит весь контекст. Субагенты и участники команды агентов отправляют собственные запросы поверх основного диалога. Собственно фоновые запросы Claude Code (сводки для --resume, служебные проверки) обычно стоят меньше $0,04 за сессию.

MCP в расходе Claude Code: схемы инструментов и размер ответов

Число настроенных серверов само по себе ничего не доказывает. На моделях поколения Claude 4.5 и новее поиск инструментов (tool search) откладывает полные схемы: в контекст сначала попадают только имена инструментов и инструкции серверов. Схемы загружаются сразу, если у сервера стоит "alwaysLoad": true, задано ENABLE_TOOL_SEARCH=false, используется старая модель, а также через некоторые шлюзы и облачных провайдеров.

Проверьте через /mcp и /context, какие инструменты активны и как они загружены. Затем посмотрите на объём ответов: короткая схема может вернуть огромный лог или таблицу. Claude Code предупреждает, когда ответ MCP-инструмента превышает 10 000 токенов, а предел по умолчанию — 25 000 (MAX_MCP_OUTPUT_TOKENS). Вместо повышения предела применяйте фильтры, пагинацию, сводку или ссылку на файл. Доля MCP-сервера в разбивке /usage учитывает только запросы, которые действительно получили результат его инструмента. Подробная очистка описана в руководстве Claude Code и перегрузка контекста MCP.

Контрольная сессия: тот же проект без накопленной истории

Сохраните тот же проект, способ оплаты, модель, effort и версию. Откройте новую сессию, оставьте только нужные MCP-серверы, снимите /usage и /context, выполните одну небольшую задачу и снимите показатели снова.

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

Если чистый контроль повторяет скачок, не тратьте лимит на серию повторов. Подготовьте один воспроизводимый пример: версия, способ оплаты, модель, effort, время, session ID без секретов, классы токенов, состояние MCP и точный текст ошибки. Подписчики обращаются через claude.ai (инициалы в левом нижнем углу, Get help), пользователи API — через тот же пункт в Claude Console.

Как снизить расход лимита Claude Code: мера под найденную причину

Снижайте то, что показал аудит, а не всё подряд. Меры ниже взяты из рекомендаций Anthropic по затратам и сопоставлены с картиной, при которой каждая помогает.

Несколько уточнений к таблице. Префикс @ подгружает файл целиком вместе с его деревом CLAUDE.md, поэтому для экономии упоминайте путь без него. Рассуждения (extended thinking) оплачиваются как output; на Opus 5.5, Sonnet 5.5 и моделях Fable их нельзя отключить, остаётся только снижать effort. Субагент выносит многословный вывод из основного диалога, но его собственные запросы тоже расходуют лимит. Команда агентов, участники которой работают в plan mode, тратит примерно в 7 раз больше токенов, чем обычная сессия.

Аудит завершён, когда крупный расход получил объяснение: перенесённый контекст, запись или чтение кэша, MCP-схема или ответ, output, отдельный агент, окно подписки или платный маршрут через API.

Как планировать работу под 5-часовое и недельное окно

Перед тяжёлой задачей смотрите в /usage на обе полоски: ограничивает та, что ближе к 100 %. Если окно сессии заполнено на 40 %, а неделя на 90 %, сброс окна через пару часов не поможет — свободных 10 % недели хватит ненадолго.

Чтобы недельный лимит не закончился раньше времени, разделите оставшийся запас на дни до сброса. Пример: неделя израсходована на 70 %, до сброса два дня, значит на день остаётся около 15 % (30 % ÷ 2). Если обычный рабочий день у вас съедает 20 %, переносите массовые запуски или переходите на Sonnet до сброса.

Дальше несколько привычек, которые следуют из того, как устроены лимиты и кэш:

• Массовые параллельные запуски (workflow на много агентов, команда агентов) запускайте, когда в неделе есть запас, и проверяйте /usage после первой партии, а не в конце.
• Перерывы длиннее часа обнуляют кэш на подписке: первое сообщение после паузы заново обработает весь контекст. Закончите задачу через /clear перед перерывом или вернитесь к большой сессии через продолжение со сводки, которое Claude Code предлагает на Pro и Max после долгой паузы. Когда вы расходуете кредиты использования, кэш живёт пять минут.
• Перед уходом остановите /loop и запланированные задачи, которые вам не нужны, и решите, должна ли работа продолжиться сама после сброса (см. следующий раздел).
• Opus оставьте для плана, выполнение отдайте Sonnet: так тяжёлая модель расходует лимит там, где её рассуждения окупаются.
• Сброс лимита (limit reset), если он у вас есть, применяйте осознанно. Он сразу возвращает в полный объём лимит сессии или недельный лимит — какой именно, указано в предложении. День недельного сброса при этом не меняется, отменить применение нельзя, а кнопка Reset for free есть только в Settings > Usage на сайте и в Claude Desktop, но не в Claude Code в терминале или IDE.

Что делать, когда лимит Claude Code исчерпан

Claude Code останавливает запросы до времени, указанного в сообщении:

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
You've hit your Sonnet limit · resets 3:45pm

Перед этим обычно приходит предупреждение вроде You've used 85% of your session limit · resets 3:45pm. Обойти лимит подписки нельзя, но продолжить работу можно одним из официальных способов. /rate-limit-options сводит основные из них в одно меню.

Автоматическое продолжение тратит следующее окно без вашего присмотра. Если это нежелательно, выключите в /config пункт Continue automatically at usage limit или задайте autoContinueAtUsageLimit: false в настройках пользователя. В Desktop на карточке лимита сессии есть отдельный флажок Auto-continue when limits reset, он выключается независимо от настройки CLI. При повторном упоре в лимит Claude Code перезапускает ожидание не больше двух раз подряд.

Переключение на API-ключ — не способ обхода, а другой счёт: работа оплачивается по токенам из Console или облачного аккаунта без жёсткой остановки. Сколько стоят кредиты при регулярном использовании, разобрано в материале Стоимость дополнительного использования Claude, разница между кредитами, облачным кредитом и сбросом — в статье Облачный кредит, кредиты использования и сброс лимита в Claude. Пошаговое восстановление по тексту конкретного сообщения — в руководстве Claude Code Rate Limit Reached: что делать и как продолжить.

Частые вопросы о лимитах Claude Code

Показывает ли /status остаток лимита Claude Code?

Нет. /status показывает версию, модель, аккаунт и подключение, поэтому полезен, чтобы убедиться, что работа идёт по подписке, а не по API-ключу. Остаток и время сброса окна сессии и недели показывает /usage, а постоянно — строка состояния с полями rate_limits.

Какой лимит токенов у Claude Pro в Claude Code?

Фиксированного числа токенов или сообщений Anthropic не публикует. Лимит сессии Pro сбрасывается каждые пять часов, недельный — в закреплённое за аккаунтом время, а фактический объём зависит от длины диалога, модели, функций и effort. Max 5x и Max 20x дают соответственно в 5 и 20 раз больше лимита сессии, чем Pro. Следить удобнее по процентам в /usage.

Считается ли работа в claude.ai в тот же лимит, что и Claude Code?

Да. Чат на claude.ai, Claude Code в терминале, Desktop и расширения IDE расходуют общие лимиты, поэтому полоски в /usage отражают всю активность аккаунта. Разбивка расхода по навыкам, субагентам и MCP в /usage при этом строится только по истории этой машины и работу на claude.ai не показывает.