К основному содержанию
хук CX Codex

ccam-cost-guard — хук для Claude Code: учёт расходов и прогноз затрат

Хук ccam-cost-guard отслеживает расходы на Claude Code и отправляет данные о завершении сессий в дашборд Agent Monitor.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-cost-guard@claude-code-agent-monitor-plugins
Открыть на GitHub

Что делает 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-plugins

2Вручную: положить файлы

.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

Похожие хуки

Все хуки по теме «Настройка агента: память, контекст, субагенты» →
cost-summary ruvnet Скилл cost-summary для Claude Code выгружает сводку расходов на модели и сессии в JSON или Markdown. Показывает разбивку затрат и статус бюджета. CX Codex +1 684установок cost-projection ruvnet Скилл cost-projection для Claude Code прогнозирует расходы по недавним сессиям. Показывает темп трат, суммы на заданные периоды и срок до достижения лимита. CX Codex +1 249установок llmkit smigolsmigol MCP-сервер llmkit отслеживает расходы на модели и контролирует бюджеты агентов. Помогает следить за стоимостью сессий в Claude Code и задачами в Cline. CX Codex +1 ★ 15звёзд репо Agent Cost Report thedotmack Скилл Agent Cost Report для Claude Code и Codex формирует отчёт о расходах агентов за выбранный период. Запускается при оценке затрат на сессии и поиске потерь от переделок или зацикливаний. CX Codex +1 816установок cost-accrual-tracker curiositech Скилл cost-accrual-tracker для Claude Code и пяти других платформ, который считает расходы на API в режиме реального времени во время выполнения LLM-запросов. Фиксирует частичные затраты даже при прерванных запросах. CX Codex +1 175установок cwicr-cost-calculator datadrivenconstruction Скилл cwicr-cost-calculator для Claude Code рассчитывает стоимость строительных работ по методологии CWICR, разбивая затраты на труд, материалы и оборудование с прозрачными расчётами. CX Codex +1 138установок

Из того же набора155

Весь набор →
ccam-productivity Хук ccam-productivity для Claude Code и Codex записывает в лог-файл метки начала и конца сессии Claude Code. По ним можно замерять длительность работы над задачами. CX Codex ★ 1 198звёзд репо ccam-analytics Хук ccam-analytics для Claude Code собирает телеметрию сессий и передаёт события завершения в Agent Monitor. Срабатывает автоматически при остановке сессии или субагента. CX Codex ★ 1 198звёзд репо docs-markdown Правило docs-markdown задаёт требования к markdown-документам проекта: рабочие примеры команд, пути от корня и синхронное обновление всех README, когда меняются процессы. CX Codex +1 ★ 1 198звёзд репо integration-operator Субагент integration-operator управляет оповещениями, вебхуками, push-уведомлениями и SSH-источниками в CCAM. Требует подтверждения записей и скрывает секреты. CX Codex ★ 1 198звёзд репо backend-reviewer Субагент backend-reviewer проверяет маршруты и хуки на регрессии, риски для данных и пробелы в тестах. Подключается к Claude Code и Codex. CX Codex ★ 1 198звёзд репо frontend-react Правило frontend-react для React-фронтенда: держит правки интерфейса узкими — явные типы пропсов, готовые паттерны состояний, маршруты без переделки. CX Codex +1 ★ 1 198звёзд репо platform-admin Субагент platform-admin управляет настройками, хуками, импортом, резервными копиями и MCP в Claude Code Agent Monitor. Проверяет изменения через дашборд. CX Codex ★ 1 198звёзд репо frontend-reviewer Субагент Claude Code frontend-reviewer проверяет изменения в React-интерфейсе на поломки поведения, рассинхрон состояния и ошибки UX. Проводит ревью UI после правок. CX Codex ★ 1 198звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой