Подключите аккаунты.
Понимайте свои данные.

Требования и информация о выпуске

AIUsageWatch — бесплатное нативное приложение в строке меню для macOS 14 или новее. Публичный выпуск готовится. Проверенная ссылка для скачивания появится на сайте, когда приложение будет доступно. Аккаунты провайдеров и оплата их тарифов оформляются отдельно.

Переместите выпущенное приложение в Applications, прежде чем включить Открывать при входе. Приложение работает в строке меню и не нуждается в значке Dock. Открытие уже запущенного приложения из Finder выводит настройки на передний план.

Подключение провайдеров

1. Codex: установите Codex CLI и войдите в аккаунт. Укажите для аккаунта каталог конфигурации, обычно ~/.codex. Приложение использует сохранённую авторизацию этого каталога через локальный CLI app-server.
2. Claude: по умолчанию аккаунт ~/.claude использует ваш сеанс claude.ai в Safari. В настройках разрешите доступ к файлу Safari Cookies.binarycookies . Для отдельного каталога конфигурации Claude войдите через Claude Code с этим CLAUDE_CONFIG_DIR; приложение читает его .credentials.json.
3. Cursor: войдите на cursor.com в Safari и разрешите доступ к файлу cookie Safari в настройках. Cursor не использует каталог аккаунта для получения данных.
4. Grok: выберите каталог Grok, содержащий logs/unified.jsonl. Запустите Grok, чтобы обновить запись о квоте в этом журнале.

Приложение считывает доступную информацию о квоте из каждого источника. Источникам Claude и Codex CLI нужна соответствующая сохранённая авторизация. Демонстрация на сайте никогда не обращается к вашим аккаунтам.

Личные и рабочие аккаунты вместе

Откройте Настройки… в меню или нажмите ⌘,. У каждого аккаунта есть название, провайдер, каталог, цвет и буква. Используйте + для добавления каталога; приложение определяет предполагаемого провайдера по его содержимому. Проверьте провайдера перед использованием нового аккаунта.

Для другого аккаунта Codex выберите его отдельный CODEX_HOME. Для другого аккаунта Claude используйте отдельный CLAUDE_CONFIG_DIR с собственными сохранёнными учётными данными. Сеанс Claude в Safari по умолчанию может быть неоднозначным, если включает несколько организаций; в этом случае используйте отдельный каталог конфигурации. Источник Cursor использует доступный сеанс Safari, поэтому добавление дублирующей строки Cursor не создаёт отдельную авторизацию.

Новые аккаунты добавляют столбцы, в каждом из которых не более трёх строк. Собственные буквы и цвета помогают различать аккаунты. Общие настройки включают частоту обновления, отметки процентов, буквы и предупреждение о поддерживаемых сроках действия сбросов Codex в запасе.

Как понимать полоски

Заполненная часть означает остаток квоты. При остатке 0% заполненной полоски нет. Цвет обозначает аккаунт. Меню показывает проценты, доступное время обновления квоты, сведения о соответствующих периодах и статус данных.

Claude включает недельные и доступные пятичасовые сведения; Codex выбирает основной недельный лимит. Cursor использует свой показатель включённого объёма, в ответе которого не назван период использования. Grok использует показатель недельных кредитов из журнала CLI. Проценты разных провайдеров не означают одинаковое число токенов, запросов или долларов.

Замечайте сбросы Codex в запасе до истечения их срока

Когда Codex сообщает о доступных сбросах в запасе и сроках их действия, AIUsageWatch может показать предупреждающую точку рядом с аккаунтом до истечения срока следующего сброса. Откройте меню, чтобы увидеть доступное количество и информацию о сроках. Неиспользованный сброс в запасе может быть потерян, когда срок истечёт; это отдельное событие, не совпадающее с обычным обновлением недельной квоты.

Включите Предупреждать перед сбросом в настройках и задайте срок предупреждения за 1–14 дней. По умолчанию — за два дня, с красной предупреждающей точкой; цвет можно изменить. Точка остаётся видимой, даже если буквы аккаунтов отключены. Предупреждение зависит от того, запущено ли приложение, включены ли предупреждения и доступны ли актуальные сроки действия. Оно не использует сброс в запасе автоматически и не отправляет системное уведомление.

Автоматический запрос Codex для запуска периода

Когда актуальный остаток недельной квоты Codex составляет 100%, AIUsageWatch отправляет один небольшой запрос codex exec с использованием сохранённой авторизации CLI этого каталога. Его цель — запустить недельный период, который иначе может оставаться неактивным. Он использует доступную модель Codex по умолчанию и расходует небольшую часть квоты этого аккаунта.

Красная точка обозначает аккаунт во время выполнения запроса или при ошибке. Меню объясняет статус и позволяет повторить попытку вручную. Приложение запоминает попытку в оперативной памяти для этого недельного периода. Повторные проверки не отправляют новые запросы для запомненной попытки; перезапуск очищает память и может привести к новому запросу, если актуальный остаток всё ещё составляет 100%.

Резервный источник из старых записей сеансов не отправляет запросы для запуска периода. Автоматический запуск периода Claude не включён в текущей версии. Это отдельное действие от чтения данных об использовании; в текущих настройках нет переключателя запуска периода Codex.

Значение устарело, отсутствует или выглядит неожиданным

• Сохранённые данные: последние успешно полученные данные сохраняются в кеше на Mac и восстанавливаются при запуске. Если обновление не удалось, меню показывает их возраст.
• Ограничение частоты запросов или ошибка подключения: повторные попытки откладываются на 15 минут после ограничения частоты и на 2 минуты после других ошибок. Обновить сейчас обходит эту задержку.
• Подключение Safari: проверьте, что выполнен вход у нужного провайдера, разрешён доступ к файлу cookie и сеанс не допускает неоднозначного выбора аккаунта.
• Grok: запустите CLI для записи новых данных об использовании. Истёкший период или старый журнал показывается как исторический источник, а не актуальный остаток.
• Codex: убедитесь, что CLI доступен, а в настроенном каталоге сохранена нужная авторизация. Резервные записи сеансов могут показывать старую информацию, если app-server недоступен.

Адреса API и форматы ответов провайдеров могут меняться. Данные не гарантируют, что провайдер примет следующий запрос. Проверьте страницу аккаунта у провайдера, если остаток или время обновления квоты выглядят неверными.

Локальные настройки и подключения провайдеров

Настройки и сохранённые данные находятся в ~/Library/Application Support/AiUsageWatch/. Приложение не читает Связку ключей напрямую. CLI провайдеров самостоятельно управляют авторизацией. Источники актуальных данных обращаются к соответствующему провайдеру с существующим сеансом или учётными данными. Дополнительные сведения содержит политика конфиденциальности с описанием различий между локальным хранением данных приложения, подключениями провайдеров и сообщениями поддержки.

Сообщить о проблеме

Свяжитесь с поддержкой AIUsageWatch и укажите версию приложения, версию macOS, провайдера, статус данных и действия для воспроизведения проблемы. Если вы используете диагностический режим --dump , проверьте его вывод перед отправкой. Удалите токены, значения cookie, приватные пути аккаунтов и любую другую конфиденциальную информацию. Не загружайте файлы учётных данных.