overspend — команда для Claude Code: что делает и как установить
Команда overspend находит самые затратные сессии Claude Code через локальный дашборд и выводит их список с расходами в долларах. Помогает сразу заметить перерасход бюджета.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-cost-guard@claude-code-agent-monitor-pluginsЧто делает overspend
Команда запрашивает последние сессии через локальный API монитора по адресу http://localhost:4820/api/sessions?limit=200. Полученные данные сортируются по убыванию стоимости, после чего агент формирует таблицу из N самых дорогих сессий. По умолчанию выводятся топ-10. В отчёт попадают идентификатор сессии, модель, дата запуска, число ходов диалога turn_count и сумма в долларах с четырьмя знаками после запятой.
Под таблицей выводятся две итоговые строки: суммарная стоимость выбранных сессий с их долей в общих расходах и предупреждения. Если в топе оказывается сессия на Opus с малым количеством ходов, команда помечает её как кандидата на дауншифт и ссылается на скилл model-savings.
Вся работа идёт исключительно в режиме чтения. Если локальный дашборд выключен, запрос к API упадёт с ошибкой. Для работы команды нужно предварительно поднять монитор командой npm start из корня репозитория Claude-Code-Agent-Monitor.
Какие задачи решает
- найти самые дорогие сессии Claude Code
- рассчитать долю топовых сессий в общих расходах
- выявить неэффективные сессии на модели Opus с малым числом ходов
Примеры запросов агенту
- /overspend
- /overspend 5
- /overspend 20
Как установить overspend
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-cost-guard@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/commands/overspend.mdВызов — /overspend. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/overspend.mdВызов — /prompts:overspend. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/overspend.prompt.mdВручную: положить файлы
.gemini/commands/overspend.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы об overspend
Как установить overspend в Claude Code?
Выполните по очереди команды в Claude Code: сначала /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, затем /plugin install ccam-cost-guard@claude-code-agent-monitor-plugins.
Что делает команда overspend?
Она обращается к локальному API мониторинга, сортирует сессии по стоимости и выводит таблицу самых дорогих диалогов с подсчётом их доли в общем бюджете.
Что делать, если команда не может достучаться до дашборда?
Если адрес http://localhost:4820 недоступен, запустите локальный сервер мониторинга командой npm start из корня репозитория.
Исходный текст
overspend.md · MIT
--- description: List the most expensive sessions pushing your spend up argument-hint: "[top-N]" --- List the sessions driving Claude Code spend up — the **top $ARGUMENTS** most expensive (default top 10 if empty). 1. Fetch a wide slice of sessions: ``` curl -s "http://localhost:4820/api/sessions?limit=200" ``` 2. Sort the returned sessions by inline `cost` **descending** and take the top N. 3. Print a table — rank, session id/name, `model`, `started_at`, `metadata.turn_count`, and `cost` (USD, 4 decimals). Below it: - **Sum of the top N** and what share of fleet spend they represent (sum top-N `cost` / sum of all `cost`). - Flag any Opus session with a low `turn_count` as a downshift candidate (point to the `model-savings` skill). If the dashboard is unreachable, tell the user to start it with `npm start` from the repo root. Keep it to one table plus two summary lines. Read-only — do not modify anything.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor