codeburn - CodeBurn: куда уходят токены агента

Когда звать

• Когда лимит подписки кончается быстрее, чем ждал, и непонятно, какой проект или какая модель его съели.
• Когда хочешь проверить, не тащит ли агент в каждый запрос лишнее - раздутый CLAUDE.md, забытые MCP-серверы, скиллы.

Что это

CodeBurn - открытая программа, которая показывает, куда уходят токены и деньги у агентов для кода. Это не скилл, а отдельная программа для терминала (плюс по желанию приложение для рабочего стола и MCP-сервер). Автор - команда AgentSeal, лицензия MIT.

Claude Code, Codex, Cursor и другие агенты после каждой сессии пишут у тебя на диске файл, где записан каждый запрос к модели и каждый токен. CodeBurn читает эти файлы и раскладывает расход: по программам, по моделям, по проектам и по задачам (писал код, чинил ошибку, планировал). Сумма считается по ценам API - то есть это «сколько бы стоило», а не счёт от Anthropic. На подписке это единственный способ увидеть, что именно съело лимит.

Регистрации, аккаунта и ключей не нужно.

Зачем он мне

Подписка показывает только одно: лимит кончился. А почему - нет. CodeBurn отвечает на вопрос «куда ушло»: какой проект самый прожорливый, какая модель, в какой день был перерасход. Команда codeburn optimize ищет, что тратит токены впустую: файл, который агент перечитывает на каждом шаге, MCP-сервер, который стоит, но ни разу не вызывался, CLAUDE.md, который разросся и едет в каждом запросе.

Как поставить в Claude Code

Команды сверены с README репозитория на 28 сентября 2026 года. Нужен Node.js версии 22.13 или новее.

Просто посмотреть расход - одна команда в терминале, ничего не устанавливая насовсем:

npx codeburn

Откроется таблица: сколько потрачено, по программам, моделям, проектам и задачам. Стрелки меняют период (от сегодня до всей истории), p переключает программы, q - выход.

Поставить насовсем, чтобы команда была всегда под рукой:

npm install -g codeburn

или через Homebrew на Маке: brew install codeburn.

Чтобы агент сам отвечал про расход прямо в чате, подключи его как MCP-сервер:

claude mcp add codeburn -- npx -y codeburn mcp

После этого можно спросить агента «куда ушли токены на этой неделе» или «что поменять, чтобы тратить меньше». У сервера два инструмента: get_usage (расход с разбивкой) и get_savings (где расход лишний, работает дольше).

Как поставить в Codex

Отдельно ставить ничего не нужно: та же команда npx codeburn сама находит сессии Codex на диске и показывает их расход рядом с Claude Code. Переключиться между программами - клавиша p.

Если хочешь, чтобы и Codex отвечал про расход в чате, подключи MCP-сервер: по README подходит любой MCP-клиент, команда npx, аргументы -y codeburn mcp. Отдельной инструкции именно для Codex у автора на 28 сентября 2026 года нет.

Как пользоваться

• codeburn - главная таблица расхода.
• codeburn optimize - список того, что тратит токены без пользы, с оценкой, сколько сэкономит каждое исправление.
• codeburn plan set claude-max - сказать, какая у тебя подписка (есть claude-pro, claude-max и другие). Тогда видно, какую долю тарифа уже потратил и уложишься ли до конца месяца.
• codeburn quota - сколько осталось в текущих окнах лимита (пятичасовое и недельное).
• codeburn web - то же самое в браузере.

Можно просто спросить агента, если подключил MCP: «покажи, какой проект съел больше всего за месяц».

Безопасность

Мы прочитали код программы в репозитории (версия 0.9.25, последний коммит 27.09.2026). Опасного не нашли: команд вида «скачай и запусти», скрытой отправки твоих данных, удаления чужих файлов нет. Что программа делает на компьютере:

• Читает с диска файлы сессий твоих агентов (папки Claude Code, Codex и других) и их настройки. Твои запросы, код, названия файлов и проектов по README никуда не отправляются.
• Ходит в сеть: раз в сутки скачивает таблицу цен моделей с GitHub (проект LiteLLM). Если выбрал валюту не доллар - курсы с сервиса Frankfurter. Команда codeburn quota спрашивает у Anthropic, OpenAI и других, сколько осталось лимита, используя вход, который у тебя уже сохранён в Claude Code или Codex (из связки ключей Мака или файла ~/.codex/auth.json). Для Codex она при необходимости обновляет токен входа и записывает его обратно в этот же файл. Не запускаешь quota - этого не происходит.
• Пишет на диск свой кэш и историю по дням в ~/.cache/codeburn/.
• Меняет настройки только по твоей команде. codeburn optimize --apply показывает изменения, делает копию файлов и после подтверждения убирает неиспользуемые MCP-серверы из ~/.claude.json или .mcp.json, а неиспользуемые скиллы переносит в ~/.claude/skills/.archived/ (не удаляет). Откатить - codeburn act undo --last. codeburn guard install добавляет в ~/.claude/settings.json хуки, которые предупреждают на $5 и останавливают сессию на $15; убрать - codeburn guard uninstall.
• Телеметрия. Программа для терминала ничего о тебе не отправляет. Приложение для рабочего стола может раз в день отправлять обезличенную сводку (названия моделей, скиллов, MCP-серверов и примерный расход диапазонами), но только после согласия на первом экране. Выключается в настройках: Settings > Privacy & data.
• Команды codeburn menubar и установщики приложений скачивают программу с GitHub-релизов автора - это их прямая задача. Обмен данными между двумя своими компьютерами (codeburn share) работает только в домашней сети и только если сам его включил.

Вывод: безопасно. Программа только читает твои записи и считает. Перед optimize --apply смотри, что именно она предлагает убрать, а quota запускай, если готов, что программа воспользуется твоим уже сохранённым входом, чтобы спросить остаток лимита.

Что держать в голове

• Цифры - оценка по ценам API. Это не счёт, а «сколько стоило бы». На подписке полезно для сравнения проектов и дней между собой.
• Старые сессии. Если агент удалил старые файлы сессий, подробностей по ним уже не будет, но итоги по дням программа хранит у себя.
• Нужен свежий Node.js - 22.13 или новее. Со старым npx codeburn не запустится.

Вопросы и ответы

Это скилл? Нет, это программа. К агенту она подключается как MCP-сервер, если хочешь спрашивать про расход прямо в чате.

Бесплатно? Да, целиком, лицензия MIT. Платных тарифов нет, автор собирает пожертвования через GitHub Sponsors.

Нужен ли ключ API? Нет. Программа читает файлы, которые уже лежат у тебя на диске.

С какими агентами работает? По README - около сорока: Claude Code, Codex, Cursor, Gemini и другие. Программа сама находит те, что у тебя стоят.

Автор и источник

Программа открытая, чужая, лицензия MIT, автор - AgentSeal. Описание и команды сверены с README репозитория getagentseal/codeburn, страницей про MCP и кодом версии 0.9.25 на 28 сентября 2026 года.