forecast команда для Claude Code: прогноз расходов до конца месяца
Команда forecast считает, сколько вы потратите к концу недели или месяца: берёт счётчики сессий и стоимость из дашборда на localhost:4820 и достраивает прогноз по средней цене сессии.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-cost-guard@claude-code-agent-monitor-pluginsЧто делает forecast
Команда принимает week или month, без аргумента считает месяц. Сначала два запроса к локальному дашборду: curl -s http://localhost:4820/api/analytics и curl -s http://localhost:4820/api/pricing/cost. Из первого берутся счётчики сессий по дням и их общее число, из второго — total_cost.
Дальше арифметика: средняя стоимость сессии, средний дневной расход по последним 7 дням, сколько дней осталось до конца периода, и итог — потраченное плюс прогноз на остаток. На экран выходит четыре строки: расход на текущий момент, avg_daily_spend, days_remaining и сумма в USD с 4 знаками. Рядом стрелка ▲ или ▼: темп последней недели против предыдущих двух.
Дневной расход считается от числа сессий, точных трат по дням команда не знает. Дашборд должен быть запущен на localhost:4820, иначе она попросит поднять его через npm start из корня репозитория. Ничего не меняет.
Какие задачи решает
- узнать, сколько уйдёт на API до конца месяца
- заметить, что последняя неделя идёт быстрее двух предыдущих
- прикинуть остаток трат перед закрытием периода
- снять цифру с дашборда, не открывая браузер
- сравнить дневной темп с двухнедельным
Примеры запросов агенту
/forecast month— прогноз трат до конца месяца/forecast week— сколько уйдёт к воскресенью- Сделай прогноз расходов по дашборду на
localhost:4820
Как установить forecast
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-cost-guard@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/commands/forecast.mdВызов — /forecast. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/forecast.mdВызов — /prompts:forecast. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/forecast.prompt.mdВручную: положить файлы
.gemini/commands/forecast.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о forecast
Как установить forecast в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, затем поставьте плагин: /plugin install ccam-cost-guard@claude-code-agent-monitor-plugins. Сама команда лежит в файле .claude/commands/forecast.md.
Что делает forecast?
Считает средний дневной расход и достраивает его до конца недели или месяца по данным дашборда. Показывает потраченное, avg_daily_spend, days_remaining и прогноз в USD с 4 знаками.
Что нужно, чтобы forecast сработал?
Запущенный дашборд на localhost:4820 с эндпоинтами /api/analytics и /api/pricing/cost. Если он не отвечает, команда попросит поднять его через npm start из корня репозитория.
Исходный текст
forecast.md · MIT
---
description: Quick month-end spend projection from the daily trend
argument-hint: "[week|month]"
---
Give a quick spend projection for the end of the **$ARGUMENTS** period (`week` or
`month`; default `month` if empty).
1. Fetch the trend and current spend in parallel:
```
curl -s http://localhost:4820/api/analytics
curl -s http://localhost:4820/api/pricing/cost
```
From `/api/analytics` read `daily_sessions` (`[{ date, count }]`) and the session
total; from `/api/pricing/cost` read `total_cost`.
2. Project:
- `avg_cost_per_session = total_cost / total_session_count`.
- `avg_daily_spend = mean(last 7 days of daily_sessions[].count) × avg_cost_per_session`.
- `days_remaining` = days left until end of the chosen period (week → Sunday; month → last calendar day).
- `projected_total = total_cost + avg_daily_spend × days_remaining`.
3. Print: spend-to-date, `avg_daily_spend`, `days_remaining`, and the **projected end-of-period total** (USD, 4 decimals), with a ▲/▼ note on whether the 7-day pace is above or below the trailing 14-day pace.
State that daily spend is approximated from session counts. If the dashboard is
unreachable, tell the user to start it with `npm start` from the repo root. Keep it to
a few lines. Read-only — do not modify anything.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor