ccam-cost-guard — хук для Claude Code: учёт расходов и прогноз затрат
Хук ccam-cost-guard отслеживает расходы на Claude Code и отправляет данные о завершении сессий в дашборд Agent Monitor.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-cost-guard@claude-code-agent-monitor-pluginsЧто делает ccam-cost-guard
Хук перехватывает событие Stop в Claude Code и передаёт отчёт о сессии в локальный монитор. При остановке агента скрипт собирает session_id, причину завершения и метку времени через утилиту jq. Затем он отправляет POST-запрос на http://localhost:4820/api/hooks/event с помощью curl. Скрипт подавляет ошибки сети.
Движок Agent Monitor сопоставляет расходы с целевым бюджетом и рассчитывает прогноз затрат до конца месяца по дневному тренду. Система выявляет самые дорогие сессии, оценивает потенциальную выгоду от маршрутизации запросов на дешёвые модели и применяет правила оповещений о лимитах.
Для отправки метрик требуются установленные в системе jq и curl. Без запущенного сервиса на http://localhost:4820 данные никуда не уйдут, хотя команда завершится тихо благодаря || true.
Какие задачи решает
- Контролировать бюджет при регулярной работе с Claude Code
- Прогнозировать затраты на API к концу месяца по дневному тренду
- Находить самые дорогие сессии в истории запусков
- Оценивать экономию при переключении на более дешёвые модели
- Настраивать правила оповещений при превышении порогов расходов
Примеры запросов агенту
- Заверши рефакторинг модуля и останови сессию
- Останови работу и подготовь сводку изменений
Как установить ccam-cost-guard
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-cost-guard@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о ccam-cost-guard
Как установить ccam-cost-guard в Claude Code?
Сначала подключите репозиторий командой /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor. Затем выполните /plugin install ccam-cost-guard@claude-code-agent-monitor-plugins или пропишите хук вручную в .claude/settings.json.
Что делает ccam-cost-guard?
Он перехватывает событие Stop и пересылает параметры сессии в дашборд Agent Monitor. Это позволяет следить за расходом средств, прогнозировать затраты и отслеживать дорогие запуски.
Что нужно для работы хука ccam-cost-guard?
В системе должны быть утилиты jq и curl, а по адресу http://localhost:4820 должен отвечать сервер Agent Monitor. Если сервер недоступен, хук завершит вызов без ошибок в консоли.
Исходный текст
hooks.json · MIT
Hooks bundle shipped with the ccam-cost-guard plugin for Claude Code.
Budget tracking, spend forecasting, and cost-threshold alerts for Claude Code usage via the Agent Monitor pricing engine. Watches spend against a target budget, projects month-end cost from the daily trend, surfaces the priciest sessions, estimates savings from cheaper-model routing, and wires up cost alert rules — all backed by the dashboard at http://localhost:4820.
Triggers on: Stop.
```json
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "jq -c '{event_type: \"Stop\", session_id: .session_id, stop_reason: .stop_reason, timestamp: (now | todate)}' 2>/dev/null | curl -s -X POST http://localhost:4820/api/hooks/event -H 'Content-Type: application/json' -d @- > /dev/null 2>&1 || true"
}
]
}
]
}
}
```
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor