Claude Code 2.1.126 добавляет `claude project purge` для очистки всего состояния репозитория

Релиз Claude Code v2.1.126 от 1 мая 2026 года добавил небольшую команду с непропорционально большой историей очистки: claude project purge [path]. Запустите её на репозитории, и CLI удалит каждую транскрипцию, задачу, запись истории файлов и блок конфигурации ~/.claude/projects/..., привязанные к этому пути проекта, за одну операцию. Больше не нужно вручную копаться в ~/.claude/projects/, чтобы сбросить проект, накопивший за год историю сессий.

Зачем нужна отдельная команда вместо rm -rf

Состояние Claude Code по проекту живёт сразу в нескольких местах. Есть директория проекта в ~/.claude/projects/<encoded-path>/, где хранятся JSONL-транскрипции, сохранённый список задач и снапшоты истории файлов. Также есть записи в глобальном ~/.claude/settings.json и в конфигурации по проекту, которые ссылаются на эту директорию по абсолютному пути. Если удалить только папку проекта, остаются висящие ссылки; если удалить только записи настроек, остаются мегабайты осиротевших транскрипций.

До v2.1.126 официальным ответом была аккуратная ручная очистка. Новая подкоманда обходит ту же внутреннюю карту, что и остальная часть CLI, поэтому транскрипции, задачи, история файлов и записи конфигурации уходят за один согласованный проход. Если запустить её в директории, в которой вы уже находитесь, путь можно опустить:

# Nuke everything Claude Code knows about the current repo
claude project purge

# Or target an absolute path from elsewhere
claude project purge /home/marius/work/legacy-monolith

Флаги, которые делают это безопасным для скриптов

Самое интересное — это набор флагов. В релизе их четыре:

# Show what would be deleted without touching anything
claude project purge --dry-run

# Skip the confirmation prompt (CI-friendly)
claude project purge -y
claude project purge --yes

# Walk projects one at a time and choose
claude project purge --interactive

# Purge every project Claude Code has ever recorded
claude project purge --all

--dry-run печатает идентификаторы проектов, счётчики транскрипций и суммарные размеры в байтах на диске, которые были бы удалены. --all — это тяжёлый молот, полезный после смены ноутбука, когда большинство записанных путей на диске уже не существуют. -i — промежуточный режим для разбора длинного списка.

Куда это вписывается в общую картину v2.1.126

project purge — одно из нескольких изменений в управлении состоянием в этом релизе. В той же сборке --dangerously-skip-permissions теперь может писать в ранее защищённые пути вроде .claude/, .git/, .vscode/ и файлов конфигурации shell, что согласуется с моделью purge: Claude Code склоняется к тому, чтобы давать вам более прямолинейные инструменты для зачистки собственного следа, исходя из того, что вы понимаете, что делаете. Прежняя переменная окружения Bedrock service tier в Claude Code 2.1.122 была релизом в похожем стиле “одна крутилка, без изменений в SDK”; v2.1.126 продолжает этот шаблон.

Если вы запускаете Claude Code под управляемым ~/.claude (политикой настроек, зафиксированной организацией), --all очистит только те проекты, чьё состояние лежит под вашим пользовательским профилем. Сам файл управляемой политики остаётся нетронутым.

Полные заметки — на странице релиза Claude Code v2.1.126.