Macの ~/.claude フォルダとは。削除できるか

場所

これは何か

Claude CodeはAnthropicのターミナル用コーディングエージェントで、ユーザごとのデータを ~/.claude に保持します。自分で書いたり設定したりしたファイルがここにあります。settings.json、自分の指示を書いたグローバルの CLAUDE.md、そしてカスタムのコマンド、エージェント、スキル、プラグインです。

大きくなるのは履歴の部分です。projects フォルダには各セッションの記録が、実行したフォルダごとにまとめて入っており、ファイルのチェックポイントやシェルのスナップショットなどのための小さめのフォルダもあります。ツールの出力が大きい長時間のセッションは、大きな記録になります。

Claude Codeは、決められた日数より古い記録を自分で削除します。この期間は、settings.json の cleanupPeriodDays 設定で変更できます。

どのくらい大きくなるか

通常は数十MBから数百MBで、何か月もよく使っていると数GBに達することがあります。

手動で消去する方法

1. 下記のコマンドを実行して、どの部分が最も大きいかを確認します。サイズを読み取るだけです。
2. 実行中のClaude Codeのセッションがあれば閉じます。
3. Finderで ~/.claude/projects を開きます。各サブフォルダは、Mac上の1つのプロジェクトフォルダに対応しています。不要になったものをゴミ箱に入れます。
4. settings.json、CLAUDE.md、そして commands、agents、skills、plugins の各フォルダは残しておきます。これらは自分で書いたり設定したりしたもので、作り直してくれるものはありません。

du -sh ~/.claude/* | sort -hr | head -15

削除したあとはどうなるか

記録を削除したセッションは、再開も検索もできなくなります。プロジェクト自体のファイルはここには保存されていないので、影響を受けません。フォルダ全体を削除した場合、Claude Codeはデフォルトの設定で最初からやり直しになります。

Diskzyでの扱い

Diskzyは、~/.claude を各サブフォルダのサイズとともにディスクマップに表示し、「Search」（検索）では、その中の最も大きいファイルや最も古いファイルを一覧表示できます。Diskzyで削除したものは、まずゴミ箱に入ります。

関連ガイド

• .codex~/.codex
• Cursor~/Library/Application Support/Cursor
• .cache~/.cache