Claude Code показывает 50%, но предупреждает о недельном лимите: что проверить

Какие счётчики могут отличаться: контекст vs недельный лимит

Чтобы понять происходящее, важно разделить три независимых счётчика:

1. Индикатор сессии (Context Window): Показывает, сколько токенов из доступного окна контекста (например, 200k токенов) занято текущей перепиской, системными промптами и прочитанными файлами. 50% означает лишь то, что в рамках одной сессии у вас осталось ещё 50% свободного окна.
2. Скользящий недельный лимит подписки: Ограничение на общий объем вычислительных ресурсов или запросов в рамках вашего тарифного плана за 7 дней. Если за последние дни было выполнено много тяжелых вызовов, недельная квота может исчерпаться даже при пустом окне текущей сессии.
3. Рейт-лимиты и квоты API (Баланс токенов): При использовании прямого программного доступа через API действуют правила ограничения числа запросов в минуту (RPM/TPM) и лимит доступных средств на балансе.

Если вам требуется независимый от веб-плана и очередей канал для кодинга в терминале, многие инженеры подключают API-доступ со своим ключом. Например, через BetterToken можно использовать модели для AI coding с прозрачной поминутной аналитикой и оплатой только за фактически отправленные токены. Подробная инструкция по настройке сторонних API-ключей в терминальных агентах доступна в BetterToken Docs.

Как собрать диагностику и проверить статус квоты

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

Шаг 1: Зафиксируйте точный текст ошибки

Обратите внимание на текст сообщения в терминале:

• Approaching weekly usage limit — системное уведомление о приближении к порогу недельного пула.
• You have reached your usage limit — полная остановка приёма запросов до момента сброса скользящего окна.
• HTTP 429 Too Many Requests — временное превышение частоты запросов или исчерпание баланса API.

Шаг 2: Проверьте панель использования в личном кабинете

Откройте страницу статистики в веб-консоли вашего провайдера:

• Проверьте дату и время ближайшего сброса скользящего окна (Reset Time).
• Оцените распределение нагрузки по дням недели, чтобы выявить всплески потребления.

Когда остановить задачу и как сохранить handoff

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

Выполните процедуру безопасной фиксации (Handoff):

1. Создайте снимок состояния репозитория: Зафиксируйте незавершённые изменения во временной ветке:

git checkout -b task/pause-checkpoint
git add -A
git commit -m "checkpoint: фиксация промежуточного состояния перед сбросом лимита"

2. Сформируйте файл передачи контекста (HANDOFF.md): Опишите выполненные шаги, оставшиеся нерешёнными подзадачи и список файлов, ожидающих проверки. Это позволит новой сессии сразу продолжить работу без необходимости перечитывать весь проект заново.

3. Завершите активную сессию: Закройте текущий процесс в терминале, чтобы избежать фоновых повторных попыток отправки запросов.

Подписка и API — разные контуры

Частая ошибка пользователей — попытка пополнить баланс API в надежде, что это снимет ограничение веб-подписки в Claude Code, или наоборот.

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