Claude Code Usage

Claude Code Usage — это инструмент для проверки использования Claude Code через OAuth API с учетом лимитов сессии (5 часов) и недельных ограничений (7 дней).

Что делает этот инструмент

Скилл позволяет получать точные данные об использовании Claude Code, включая процент загрузки лимитов и время до их сброса. Это особенно важно, так как CLI Claude Code напрямую не показывает такие детали.

Он обращается к API Anthropic, обрабатывает метрики и отображает их в удобном формате — с прогресс-барами, цветовой индикацией и расчетом времени до обновления лимитов.

Когда использовать

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

Быстрый старт

cd {baseDir}
./scripts/claude-usage.sh

Использование

# Показать кэшированные данные (по умолчанию)
./scripts/claude-usage.sh

# Принудительно обновить через API
./scripts/claude-usage.sh --fresh

# Вывод в формате JSON
./scripts/claude-usage.sh --json

# Задать TTL кэша
./scripts/claude-usage.sh --cache-ttl 300

Формат вывода

Текстовый формат (по умолчанию):

Claude Code Usage

⏱️ Session (5h): 🟢 ████░░░░░░ 40%
Resets in: 2h 15m

📅 Weekly (7d): 🟡 ██████░░░░ 60%
Resets in: 3d 8h

JSON формат:

{
 "session": {
 "utilization": 40,
 "resets_in": "2h 15m",
 "resets_at": "2026-01-19T22:15:00Z"
 },
 "weekly": {
 "utilization": 60,
 "resets_in": "3d 8h",
 "resets_at": "2026-01-22T04:00:00Z"
 },
 "cached_at": "2026-01-19T20:00:00Z"
}

Основные возможности

• Контроль лимита сессии (5 часов)
• Контроль недельного лимита (7 дней)
• Умное кэширование (по умолчанию 60 секунд)
• Визуальный вывод с прогресс-барами и цветами
• Принудительное обновление данных
• Поддержка JSON для автоматизации
• Автоматический мониторинг и уведомления

Индикаторы состояния

• 🟢 Зеленый — 0–50% (нормально)
• 🟡 Желтый — 51–80% (умеренная нагрузка)
• 🔴 Красный — 81–100% (критический уровень)

Требования

• macOS — используется Keychain для хранения токенов
• Linux — используется secret-tool
• Авторизация в Claude Code CLI обязательна

Как это работает

• Получение OAuth-токена из системного хранилища
• Запрос к API Anthropic
• Парсинг метрик использования (5 часов и 7 дней)
• Расчет времени до сброса лимитов
• Формирование визуального вывода
• Кэширование результатов

Кэширование

По умолчанию используется файл /tmp/claude-usage-cache с TTL 60 секунд. Эти параметры можно переопределить через переменные окружения.

CACHE_FILE=/tmp/my-cache
CACHE_TTL=300
./scripts/claude-usage.sh

Примеры использования

• Проверка лимитов перед началом работы
• Интеграция в статусную строку терминала
• Получение данных для систем мониторинга

Автоматический мониторинг

Рекомендуемый способ: напоминания о сбросе сессии.

./scripts/session-reminder.sh

Скрипт создает цепочку cron-задач, которые:

• Определяют время окончания текущей сессии
• Планируют следующее уведомление
• Отправляют уведомление с актуальной статистикой
• Автоматически обновляют сами себя

Преимущества:

• Точность до минуты
• Не требует ручной настройки
• Адаптируется под реальное использование
• Минимальное количество API-запросов

Альтернатива

Можно использовать мониторинг через периодические проверки (polling), однако это менее эффективно по сравнению с системой напоминаний.

Устранение проблем

• Нет учетных данных — убедитесь, что Claude Code установлен и авторизован
• Ошибка API — проверьте интернет и токен
• На Linux установите libsecret-tools