Как вернуть контроль над Claude Code и перестать гадать по логам
Недавно Anthropic выпустили Claude Code — консольный инструмент, который сам пишет код, запускает тесты и правит баги. Штука крутая, но у неё есть одна раздражающая особенность. В последних обновлениях разработчики решили «упростить» вывод. Теперь вместо детального отчета вы видите в терминале что-то вроде Read 3 files или Edited 2 files.
Что это за файлы? Какие именно строки изменились? Сколько токенов улетело на этот запрос? Терминал молчит. Можно, конечно, запустить его с флагом --verbose, но тогда на вас вывалится бесконечный поток сырого JSON, системных промптов и технического шума, в котором невозможно ориентироваться.
Проект claude-devtools решает эту проблему максимально изящно. Это десктопное приложение, которое подхватывает локальные логи Claude и превращает их в понятный дашборд.
Что это такое и зачем оно в вашем тулбоксе
По сути, это полноценный инспектор для AI-агента. Если вы привыкли работать в Chrome DevTools, то здесь логика похожая. Приложение не пытается заменить собой Claude Code и не оборачивает его в свои промпты. Вы продолжаете работать в привычном терминале, а claude-devtools в реальном времени отрисовывает всё, что происходит «под капотом».
Главная ценность здесь в прозрачности. Когда агент начинает «галлюцинировать» или раз за разом совершает одну и ту же ошибку, в обычном терминале трудно понять причину. claude-devtools показывает полную цепочку вызовов, включая скрытые размышления (thinking) и работу субагентов.
Пять вещей, которые делает этот инструмент
Реконструкция контекста
Claude Code не говорит прямо, что именно сейчас находится в его «памяти». Инструмент восстанавливает эту картину по шагам. Он анализирует, какие файлы из CLAUDE.md были подтянуты, какие навыки активированы и сколько токенов занял ваш последний промпт. В интерфейсе это выглядит как наглядная диаграмма с разбивкой по категориям.
https://raw.githubusercontent.com/matt1398/claude-devtools/main/https://github.com/user-attachments/assets/9ff4a5a7-bcf6-47fb-8ca5-d4021540804b
Визуализация сжатия (Compaction)
У контекстного окна есть предел. Когда он достигается, Claude Code тихо «схлопывает» историю диалога, чтобы освободить место. В терминале вы этого даже не заметите, просто в какой-то момент нейронка может «забыть» детали начала беседы. Приложение ловит эти моменты и показывает, как именно изменился объем данных после сжатия.
Инспектор вызовов инструментов
Вместо сухих строчек о чтении файлов вы получаете полноценный просмотрщик кода с подсветкой синтаксиса и номерами строк. Если Claude правил код, вы увидите привычный diff с подсветкой добавленных и удаленных фрагментов. Это гораздо удобнее, чем пытаться выцепить изменения в консоли.
Работа с субагентами и командами
Современный Claude умеет плодить «дочерние» процессы для решения подзадач. В консоли их вывод перемешивается в одну нечитаемую кашу. Инструмент разделяет эти потоки, выстраивая дерево выполнения. Сразу видно, какой агент за что отвечал, сколько ресурсов потратил и на каком этапе возникла заминка.
Умные уведомления
Можно настроить алерты на специфические события. Например, если Claude полез в файл .env, попытался прочитать конфиги с ключами или если стоимость сессии превысила определенный порог. Это полезно для безопасности, особенно если вы даете агенту много свободы в большом проекте.
Как это устроено технически
Приложение написано на TypeScript и доступно в виде Electron-сборки или Docker-контейнера. Оно ничего не отправляет в облако и не требует ваших API-ключей. Принцип работы прост: Claude Code сохраняет логи сессий в директорию ~/.claude/. claude-devtools просто следит за изменениями в этих файлах и парсит их.
Интересная деталь для тех, кто работает на удаленных серверах: в приложении есть поддержка SSH. Можно подключиться к удаленной машине, и инструмент будет стримить логи оттуда через SFTP. При этом кэширование и парсинг работают так же быстро, как если бы всё крутилось локально.
Кому стоит попробовать
Если вы запускаете Claude Code раз в неделю, чтобы поправить опечатку, вам хватит и терминала. Но если вы используете AI-агентов для полноценной разработки, рефакторинга или написания тестов, то без нормальной визуализации не обойтись.
Инструмент особенно пригодится, когда:
- Нужно отладить сложный процесс, где задействовано много файлов.
- Хочется контролировать расход токенов и понимать, на что уходит бюджет.
- Важно следить за безопасностью и доступами агента к чувствительным данным.
Установка максимально простая — для macOS есть Homebrew (brew install --cask claude-devtools), для Windows и Linux доступны обычные инсталляторы на странице релизов. Никакой настройки не требуется: открыли, и все ваши прошлые и текущие сессии уже там.
Проект выглядит как отличный пример того, какими должны быть инструменты сопровождения для AI-разработки — не мешающими основному процессу, но дающими максимум информации в нужный момент.
