Разработчик jhlee0409 выпустил инструмент Claude Code History Viewer, который превращает сырые логи сессий Claude Code в удобный веб-интерфейс. Версия 1.22.0, доступная на GitHub под лицензией MIT, написана на Rust с использованием Tauri. Программа читает файлы из каталога ~/.claude/projects, где Claude Code сохраняет каждую сессию в формате JSONL. Эти файлы содержат машинные записи: блоки thinking, tool_use и результаты инструментов, связанные через parentUuid. Вручную разбирать такой формат сложно, поэтому автор создал инструмент, который собирает из них структурированное представление.
Claude Code History Viewer работает в двух режимах: как обычное десктопное приложение (доступно для macOS, Windows и Linux) и как headless-сервер, который отдаёт интерфейс в браузер. Второй режим удобен для использования на серверах без графической оболочки. Приложение позволяет просматривать диалоги с тулколлами, глобально искать по всем сессиям, а также анализировать статистику по токенам и стоимости. Поддерживаются не только Claude Code, но и история ещё 27 клиентов, включая Codex CLI, Gemini CLI, Cursor, Cline, Copilot, Goose и Zed. Транскрипты обрабатываются локально, телеметрия не заявлена, хотя десктопная версия обращается к GitHub для проверки обновлений.
| Режим | Описание | Платформы |
|---|---|---|
| Десктопное приложение | Обычное приложение с графическим интерфейсом | macOS, Windows, Linux |
| Headless-сервер | Сервер, отдающий интерфейс в браузер | Любая ОС с Docker |
Для запуска headless-сервера автор рекомендует использовать Docker. В репозитории есть docker-compose.yml, но он собирает бинарник из исходников, что требует Rust, pnpm и webkit-заголовки. Проще взять готовый бинарник из релиза и создать собственный Dockerfile. В статье приводится пример: загрузка архива cchv-server-linux-x64.tar.gz, проверка контрольных сумм, сборка образа на основе debian:bookworm-slim с установкой зависимостей (ca-certificates, curl, libgtk-3-0, libwebkit2gtk-4.1 и других). Сборка заняла около двух с половиной минут. При запуске контейнера важно смонтировать каталог с историей Claude Code в режиме read-only, а также выделить отдельный том для хранения токена и архивов.
Поддерживает 28 ИИ-клиентов, включая Claude Code, Codex CLI, Gemini CLI, Cursor.
Особое внимание стоит уделить аутентификации. В версии 1.22.0 при старте сервера в лог выводится только первые восемь символов токена, а полный токен сохраняется в файл webui-token.txt в домашнем каталоге. Если домашний каталог смонтирован read-only, сервер не сможет записать токен, и войти в интерфейс будет невозможно. Поэтому в примере запуска токен передаётся явно через параметр --token, сгенерированный командой openssl rand -hex 24.
Интерфейс сервера предоставляет дерево проектов и сессий со счётчиками, просмотр диалогов с тулколлами, thinking, диффами и выводом команд с ANSI-цветами. Сабагенты отображаются отдельными ветками, есть возможность скопировать id сессии и команду claude --resume. Глобальный поиск (Ctrl+K) работает по всем провайдерам и показывает, в какой сессии найдено совпадение.
Отдельная страница Global Statistics показывает агрегированную статистику: 22,5 млрд токенов, 414,8 тыс. сообщений, 9862 сессии, 54 дня чистого времени сессий. Оценка стоимости — 12 824 доллара, если бы это шло по прайсу API. Однако покрытие цен составляет 35,4%, то есть посчитаны только те модели, для которых нашлась цена. Разбивка Billing показывает, что на диалог приходится 68,3% токенов, а 31,7% — на инструменты и системный трафик. На странице также есть топ инструментов, топ моделей, heatmap активности по дням и разбивка по скилам и сабагентам.
Бэкенд сервера доступен через HTTP API: те же команды можно вызывать через POST /api/<имя> с Bearer-токеном. Например, scan_all_projects возвращает список проектов с количеством сессий, а get_expiring_sessions показывает сессии, которые скоро попадут под автоочистку Claude Code (порог по умолчанию — 7 дней). Это позволяет интегрировать инструмент в автоматизированные сценарии.
Claude Code History Viewer решает реальную проблему: логи сессий ИИ-ассистентов хранятся в машинном формате, который сложно анализировать вручную. Инструмент делает эти данные доступными для просмотра и анализа, что полезно для разработчиков, которые хотят контролировать расходы на API и изучать свои взаимодействия с ИИ. Открытый исходный код и поддержка множества клиентов делают его универсальным решением для локального мониторинга ИИ-сессий.
