Claude Code Lens (cc-lens)

Локальный дашборд аналитики для Claude Code. Без облака, без телеметрии, без API-ключа — только ваши данные из ~/.claude/, визуализированные.

CLI находит свободный локальный порт, запускает дашборд и открывает его в браузере.

Быстрый старт

Запустите напрямую через npx:

При первом запуске cc-lens подготавливает небольшой кэш в ~/.cc-lens/. После этого запуски становятся быстрее.

Что можно увидеть

Обзор

• Сессии, сообщения, использование токенов, примерная стоимость и локальное хранилище.
• Карточки трендов со спарклайнами.
• Предустановленные диапазоны дат: 7, 30 и 90 дней, а также произвольный выбор периода.
• Использование по времени, распределение по моделям, пиковые часы, активность по проектам, разбивка токенов и последние сессии.

Проекты

• Сетка проектов с поиском и сортировкой.
• Карточки проектов с данными о сессиях, длительности, примерной стоимости, языках, git-ветках, бейджах MCP/агентов и топовых инструментах.
• Страницы деталей проекта: сессии, стоимость по времени, распределение языков, активность по веткам и использование инструментов.

Сессии

• Таблица сессий с поиском и бейджами для компакции, агентов, MCP, веб-поиска/загрузки и расширенного мышления.
• Полный реплей сессии, восстановленный из JSONL.
• Ответы ассистента отображаются в GitHub-flavored Markdown.
• Вызовы инструментов и их результаты показаны inline.
• Результаты инструментов чтения/записи/обновления файлов разобраны в читаемые карточки.
• Модель, длительность, разбивка токенов и примерная стоимость для каждого хода.
• События компакции показаны в контексте с графиком накопления токенов.

Стоимость

• Общая примерная стоимость, экономия на кэше и оценочная стоимость без кэша.
• Стоимость по времени и по проектам.
• Разбивка токенов и стоимости по моделям.
• Панель эффективности кэша.
• Справочник цен из lib/pricing.ts.

Инструменты и функции

• Рейтинг инструментов по всем сессиям.
• Категории инструментов: файловый ввод/вывод, shell, агенты, веб, планирование, задачи, скиллы, MCP и прочие вызовы.
• Детали использования MCP-серверов.
• Статистика использования функций по сессиям.
• Анализ ошибок инструментов.
• История версий Claude Code.
• Аналитика git-веток.

Активность

• Календарь активности в стиле GitHub.
• Текущая серия, самая длинная серия, активные дни и самый активный день.
• Использование по времени, пиковые часы и паттерны по дням недели.
• Активность может быть получена из JSONL сессий, если кэш статистики неполный.

Локальные файлы Claude Code

• История: поиск и постраничный просмотр ~/.claude/history.jsonl.
• Задачи: просмотр задач из ~/.claude/todos/ с поиском и фильтрами по статусу.
• Планы: чтение сохранённых планов из ~/.claude/plans/ с inline-рендерингом Markdown.
• Память: просмотр и редактирование файлов памяти по проектам с фильтрами по типу и определением устаревших записей.
• Настройки: просмотр ~/.claude/settings.json, установленных скиллов, плагинов, MCP-серверов и использования хранилища.

Экспорт и импорт

• Экспорт переносимого файла .ccboard.json со статистикой, метаданными сессий, фасетами и историей последних команд.
• Предварительный просмотр количества записей перед скачиванием.
• Опциональная фильтрация экспорта по дате начала сессии.
• Возможность загрузить файл экспорта для предварительного просмотра аддитивного слияния с другой машины.

Импорт намеренно работает только в режиме предпросмотра. Он показывает, какие сессии новые, а какие уже присутствуют, но не записывает объединённые данные обратно в ~/.claude/, чтобы не повредить активные файлы Claude Code.

Навигация

• Глобальный поиск: Cmd+K, Ctrl+K или /.
• Навигация по списку сессий с клавиатуры: j / k для перемещения, Enter для открытия, Esc для сброса.
• Быстрые переходы по страницам: g плюс клавиша страницы, например g s для сессий, g p для проектов, g c для стоимости.
• Адаптивный макет: боковая панель для десктопа, сворачиваемая навигация, нижняя навигация для мобильных и мобильное меню.
• Светлая и тёмная темы.

Несколько профилей Claude

По умолчанию cc-lens читает ~/.claude/. Чтобы указать другой каталог конфигурации Claude Code, задайте CLAUDE_CONFIG_DIR:

# Профиль по умолчанию
npx cc-lens

# Рабочий профиль
CLAUDE_CONFIG_DIR=~/.claude-work npx cc-lens

Для Windows PowerShell:

Активный каталог конфигурации отображается в баннере CLI при запуске.

Запуск из исходников

Требования

• Node.js 18+
• Claude Code с локальными данными в ~/.claude/

Разработка

npm install
npm run dev

Откройте http://localhost:3000 или порт, указанный в терминале.

Сборка для продакшена

npm run build
npm start

Линтинг

Источники данных

cc-lens читает локальные файлы Claude Code напрямую:

• ~/.claude/projects/<slug>/*.jsonl: JSONL сессий и данные для реплея
• ~/.claude/stats-cache.json: агрегированная статистика при наличии
• ~/.claude/usage-data/session-meta/: резервный источник метаданных сессий
• ~/.claude/history.jsonl: история команд
• ~/.claude/todos/: файлы задач
• ~/.claude/plans/: сохранённые файлы планов
• ~/.claude/projects/*/memory/: файлы памяти проектов
• ~/.claude/settings.json: настройки, скиллы, плагины и конфигурация MCP

Данные дашборда обновляются каждые 5 секунд, пока приложение открыто.

Конфиденциальность

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

Оценка стоимости

Claude Code хранит количество токенов и идентификаторы моделей, но не итоговые суммы к оплате. cc-lens оценивает стоимость по таблице цен в lib/pricing.ts. Реальные расходы могут отличаться в зависимости от скидок, промо-кредитов и изменений тарифов Anthropic.