Вы когда-нибудь заглядывали в ~/.claude/ и офигевали? Я — да. Там валяются десятки JSON-лог-файлов сессий, раздутые memory-директории, хуки, которые вы ставили месяц назад и забыли, а ещё та самая Auto Dream — фича, которая может оставить ИИ работать на 8 часов и сожрать гигабайты без возможности отката. Знакомо?
Проблема в том, что Claude Code — зверь прожорливый. Он пишет логи каждой сессии, копит memory-файлы (помните нашу статью про пять механизмов памяти?), а Auto Dream вообще запускает «бессмертного» агента. Ручная чистка — ад: надо лезть в дебри файловой системы, искать конфликтующие файлы, бояться сломать контекст. Хорошая новость: появился cc-janitor — утилита, которая делает всю грязную работу за вас. И я её протестировал.
Важно: Инструмент актуален на май 2026 года. Работает с Claude Code любой версии, включая последнюю 2.0.5.
Что он вообще умеет? (Спойлер: много)
cc-janitor — это не просто скрипт-однодневка. Это полноценная TUI (текстовый интерфейс) и CLI-команды, которые покрывают три главные боли:
- Сессии — показывает все сессии Claude Code, даёт удалять старые или чистить историю сообщений внутри сессии. Больше никаких гигабайтов логов, которые валяются мёртвым грузом.
- Память — анализирует
~/.claude/memory/и находит дубликаты, противоречия и файлы, которые уже не используются. Можно удалить конфликтующие memory-файлы парой нажатий. - Хуки (hooks) — управление pre/post-хуками Claude Code, включая откат к предыдущим версиям. Если вы ставили хуки для интеграции с Obsidian (как в нашем гайде) или с Neo4j из статьи про унифицированную память — теперь не бойтесь экспериментировать.
- Auto Dream — отдельная фича. Можно отключить «автоматическую мечту» и, главное, создать снапшот состояния перед её запуском, чтобы потом откатиться. Без этого — караул.
Звучит как швейцарский нож? Ага. Только нормально заточенный.
Ставь за 30 секунд (серьёзно)
Установка — через pip или uv (кто дружит с быстрым пакетным менеджером). Команда одна:
pip install cc-janitor # или uv pip install cc-janitor
После установки просто наберите cc-janitor в терминале — откроется TUI. Если вы фанат голого CLI — юзайте cc-janitor cli. Всё, никаких зависимостей, кроме Python 3.10+.
cp -r ~/.claude ~/.claude.backup. cc-janitor сам создаёт пресеты, но лишняя копия не помешает.Разбор полётов: три сценария, где cc-janitor спасает
1 Чистка сессий: «У меня 50 гигов логов — это нормально?»
Нет, не нормально. В статье про скрытые сессии мы уже разбирали, где Claude Code прячет логи. cc-janitor показывает таблицу всех сессий с размером, датой и количеством сообщений. Чтобы удалить старые — просто отметьте их в TUI или выполните:
cc-janitor cli sessions purge --older-than 7d
Флаг --dry-run покажет, что будет удалено, без реального удаления. Полезно, чтобы не отстрелить себе ногу.
2 Memory-файлы: когда CLAUDE.md конфликтует сам с собой
Вы когда-нибудь писали в одном memory-файле «проект на FastAPI», а в другом — «проект на Django»? Claude Code будет путаться и выдавать бред. cc-janitor сканирует ~/.claude/memory/ и подсвечивает конфликты (разные значения одинаковых ключей). Можно посмотреть diff и удалить лишнее:
cc-janitor cli memory lint
cc-janitor cli memory prune --force
Первая команда — аудит, вторая — чистка. Советую сначала запустить lint и посмотреть, что там накопилось. У меня, например, нашлось 8 дублирующих файлов про «tech stack» — результат устаревших экспериментов.
3 Auto Dream: как не дать ИИ уйти в бесконечный цикл
Auto Dream — опасная игрушка. Включаешь, и Claude Code может работать часами без контроля. Если что-то пошло не так — откатиться почти нереально. cc-janitor предлагает создать снапшот перед запуском Auto Dream и при необходимости откатить:
cc-janitor cli snapshot create
# запускаете Auto Dream
cc-janitor cli snapshot restore --last
Это буквально спасает проект. Сам недавно тестировал автономную декомпиляцию — без cc-janitor не рискнул бы.
А чем это лучше, чем просто rm -rf?
Ручная чистка — это, по сути, скрипты на коленке. Вы рискуете удалить нужную сессию, сломать контекст или не заметить конфликт memory-файлов. cc-janitor делает то же самое, но:
- Проверяет зависимости между файлами (не удалит хуки, которые используются в активных сессиях).
- Даёт откат через снапшоты.
- Показывает diff до удаления — вы видите, что потеряете.
- Работает в TUI — не надо помнить десятки путей.
Альтернатив, по сути, нет. Есть claude-code clean из официального CLI, но он умеет только чистить кэш. Для сессий и памяти — глухо. Есть ручные скрипты в гисте — но кто будет их поддерживать? cc-janitor — первая попытка сделать нормальный утилит для гигиены Claude Code, и она уже рабочая.
Кому это нужно прямо сейчас?
Всем, кто использует Claude Code не как «поиграться часок», а как рабочий инструмент. Если у вас:
- директория
~/.claude/разрослась до нескольких гигабайт; - вы замечали, что Claude Code «забывает» настройки из-за конфликтующих memory-файлов;
- вы хотя бы раз запускали Auto Dream и потом ловили себя на мысли «как бы это откатить»;
- вы ставили кастомные хуки и боитесь их сломать.
Тогда cc-janitor — ваш новый друг. Установите, прогоните lint, сделайте снапшот — и спите спокойно.
Предупреждение: Не советую запускать Auto Dream без cc-janitor. Серьёзно. Один раз я запустил «автоматическую мечту» на 3 часа — пришлось вручную вычищать 4 гигабайта мусора и восстанавливать контекст по логам. Снапшот спасает проект и нервы.
Инструмент ещё молодой, но уже стабильный. Я бы ждал, что к середине 2026 года такие утилиты станут стандартной обвязкой для AI-агентов — как менеджеры пакетов для обычных приложений. Пока же cc-janitor — единственный вменяемый способ держать Claude Code в чистоте. Попробуйте — и скажите спасибо, когда скинете гигабайт логов.