Claude Code の容量
~/.claude が大きくなる理由と、削除してよいもの
Claude Code はすべてのセッションを ~/.claude/projects に .jsonl ファイルとして保存し、その隣にデバッグログとファイルのスナップショットも残しますが、どれも自動では整理されません。ある開発者の Mac では 610 件のセッションが 1.75 GB を占め、その約 30% が埋め込まれたスクリーンショットでしたが、公開されているバグ報告には ~/.claude/debug と ~/.claude/file-history が数百 GB になった例もあります。claude のプロセスが動いていなければ、古いセッション、デバッグログ、CLI のキャッシュは安全に削除できます。
~/.claude の中身
セッションは ~/.claude/projects にあり、プロジェクトパスごとにフォルダが分かれています。セッションは 1 つずつ <uuid>.jsonl ファイルになっていて、隣に同じ名前のフォルダがあることも多く、そこにツールの実行結果やサブエージェントの記録が入っています。このフォルダはセッションの一部なので、消すなら両方まとめて消してください。
~/.claude/debug にはセッションごとのデバッグログが、~/.claude/file-history には Claude Code が編集したファイルのスナップショットが入っています。どちらもローテーションされないため、~/.claude が数百 GB になるときはたいていこの 2 つが原因です。CLI のキャッシュと MCP のログはこのフォルダの外の ~/Library/Caches/claude-cli-nodejs にあります。
settings.json、CLAUDE.md のメモリファイル、.credentials.json は設定とログイン情報です。Claude Code は作り直せないので、そのまま残しておいてください。
手作業で片付ける場合
大きなフォルダはそれぞれ増える理由も消し方も違うので、まずサイズを測りましょう。
- ほかのターミナルウィンドウで開いたままのセッションも含めて、claude のプロセスをすべて終了します。
- du -sh ~/.claude/* | sort -rh を実行し、どのフォルダが大きいかを確認します。
- ~/.claude/debug と ~/Library/Caches/claude-cli-nodejs を空にします。次に Claude Code を起動すると、また作られます。
- ~/.claude/projects の古いセッションファイルを、同じ名前のフォルダと一緒に削除します。
Mint でできること
Mint の「ディスク」タブでは、Claude Code は Claude の中に表示され、各フォルダのサイズが測られます。セッションは会話の履歴としてそのまま残り、Mint が削除することはないので、古いセッションは手作業で片付けてください。
Direct 版と Setapp 版では Claude Code のキャッシュが削除の対象になりますが、Claude Code も Claude アプリも動いていないときに限ります。Mint は ~/.claude/debug と file-history には手を付けず、Claude Code のセッション内のスクリーンショットも縮小しません。「最適化」は Codex の会話だけが対象です。
削除する前に確認したいこと
rm -rf ~/.claude は実行しないでください。すべてのセッションと一緒に設定、メモリファイル、ログイン情報も消え、Claude Code が正常に起動しなくなります。
空き容量にも注意してください。ディスクの空きが 0 バイトになると Claude Code が自分の設定やログイン情報を保存できなくなったという報告があるので、次のセッションを始める前に容量を空けておきましょう。
よくある質問
~/.claude/projects を削除しても大丈夫ですか？
Claude Code は動きますが、claude --resume で再開できるセッションがなくなります。何か月も開いていないセッションだけを消すほうが無難です。
セッションを 1 つ削除すると何か壊れますか？
壊れません。別の設定フォルダで試したところ、削除したセッションは claude --resume に出てこなくなり、その ID で再開しようとするとわかりやすいエラーになりました。ほかにこのファイルを参照しているものはありません。
~/.claude が数百 GB になるのはなぜですか？
その規模になる原因がセッションであることはまれで、たいていはデバッグログと file-history のスナップショットです。まずこの 2 つのフォルダを測ってください。
Mint は Codex の会話と同じように Claude Code のセッションのスクリーンショットを縮小できますか？
できません。「最適化」は Codex の会話だけが対象で、Claude Code のセッションはそのまま残します。容量を空けたいときは、上の手順で古いセッションを手作業で削除してください。
Claude Code がどれだけ容量を使っているか確認しましょう
スキャンしてから「ディスク」タブで Claude を探してください。セッション、キャッシュ、~/.claude のほかのフォルダのサイズを確認できます。