Mac の Claude Code：セッション、ログと残しておくもの
会話の記録、デバッグログ、ファイルのスナップショットには別々の役割があります。大きなフォルダにも必要な会話や復元用の記録があるかもしれません。種類ごとに測定してから判断しましょう。
要点
- 要するに： セッション、デバッグログ、ファイルのスナップショットは役割が違うので、消す前にそれぞれ測りましょう。
- 気をつけたいこと： 会話記録を消すと、その会話も消えます。大きなフォルダにも、まだ必要な履歴や復元用の記録が入っていることがあります。
- Mint なら： Mint は Disk タブで Claude のストレージを表示します。測ったサイズは掃除の勧めではありません。
~/.claude の中身
セッションは ~/.claude/projects/<encoded-path>/<uuid>.jsonl に保存され、画像を含む場合があります。同名のディレクトリが隣にあれば、ツールの結果やサブエージェントの会話が入っていることがあります。そのディレクトリとセッションファイルは、ひと組として確認してください。
~/.claude/debug/ はデバッグを有効にしたときのログです。~/.claude/file-history/<session>/ はチェックポイントから復元するための編集前のスナップショットを保存します。削除すると、その復元用コピーが失われます。
settings.json、CLAUDE.md、プロジェクトのメモリディレクトリなど、設定とメモリは残してください。CLI のキャッシュは、このツリーの外の ~/Library/Caches/claude-cli-nodejs/ にある場合もあります。
Claude Code は、保持ルールに沿って一部のアプリデータを自動で削除します。何が削除されるかは、バージョン、設定、整理が実行される条件によって変わります。何も自動では消えないと考えず、このディレクトリについての Claude Code の最新ドキュメントを確認してください。CLAUDE_CONFIG_DIR を設定している場合は、~/.claude の代わりにその場所を見ます。
測定してから判断する
直下のフォルダごとの使用量を比べるには、次の読み取り専用コマンドを実行します：du -h -d 1 "${CLAUDE_CONFIG_DIR:-$HOME/.claude}" | sort -hr
権限のエラーや、パスが見つからないというエラーが出たら、結果は不完全です。このコマンドでわかるのは容量の場所だけで、削除してよいかどうかは別に判断します。
- ファイルを変更する前に、別のターミナルで開いたものも含めて Claude のタスクを停止します。
- 必要な会話と復元用の記録をバックアップします。
- デバッグログとセッションを別々に確認します。診断に使わなくなったログだけを削除します。CLI のキャッシュは必要に応じて再作成され、容量が再び増えることがあります。
- projects/ では、不要と決めたセッションだけを削除し、同名の関連ディレクトリがあればそれも一緒に扱います。古いからといって消してよいとは限りません。プロジェクトのメモリディレクトリは、セッションと一緒に消さないでください。
- 復元用コピーが不要になるまで file-history/ は残します。選んだファイルをまずゴミ箱に移し、確認してから空にするか判断します。ゴミ箱のファイルも容量を使います。
セッションを消すと会話も失われる
セッションを削除すると、中の文字や画像も消え、ローカルで再開することもできなくなります。そのセッションを指していたメモリのメモは、なくなった記録を参照することになるかもしれませんが、セッションを消してもメモ自体が消えたり壊れたりはしません。
整理の近道として ~/.claude 全体を消さないでください。セッション以外にも設定やメモリが含まれています。
Mint でできること
Mint の「ディスク」タブには、Claude 関連の使用容量が表示されます。測ったサイズは、削除をすすめる数字ではありません。記録が何のためにあり、まだ必要かを確かめてから操作を選んでください。
よくある質問
~/.claude/projects 全体を削除できますか？
ディレクトリごと消すのはやめましょう。会話、関連する記録、プロジェクトのメモリが入っていることがあります。セッションを 1 つずつ確認し、再開したり見返したりするものは残してください。
~/.claude が大きいのはなぜですか？
Mac によって違います。上の読み取り専用コマンドで、セッション、デバッグログ、スナップショットを別々に測ってください。どれがいちばん大きいかはマシンごとに異なります。
Claude Code の使用容量を確認
スキャンして「ディスク」タブで Claude を探してください。