AI エージェントの容量

AI コーディングエージェントが Mac の容量を大きく使う理由

容量の大半は会話履歴で、その多くはスクリーンショットです。Codex と Claude Code はスクリーンショットを会話ファイルに直接書き込み、長いセッションでは同じ画像を何度も書き込みます。ある開発者の Mac では 1,231 件の Codex の会話が 22.8 GB を占め、その 71% が画像で、一度しか出てこない画像は 16% でした。

ツールごとのデータの置き場所

Codex は会話を .jsonl ファイルとして ~/.codex/sessions に保存し、アーカイブすると ~/.codex/archived_sessions に移します。アーカイブはファイルを移すだけなので、容量は空きません。キャッシュやランタイムも同じフォルダにあります。

Claude Code はセッションごとに .jsonl ファイルを作り、~/.claude/projects の中にあるプロジェクトパス名のフォルダに置きます。計測した Mac では、そのうち約 30% が埋め込み画像でした。隣にあるデバッグログやファイルのスナップショットが、セッションより大きくなることもあります。

Cursor はチャット履歴を状態データベースに、チャットの画像を workspaceStorage の中の普通のファイルとして保存します。Claude Desktop の会話は Anthropic のサーバーにあるので、ローカルの数 GB は主に Cowork 用の仮想マシンバンドルとセッションのメタデータです。

手作業で片付ける場合

消す前に中身を確認してください。どのフォルダにも、作り直せるデータと消したら戻らないデータが混ざっています。~/.codex や ~/.claude に rm -rf を実行すると、会話も設定もまとめて消えてしまいます。

  1. ターミナルで開いたままの CLI セッションも含めて、エージェントを終了します。
  2. du -sh でツールのフォルダとサブフォルダを測り、どこが大きいのかを確かめます。
  3. 不要になった会話を 1 件ずつ削除し、ツールに削除機能があればそれを使います。
  4. キャッシュはツールを閉じているときだけ消し、設定やデータベースには触れないでおきます。

Mint でできること

Mint は Mac の中で会話ファイルを読み、「ディスク」タブに Codex、Claude、Cursor を名前付きで表示します。取り戻せる容量と使用中の容量は分けて表示され、データが Mac の外に出ることはありません。

Codex では、最後に使った日を目安に会話を選べます。「最適化」はテキストをすべて残したまま各スクリーンショットを小さなプレビューに置き換え、会話はこれまでどおり Codex で開けます。「削除」は Codex を通じて会話ごと消すので、Codex のインデックスも崩れません。どちらも元に戻せない操作で、実行前の確認画面にそう書かれています。

Claude Code のセッションはサイズを測るだけでそのまま残るので、古いセッションを消すかどうかは自分で決めます。エージェントを閉じているときはキャッシュ全体を消せ、起動中は使われていないキャッシュのエントリだけが対象になります。Direct 版と Setapp 版では、Claude Desktop の Cowork バンドルは最初からチェックが入っておらず、Claude を終了したあとにだけ削除でき、次に Cowork を使うと再ダウンロードされます。

操作デモを見る (0:17): AI Chats Taking Up Mac Storage? Compress Their Images with Mint

削除する前に確認したいこと

Codex の会話には分岐したものがあり、分岐した会話は元になった会話ファイルの履歴をバイト位置で直接読んでいます。元のファイルが短くなると、Codex はその分岐を開けなくなります。Mint はほかの会話が依存しているファイルを書き換えないので、自作のスクリプトでも同じ確認をしてください。

Codex は完了したステップを意図的に 2 回ずつ書き込みます。重複に見えるテキストは Codex が読み戻す内容なので、そのままにしておきましょう。自分でファイルに手を入れたあとは、エージェントでその会話を開き、正しく読み込めるかを確かめてください。

よくある質問

~/.codex フォルダを削除しても大丈夫ですか？

フォルダごと消すのはやめましょう。すべての会話に加えて、Codex の設定とローカルの状態が入っています。不要な会話だけを削除し、キャッシュは Codex を閉じてから消してください。

Codex の会話をアーカイブすると容量は空きますか？

空きません。.jsonl ファイルが sessions から archived_sessions に移るだけで、最適化か削除をするまで使っている容量は変わりません。

会話ファイル 1 つが数 GB になるのはなぜですか？

スクリーンショットがファイルの中に書き込まれていて、長いセッションがコンテキストを compaction するたびに同じ画像がもう一度書き込まれるからです。ある Mac では、14.8 GB の会話に含まれる重複のない画像は 155 MB だけでした。

Mint の「最適化」を使うと会話はどうなりますか？

スクリーンショットは小さなプレビューに、音声や動画はプレースホルダーに置き換わり、テキストはそのまま残ります。会話は Codex で開けますが、元の画像や音声、動画は戻せません。

エージェントが何を保存しているか見てみましょう

スキャンしたあと「ディスク」タブで Codex、Claude、Cursor の行を開き、サイズを確かめてから最適化するか削除するかを決めてください。

AI エージェントの容量をスキャン