# budget-sentinel

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

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 1198 у репозитория
- Автор: Son Nguyen
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/plugins/ccam-cost-guard/agents/budget-sentinel.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/budget-sentinel

## Что делает

Субагент берёт расходы Claude из API дашборда Agent Monitor на `http://localhost:4820` и сравнивает их с бюджетом, который вы назвали. Считает не на глаз: тянет `total_cost` из `/api/pricing/cost`, разбивку по моделям, историю сессий из `/api/analytics` и список правил из `/api/alerts/rules`. Дальше — прогноз до конца месяца или недели: средний дневной расход умножается на оставшиеся дни.

Внутри инструкция из семи шагов, от постановки бюджета до ранжированных советов по сокращению. Он смотрит сессии с наибольшей ценой, ищет дорогие модели на мелкой работе и сверяет рекомендации с уже настроенными алертами. Инструменты скромные: `Bash` для `curl`, `Read` и `Grep`. Модель: `sonnet`.

Роль только совещательная: правила алертов он предлагает поменять, но не создаёт их сам. Без запущенного дашборда субагент ничего не посчитает — попросит поднять его командой `npm start` из корня репозитория. И ещё: алерты в дашборде считают токены, а не доллары, поэтому бюджет придётся перевести в токены через средневзвешенную ставку.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
```
В чате агента (не в терминале):
```text
/plugin install ccam-cost-guard@claude-code-agent-monitor-plugins
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/budget-sentinel.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/budget-sentinel.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/budget-sentinel.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/plugins/ccam-cost-guard/agents/budget-sentinel.md

## Когда брать
- узнать, сколько уже потрачено на Claude и на каких моделях
- спрогнозировать расход до конца месяца по дневному тренду сессий
- найти сессии, которые тянут бюджет вверх
- сверить бюджет с настроенными правилами алертов
- получить список сокращений с оценкой экономии в долларах

## Примеры запросов агенту
- Проверь расход за месяц против бюджета в $50 и скажи, вылезаем ли мы за него.
- Какие сессии съедают больше всего? Отсортируй по стоимости и предложи, что сократить.
- Переведи бюджет $10 в неделю в лимит токенов для правила `token_threshold` и покажи расчёт.

## Похожие
- [cost-budget-check](https://affpapa.org/nevibecode/skills/cost-budget-check.md) — скилл · 693 установки
- [omni-budget](https://affpapa.org/nevibecode/skills/omni-budget.md) — скилл · 1300 установок
- [cost-summary](https://affpapa.org/nevibecode/skills/cost-summary.md) — скилл · 684 установки
- [ad-budget-pacing](https://affpapa.org/nevibecode/skills/ad-budget-pacing.md) — скилл · 26700 установок
- [devrel-budget-allocation](https://affpapa.org/nevibecode/skills/devrel-budget-allocation.md) — скилл · 13900 установок
- [budget-optimizer](https://affpapa.org/nevibecode/skills/budget-optimizer.md) — скилл · 1200 установок

Из того же набора: [hoangsonww/claude-code-agent-monitor](https://affpapa.org/nevibecode/by/hoangsonww/claude-code-agent-monitor.md) — 155 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
