Codex Quota

Codex Quota

Инструмент для проверки лимитов OpenAI Codex CLI (дневные и недельные квоты) на основе локальных логов сессий. Представляет собой переносимый Python-скрипт, который считывает данные из каталога ~/.codex/sessions/. :

Установка

Установить инструмент можно с помощью ClawHub:

clawhub install codex-quota

После установки вы сможете запускать его напрямую через CLI.

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

Запустите Python-скрипт:

./codex-quota.py

Или, если добавлен в PATH:

codex-quota

Опции

codex-quota # Показать текущую квоту (из последней сессии)
codex-quota --fresh # Запросить актуальные данные у Codex
codex-quota --all --yes # Проверить все аккаунты и сохранить результат
codex-quota --json # Вывести данные в формате JSON
codex-quota --help # Показать справку

Что показывает инструмент

• Primary Window (5 часов) — краткосрочный лимит
• Secondary Window (7 дней) — недельная квота
• Время сброса лимитов с обратным отсчётом
• Источник сессии и её возраст

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

• Перед запуском ресурсоёмких задач в Codex
• Если Codex начинает работать медленно
• Для мониторинга квот на нескольких аккаунтах

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

Скрипт анализирует файлы сессий Codex, в которых фиксируются данные о лимитах API. Эти данные записываются в виде событий token_count и содержат информацию о текущем использовании квоты. :

По умолчанию используется кэш последней сессии, что позволяет мгновенно получить результат без дополнительных API-запросов. При использовании параметра --fresh инструмент обращается напрямую к Codex CLI для получения актуальных данных. :

Режим --all --yes временно переключает аккаунты, перезаписывая файл ~/.codex/auth.json, чтобы собрать статистику по всем сохранённым профилям (после завершения исходный файл восстанавливается). :

Практические сценарии

• Проверка доступной квоты перед генерацией большого объёма кода
• Анализ использования лимитов в команде
• Диагностика проблем с API (например, замедлений)
• Автоматический сбор статистики через JSON-вывод

Лучшие практики

• Используйте обычный режим для быстрого просмотра кэшированных данных
• Запускайте --fresh только при необходимости актуальной информации
• Избегайте параллельных запусков Codex при использовании --all --yes
• Создавайте резервную копию auth.json перед экспериментами
• Используйте JSON-вывод для интеграции с мониторингом

FAQ

Безопасно ли использовать режим --all --yes?
Да, файл аутентификации перезаписывается временно и восстанавливается после завершения. Тем не менее рекомендуется закрыть другие процессы Codex и иметь резервную копию.

Где сохраняется JSON с результатами?
По умолчанию агрегированные данные сохраняются в /tmp/codex-quota-all.json.