Como Mover ou Renomear Pastas de Projetos do Claude Code Sem Perder o Histórico de Sessões

O Problema: mv Quebra o Histórico de Sessões do Claude Code

O Claude Code armazena seu histórico de sessões em ~/.claude/projects/ usando o caminho absoluto exato do seu projeto como identificador. Por exemplo, um projeto em /Users/alex/my-project obtém uma pasta de sessão em: ~/.claude/projects/-Users-alex-my-project/.

Quando você usa mv para mover ou renomear uma pasta de projeto, o caminho não corresponde mais e todas as suas sessões se tornam invisíveis para o Claude Code. Os dados não são excluídos, mas ficam órfãos.

A Solução: Ferramenta clamp

clamp é uma ferramenta criada pela comunidade que lida com renomeação, movimentação ou ambas de pastas, preservando o histórico de sessões do Claude Code.

Instale via Homebrew:

brew install wsagency/tap/clamp

Passos para Usar o clamp

Siga estes passos em ordem:

1. Execute primeiro um teste seco (visualize as alterações):
   clamp --dry-run /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Verifique a saída para arquivos de sessão detectados e novos caminhos confirmados.
2. Execute a migração real:
   clamp /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Digite y para confirmar.
3. Verifique se tudo foi corretamente aplicado:
   clamp --list clamp --verify
4. Retome sua sessão:
   cd /Users/alex/documents/new-project-name
claude --continue

Se Você Já Usou mv

Se você já moveu a pasta com mv e quebrou o acesso à sessão, use o comando --fix:

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

Esta ferramenta aborda um ponto de dor específico para desenvolvedores que reorganizam suas estruturas de projeto enquanto mantêm o acesso ao seu histórico de conversas do Claude Code.