Claude Code Trace CLI
Просмотр журналов Claude Code в читаемом виде: вызовы инструментов, токены и живой хвост сессии.
- 385 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Программа читает все журналы Claude Code, где лежат исходники, запросы и результаты команд.
- Оценка эффективности отправляет сводку сессии во внешний сервис Jev, хотя только после подтверждения.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/delexw/claude-code-trace/main/script/install-macos.sh | bashСтавит Claude Code Trace.app в `/Applications`, только Apple Silicon. Для Linux и Windows берите сборки из релизов.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Программа читает все журналы Claude Code, где лежат исходники, запросы и результаты команд.
- Оценка эффективности отправляет сводку сессии во внешний сервис Jev, хотя только после подтверждения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Code Trace превращает журналы `~/.claude/projects/*.jsonl` в читаемую переписку. В ней раскрываются вызовы инструментов, ход рассуждений, результаты, субагенты, число токенов и время. Правки файлов показаны диффом по словам, вызовы MCP получают понятные названия. Открытая сессия обновляется, пока Claude Code пишет в журнал, а список сессий отмечает те, что еще идут. Запускается программа как настольное приложение, веб-приложение или терминальный интерфейс. Все три читают один бэкенд на Rust. Дополнительно можно оценить эффективность работы агента: сводка уходит во внешний сервис Jev только после вашего подтверждения.
Для кого. Разработчикам, которые разбирают, что сделал Claude Code в долгой сессии и куда ушли токены.
Подходит, если
- Агент завершил работу, а в терминале не осталось истории, и нужно понять, какие инструменты он вызывал.
- Идущая сессия требует наблюдения в отдельном окне, пока вы работаете в другом.
- Расход токенов в конкретной сессии показался завышенным.
- В логе есть вызовы MCP, и хочется видеть, какой сервер что получил.
Не подходит, если
- Материал для публикации: программа показывает сессии, но не собирает файл для читателей.
- Работа не с Claude Code и не с Antigravity: других встроенных источников сессий нет.
- Анализ без передачи данных наружу: оценка эффективности отправляет сводку в Jev.
Пример запроса к агенту
Поставь Claude Code Trace и покажи, какие инструменты вызывал агент в моей вчерашней сессии по проекту api.Ограничения
Готовая установка одной командой есть только для macOS на Apple Silicon: приложение подписано ad-hoc и не нотаризовано, при первом запуске macOS просит подтвердить открытие в настройках. Для Linux и Windows есть сборки в релизах (`.deb`, `.rpm`, `.AppImage`, `.msi`, `.exe`). Сборка из исходников требует Rust, Node.js 18 и Python 3.11 для терминального интерфейса. Источник Antigravity выключен по умолчанию и читает беседы только на чтение. Ключ Jev и ключи провайдеров лежат в хранилище учетных данных системы.
Как отключить. Закройте приложение или остановите контейнер командой `docker compose down`, если запускали Docker. Приложение из `/Applications` удаляется перетаскиванием в корзину. Журналы Claude Code остаются нетронутыми.
Частые вопросы
Какой командой ставится Claude Code Trace на macOS?
Одной командой из README: `curl -fsSL https://raw.githubusercontent.com/delexw/claude-code-trace/main/script/install-macos.sh | bash`. Она кладет приложение в `/Applications` и работает только на Apple Silicon.
Куда уходят данные сессии?
Никуда, пока вы не запустите оценку эффективности. Тогда редактированная сводка отправляется в Jev, а перед отправкой программа показывает точное содержимое и ждет подтверждения.
Можно ли запустить его в браузере?
Да. Команда `docker compose up --build` из каталога репозитория поднимает веб-режим по адресу `http://localhost:1421`.
Что такое источники сессий?
Это плагины чтения журналов. Claude Code встроен и включен всегда, Antigravity включается в настройках, раздел General, Sources.
Нужен ли Python?
Только для терминального интерфейса при сборке из исходников: нужен Python 3.11 или новее. Для настольного приложения и веб-режима он не требуется.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыИнструмент отладки для Claude Code: читает уже сохраненные логи сессий и показывает точные пути файлов, диффы, мышление модели и разбивку контекста по категория
Терминальный клиент claude-rs на Rust для Claude Code: сессия остается в истории терминала, вывод не мерцает, работает в tmux.
CLI превращает журналы кодинг-агента в интерактивный HTML-повтор с вызовами инструментов, разницей файлов и главами.
Терминальный проводник по файлам настроек Claude Code: CLAUDE.md, команды, подагенты и settings.json с предпросмотром
Рисует сессию Claude Code или Codex как граф с агентами и вызовами инструментов, показывает ее вживую или в записи
Плагин Claude Code создает и поддерживает CLAUDE.md: оценка от 0 до 100, лимит 150 строк и проверка устаревших ссылок
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claude Code Trace (эта карточка) | нет | 385 | |
| claude-replay | нет | 856 | собирает отдельный HTML-файл для публикации, а cctrace показывает идущую сессию вживую |
| Claude Code History Viewer | нет | 2 303 | листает историю многих агентов, а cctrace разбирает вызовы инструментов, токены и работу субагентов в сессиях Claude Code |
Коротко о README
Каждый вызывающий клиент регистрируется в бэкенде и получает собственный токен HS256, который можно отозвать отдельно. Дизайн каждой части описан в папке specs репозитория.