budget — команда для Claude Code: что делает и как установить
Команда budget показывает расход на Claude и сверяет его с месячным бюджетом: сколько ушло, какой это процент и кто из моделей съел больше всех.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-cost-guard@claude-code-agent-monitor-pluginsЧто делает budget
Команда берёт сумму месячного бюджета в долларах и сверяет с ней текущий расход на Claude. Цифры тянет с локального дашборда через curl -s http://localhost:4820/api/pricing/cost, оттуда читает total_cost и разбивку по моделям.
На выходе несколько строк и таблица: потрачено на сегодня (USD с четырьмя знаками после точки), ваш бюджет, процент израсходованного и ▲/▼ относительно линейного темпа — бюджет × день месяца / дней в месяце. Дальше вердикт: в бюджете, идёте по темпу или вышли за него, и топ-3 модели по стоимости с долей от общей суммы.
Считает только при живом дашборде: если curl к localhost:4820 не отвечает, команда попросит поднять его через npm start из корня репозитория. Без аргумента покажет расход и спросит бюджет. Сама ничего не пишет и не меняет.
Какие задачи решает
- узнать, сколько уже потрачено на Claude
- сверить расход с месячным бюджетом в долларах
- понять, опережаешь ли линейный темп трат
- найти три самые дорогие модели в разбивке по стоимости
- заметить перерасход, пока месяц не закрылся
Примеры запросов агенту
- /budget 50
- /budget 200
- /budget
Как установить budget
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-cost-guard@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/commands/budget.mdВызов — /budget. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/budget.mdВызов — /prompts:budget. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/budget.prompt.mdВручную: положить файлы
.gemini/commands/budget.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о budget
Как установить budget в Claude Code?
Через маркетплейс: сначала /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, потом /plugin install ccam-cost-guard@claude-code-agent-monitor-plugins. Файл самой команды — .claude/commands/budget.md.
Что делает команда budget?
Запрашивает у дашборда суммарный расход и разбивку по моделям, печатает потраченную сумму, процент от бюджета и вердикт по темпу трат.
Почему команда не показывает цифры?
Не запущен дашборд на localhost:4820. Поднимите его через npm start из корня репозитория и повторите вызов.
Исходный текст
budget.md · MIT
--- description: Show current Claude Code spend versus a budget number argument-hint: "[monthly-$]" --- Show current Claude Code spend against the budget **$ARGUMENTS** (a monthly dollar figure, e.g. `50`). If `$ARGUMENTS` is empty, just report spend-to-date and ask for a budget. 1. Fetch current spend: ``` curl -s http://localhost:4820/api/pricing/cost ``` Read `total_cost` (spend-to-date) and the per-model `breakdown`. 2. Print a concise budget status: - **Spend to date**: `total_cost` as USD to 4 decimals. - **Budget**: `$ARGUMENTS`/month. - **Consumed**: `total_cost / budget × 100`% — with a ▲/▼ vs. the linear pace expected for today's day-of-month (`budget × day_of_month / days_in_month`). - **Verdict**: under budget / on pace / over budget. - **Top 3 models by cost** from the breakdown (model, cost, % of total). If the dashboard is unreachable (curl fails / empty), tell the user to start it with `npm start` from the repo root. Keep the output to a few lines plus one small table. Currency as USD to 4 decimal places. Read-only — do not modify anything.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor