Как не потерять контроль над Claude Code и своими деньгами

Недавно Anthropic выпустили Claude Code — CLI-инструмент, который пишет код прямо в терминале. Штука крутая, но есть нюанс. Когда отдаешь агенту бразды правления, легко впасть в транс, наблюдая за бегущими строками, а потом обнаружить, что баланс API пуст, а агент зациклился на исправлении одной и той же ошибки в тестах.

Я наткнулся на репозиторий Claude-Code-Agent-Monitor. Это полноценная админка для ваших локальных сессий с ИИ. Если вы когда-нибудь ловили себя на мысли «а что он там вообще делает в фоне?», этот проект как раз закроет вопрос.

Зачем это нужно, если есть терминал

Когда агент работает над большой задачей, он часто плодит субагентов. В консоли это выглядит как бесконечный поток логов. Уследить за иерархией вызовов, стоимостью конкретной ветки размышлений или просто вовремя нажать на тормоз бывает сложно.

Claude-Code-Agent-Monitor выносит всю активность в веб-интерфейс. Это не просто «красивые графики», а рабочий инструмент для отладки поведения нейронки. Вы видите дерево агентов, каждый вызов инструмента (Bash, Edit, Read) и, что самое важное, реальную стоимость сессии в долларах.

Что внутри этой админки

Разработчик проекта упаковал сюда столько всего, что проект тянет на полноценную платформу мониторинга.

Канбан-доска для агентов

Самая наглядная часть. Все запущенные процессы распределяются по колонкам: работают, ждут ввода от пользователя, завершены или упали с ошибкой. Если Claude Code застрял на подтверждении прав (permission prompt), вы увидите это в колонке Waiting.

Детальная аналитика токенов

Проект умеет считать деньги. Он подтягивает актуальные цены для моделей семейства Opus, Sonnet и Haiku. Можно настроить свои правила тарификации, если вы используете какие-то специфические эндпоинты. На графиках видно распределение: сколько ушло на входные данные, сколько на генерацию и сколько вы сэкономили благодаря кэшированию контекста.

Визуализация ворклоу (Workflow)

Здесь используются D3.js диаграммы. Можно посмотреть граф оркестрации: кто кого породил и какие инструменты вызывал. Есть даже диаграммы Санки для потоков исполнения и тепловые карты активности. Это помогает понять, на каких этапах агент тупит или делает лишние действия.

Встроенный запуск Claude

В интерфейсе есть вкладка Run Claude. Можно запустить новую сессию или продолжить старую прямо из браузера. Поддерживается стриминг текста в реальном времени, работа с файлами через @ и автодополнение слэш-команд.

Технический стек и установка

Автор выбрал классический и надежный стек: Node.js с Express на бэкенде, React с Vite на фронте. Данные хранятся в локальной базе SQLite. Интересно, что проект работает через систему хуков самого Claude Code. Когда агент выполняет действие, он отправляет JSON-событие на локальный сервер монитора.

Для старта нужно выполнить стандартный набор команд:

git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git
cd Claude-Code-Agent-Monitor
npm run setup
npm run install-hooks
npm run dev

Команда install-hooks прописывает путь к обработчику в ваш ~/.claude/settings.json. После этого любая активность в терминале будет зеркалироваться в дашборд.

Маленькие приятные фишки

В углу экрана живет Табби — анимированный кот-компаньон. Его настроение меняется в зависимости от того, что происходит с вашими агентами. Если все работает — он доволен, если агент выдал ошибку — кот выглядит обеспокоенным. Глупость, конечно, но в процессе долгой отладки это немного разряжает обстановку.

Для тех, кто не хочет держать открытой вкладку браузера, есть десктопное приложение под macOS и Windows (на базе Electron). Оно сворачивается в трей и присылает системные уведомления, если агенту нужна помощь или закончились токены.

Для любителей автоматизации предусмотрен MCP-сервер (Model Context Protocol). Это значит, что вы можете попросить самого Клода проанализировать статистику своих же сессий через этот монитор.

Стоит ли ставить

Если вы запускаете Claude Code раз в неделю, чтобы поправить опечатку, то этот комбайн вам ни к чему. Но если вы используете ИИ-агентов как полноценных напарников, которые часами рефакторят код или пишут тесты, то мониторинг обязателен.

Главный плюс проекта в том, что он дает прозрачность. Вы видите, за что платите Anthropic и где агент начинает «галлюцинировать» бесконечными циклами вызовов. Из минусов — проект активно растет, и README местами перегружен деталями, но основная функциональность заводится за пять минут.

В итоге имеем отличный инструмент для тех, кто хочет сделать работу с ИИ-агентами предсказуемой и наглядной. По крайней мере, теперь вы точно будете знать, на что ушли те 10 долларов за последние полчаса.