Claude Code AI теперь с историей в браузере: 27 клиентов, статистика токенов и $0 за утилиту

Утилита Claude Code History Viewer (лицензия MIT) вышла на GitHub в репозитории jhlee0409/claude-code-history-viewer. Она решает конкретную проблему: Claude Code записывает каждую сессию в файл формата JSONL по пути ~/.claude/projects/<путь-проекта>/.jsonl, где блоки thinking, tool_use и результаты инструментов лежат разными типами записей, а связи между сообщениями идут через поле parentUuid. Читать это через утилиту jq можно, но на длинных сессиях неудобно. Viewer превращает эти файлы в визуальный интерфейс с деревом проектов, поиском и статистикой. Версия на момент проверки автором источника составляет 1.22.0.

Что показывает интерфейс?

• Дерево проектов и сессий со счётчиками слева, выбранный диалог справа: сообщения, вызовы инструментов, блоки thinking, дифы (различия в коде) и вывод команд с ANSI-цветами.
• Субагенты (подзадачи, которые модель порождает внутри сессии) отображаются отдельными ветками. По правому клику копируются идентификатор сессии, путь к файлу и готовая команда claude --resume для продолжения.
• Глобальный поиск через сочетание Ctrl+K сразу по всем провайдерам: в результатах видно, какой сессии принадлежит совпадение.
• Global Statistics с общей статистикой: токены (токен, это минимальная единица текста, которую обрабатывает модель), количество сообщений, число сессий, суммарное время и оценка стоимости по прайсу API.
• Разбивка Billing: в примере автора источника 68,3% токенов приходится на диалог, а 31,7% на инструменты и системный трафик.
• Heatmap активности по дням, топ инструментов, топ моделей, разбивка по навыкам и субагентам.
• Поддержка 27 клиентов помимо Claude Code: Codex CLI, Gemini CLI, Cursor, Cline, Copilot, Goose, Zed и другие.

Как запустить на Linux-сервере через Docker?

Автор источника описал конкретный сценарий: сервер без графической оболочки, режим headless, интерфейс отдаётся в браузер.

1. Скачайте готовый бинарный файл из релизов на GitHub (для x86_64; под ARM64 лежит отдельный архив) и проверьте контрольную сумму:

mkdir cchv && cd cchv
curl -fsSLO https://github.com/jhlee0409/claude-code-history-viewer/releases/download/v1.22.0/cchv-server-linux-x64.tar.gz
curl -fsSLO https://github.com/jhlee0409/claude-code-history-viewer/releases/download/v1.22.0/CHECKSUMS.sha256
sha256sum -c --ignore-missing CHECKSUMS.sha256

1. Создайте Dockerfile в той же папке. GTK и WebKit нужны даже серверному бинарю: это зависимость фреймворка Tauri на этапе компиляции, окно в режиме --serve не открывается:

FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y --no-install-recommends \
  ca-certificates curl libgtk-3-0 libwebkit2gtk-4.1 libjavascriptcoregtk-4.1-0 \
  && rm -rf /var/lib/apt/lists/*
ADD cchv-server-linux-x64.tar.gz /usr/local/bin/
ENTRYPOINT ["cchv-server", "--serve", "--host", "0.0.0.0", "--port", "3727"]

1. Соберите образ и запустите контейнер с явным токеном авторизации (почему именно так, читайте ниже):

docker build -t cchv-server:1.22.0 .
install -d -m 700 "$HOME/.claude-history-viewer"
TOKEN="$(openssl rand -hex 24)"
echo "http://127.0.0.1:3727/?token=$TOKEN"

docker run -d --name cchv --restart unless-stopped \
  --user "$(id -u):$(id -g)" -e HOME=/home/cchv \
  -v "$HOME/.claude:/home/cchv/.claude:ro" \
  -v "$HOME/.claude-history-viewer:/home/cchv/.claude-history-viewer" \
  -p 127.0.0.1:3727:3727 --memory 1g \
  cchv-server:1.22.0 --token "$TOKEN"

1. Проверьте работу и откройте интерфейс. Снаружи сервера используйте SSH-туннель:

curl -s http://127.0.0.1:3727/health
ssh -L 3727:127.0.0.1:3727 user@host

Подвох с токеном, о котором молчит README

README обещает, что при старте сервер печатает полный токен и готовый URL с ?token=... в логе. В версии 1.22.0 поведение другое: в лог уходят только первые восемь символов, а сам токен сохраняется файлом по пути ~/.claude-history-viewer/webui-token.txt.

Если домашний каталог смонтирован только для чтения (read-only), записать файл сервер не сможет и выведет ошибку «Failed to persist generated token. Re-run with --token ». Тогда войти нельзя вообще: в логе только восемь символов, полный токен нигде не доступен. Именно поэтому в примере выше токен генерируется заранее и передаётся через флаг --token.

Архив сессий и автоочистка

Claude Code по умолчанию удаляет старые сессии: параметр cleanupPeriodDays равен 30, чистка идёт при запуске клиента. Viewer показывает ровно то, что осталось на диске.

Через API-эндпоинт get_expiring_sessions можно узнать, какие сессии скоро попадут под очистку. В примере автора источника из 61 сессии одного проекта пять уходили в ближайшие сутки.

Против этого в приложении есть Archive Manager с кнопкой Full Backup: сессии копируются в ~/.claude-history-viewer/archives, куда автоочистка не дотягивается. Автор источника рекомендует увеличить срок хранения в настройках.

Есть ли российский аналог?

Прямого аналога Claude Code History Viewer для российских ИИ-инструментов нет: YandexGPT и GigaChat не предоставляют инструмент разработчика с агентным режимом (ИИ-агент, это программа, которая сама выполняет цепочку действий, а не ждёт каждую команду) и историей сессий в том же виде. Если вы пользуетесь Claude Code и работаете с российского сервера, инструмент запускается локально и не зависит от региона, нужен только доступ к GitHub для скачивания бинарного файла.

Что делать с этим прямо сейчас, по ролям?

Автору Дзена. Если вы используете claude code ai для подготовки черновиков или исследования тем, Viewer покажет, сколько токенов и денег уходит на каждую сессию. Это позволяет понять, какие промпты (промпт, это текстовая инструкция для модели) экономны, а какие раздувают расход.

Разработчику и техническому специалисту. Headless-режим с Docker позволяет развернуть историю на рабочем сервере без графической оболочки. API-эндпоинты дают возможность автоматизировать мониторинг: например, получать алерт о сессиях, которые скоро удалятся.

Предпринимателю или руководителю команды. Если ваша команда работает с Claude Code, Viewer показывает реальную стоимость использования по прайсу API. Оговорка: покрытие цен в примере автора составляло 35,4%, то есть расчёт неполный и показывает нижнюю границу.

Частые вопросы

Данные сессий отправляются куда-то?

Нет. Все транскрипты обрабатываются локально. Проект не заявляет телеметрии. Десктопная версия обращается к GitHub только за проверкой обновлений.

Работает ли Viewer только с Claude Code?

Нет. Помимо Claude Code инструмент понимает историю 27 других клиентов: Codex CLI, Gemini CLI, Cursor, Cline, Copilot, Goose, Zed и других. Для каждого нужно смонтировать соответствующий каталог с историей.

Можно ли установить без Docker?

Да. Доступны готовые пакеты: .dmg для macOS, .exe для Windows, .AppImage, .deb и .rpm для Linux, а также установка через brew install --cask jhlee0409/tap/claude-code-history-viewer. Docker нужен для серверного режима без графической оболочки.