Claudeコードプロジェクトフォルダをセッション履歴を失わずに移動または名前変更する方法

問題: 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の会話履歴へのアクセスを維持しながらプロジェクト構造を再編成する開発者の特定の課題に対処します。