Как переместить или переименовать папки проекта Claude Code без потери истории сессий

Проблема: mv нарушает историю сессий Claude Code

Claude Code хранит историю ваших сессий в ~/.claude/projects/, используя точный абсолютный путь к вашему проекту в качестве идентификатора. Например, проект по адресу /Users/alex/my-project получает папку сессии по адресу: ~/.claude/projects/-Users-alex-my-project/.

Когда вы используете команду mv для перемещения или переименования папки проекта, путь больше не совпадает, и все ваши сессии становятся невидимыми для Claude Code. Данные не удаляются, но становятся "осиротевшими".

Решение: инструмент clamp

clamp — это инструмент, созданный сообществом, который обрабатывает переименование, перемещение или оба действия одновременно, сохраняя историю сессий Claude Code.

Установка через Homebrew:

brew install wsagency/tap/clamp

Шаги по использованию clamp

Выполните эти шаги по порядку:

1. Сначала выполните пробный запуск (предварительный просмотр изменений):
   clamp --dry-run /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Проверьте вывод на наличие обнаруженных файлов сессий и подтверждённых новых путей.
2. Запустите реальную миграцию:
   clamp /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Введите y для подтверждения.
3. Убедитесь, что всё прошло правильно:
   clamp --list clamp --verify
4. Возобновите сессию:
   cd /Users/alex/documents/new-project-name
claude --continue

Если вы уже использовали mv

Если вы уже переместили папку с помощью команды mv и нарушили доступ к сессиям, используйте команду --fix:

clamp --fix --from /Users/alex/old-project-name --to /Users/alex/documents/new-project-name

Этот инструмент решает конкретную проблему для разработчиков, которые реорганизуют структуру своих проектов, сохраняя при этом доступ к истории своих бесед в Claude Code.