CCLens CLI
Терминальный менеджер сессий Claude Code: статус каждой сессии, расход токенов по моделям и проектам, сводки сразу после выхода.
- 124 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хук SessionEnd отправляет текст сессий во внешний LLM API.
- Читает логи сессий Claude Code на диске.
Установка
- Работает в
Ручная установка
git clone https://github.com/wsw669/cclens.git && cd cclens && npm install && npm run build && npm startКоманды из раздела быстрого старта в README, склеены в одну строку.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хук SessionEnd отправляет текст сессий во внешний LLM API.
- Читает логи сессий Claude Code на диске.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CCLens открывает в терминале единый список сессий Claude Code. У каждой видно состояние: простаивает, работает или ждет ответа. Для параллельной работы над одним проектом есть поддержка git worktree, а контекст старых сессий копируется в новые рабочие копии. Панель стоимости читает логи сессий потоком, в том числе файлы в сотни мегабайт, и суммирует токены по модели, проекту и дате. Во встроенной таблице цены DeepSeek, GLM, Kimi, Qwen и Claude, свои значения задают в `~/.config/cclens/pricing.json`. Месячный бюджет подсвечивает превышение. При выходе из сессии CCLens в фоне собирает структурированную сводку: заголовок, что сделано, ключевые решения, следующий шаг. Сводки лежат в локальной базе по проектам. Те же данные показывает расширение VS Code из папки `vscode-ext`.
Для кого. Тем, кто ведет несколько сессий Claude Code одновременно и хочет видеть расход токенов по моделям и проектам.
Подходит, если
- Работа идет сразу в нескольких проектах, и непонятно, какая сессия ждет ответа.
- К концу месяца надо понять, на какой модели и в каком проекте ушел бюджет токенов.
- Один репозиторий правят параллельно в нескольких git worktree.
- После закрытия сессии хочется вернуться к ее решениям и плану следующего шага.
Не подходит, если
- Работа идет с агентом, отличным от Claude Code: инструмент рассчитан только на него.
- Содержимое сессий нельзя отправлять во внешний LLM API, а сводки нужны.
- Хватит разовой сводки расхода без интерактивного интерфейса.
Пример запроса к агенту
Покажи, сколько токенов и денег ушло в этом месяце по каждой модели и проекту, и отметь, где превышен бюджет.Ограничения
Установка идет только из исходников: клонирование, `npm install` и `npm run build`, нужен Node.js 20 или новее. Расширение VS Code тоже собирают вручную в файл `.vsix`. Для сводок нужен ключ любого OpenAI-совместимого API в `CCLENS_LLM_API_KEY`, адрес по умолчанию ведет на DeepSeek, и текст сессии уходит выбранному провайдеру. Стоимость считается по таблице цен и остается оценкой, а не счетом поставщика. Проект переработан из ccmanager: поддержку девяти ассистентов сократили до одного Claude Code. README написан по-китайски.
Как отключить. Закройте приложение и удалите клон репозитория. Если добавляли хук SessionEnd, уберите его блок из `~/.claude/settings.json`; сводки и настройки лежат в `~/.config/cclens/`.
Частые вопросы
Как включить автоматические сводки в Claude Code?
Задайте `CCLENS_LLM_API_KEY` и добавьте в `~/.claude/settings.json` хук `SessionEnd`, который запускает `scripts/summarize-session-end.mjs` из клона. Сводка появится после завершения сессии и для одной сессии не создается дважды.
Куда уходят данные при создании сводки?
Содержимое сессии отправляется в API, который вы настроили. Адрес меняет `CCLENS_LLM_BASE_URL`, модель задает `CCLENS_LLM_MODEL`.
Как задать цены своей модели?
Создайте файл `~/.config/cclens/pricing.json` с полями `input`, `output`, `cacheRead` и `cacheWrite` для нужной модели.
Как открыть панель стоимости?
В главном меню выберите Cost Dashboard или нажмите `$`.
Что нужно для запуска?
Node.js 20 или новее и установленный Claude Code. Приложение работает на Windows 10 и 11, macOS и Linux.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыcc-lens
Claude Code Lens (cc-lens)
Локальная аналитика Claude Code: панель по сессиям, токенам, расходам и проектам из данных каталога ~/.claude, без облака
claudetop выводит в строке состояния Claude Code стоимость сессии, кэш, окна лимитов тарифа и предупреждения о перерасходе
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Статусная строка для Claude Code: расход токенов и денег, остаток контекста, лимиты и ветка git в четырех стилях и шести темах
Отчеты по токенам и стоимости Claude Code, Codex, Gemini CLI и других агентов по локальным логам: по дням, месяцам и сессиям
Терминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| CCLens (эта карточка) | нет | 124 | |
| CCManager | нет | 1 278 | управляет сессиями нескольких ассистентов; CCLens оставил только Claude Code и добавил стоимость и сводки |
| ccusage | нет | 19 349 | считает расход по логам отчетами; CCLens добавляет интерактивный список сессий и сводки |
Коротко о README
Репозиторий описывает три части: менеджер сессий, панель стоимости и сводки. Все работают в терминале, а расширение VS Code повторяет панель и список сводок внутри редактора. Проект вырос из ccmanager, к нему добавлен учет затрат.