必要な会話を残して Codex の保存容量を減らす
まず会話履歴、埋め込み画像、キャッシュ、索引を分けます。ある開発者の Mac では、1,231 会話の 22.83 GB のうち 71% が画像でした。対応する会話の Optimize は、Codex が続きを読むための画像を保ち、重複した保存を減らします。メディア削除と会話削除は別の選択です。アーカイブだけでは容量は減りません。
要点
- 最初に： 必要な会話は残し、メディアや会話を捨てる前に対応する Optimize を確認します。
- 調査した例： 1 台の Mac、1,231 会話、22.83 GB、71% が画像。あなたの削減量の予測ではありません。
- 結果を確認： 実際の容量を比べ、会話を開き直します。必要な作業を続けられることも確かめます。
実際の会話で測った前後の結果
10 月 15 日の公開版 Mint 1.0.99 による検証では、対象の会話 8 件の容量を 35.1% 削減し、継続リクエストと取り消し後の内容を確認しました。これとは別に、9 月 26 日に Mint チームが開発版で別のファイル単位の圧縮方法を試した実験では、実際の Codex ファイル 3.13 GB から 1.29 GB、約 41% を削減。1 会話あたり平均 428.42 MB で、4 ファイルの全バイトと Codex の 1,598 ターンが一致しました。異なる方法とファイルの、日付付きの実測結果です。
この会話をまだ使いたい。何を変えられる？
会話に同じ画像があっても、文章が違えばファイル全体は一致しません。別の 1,467 ファイルの調査はこの重複を数えたもので、Mint で回収できる容量を測ったものではありません。
| 目的 | 確認する操作 | 残る内容 |
|---|---|---|
| 対応する会話画像を残し、重複した保存を減らす | Optimize | テキストと会話を続けるために Codex が読む画像。形式、使用状況、依存関係により対象が変わります。 |
| テキストを残し、埋め込みメディアを手放す | Remove media | テキストは残り、選択した画像、音声、動画は永久に削除されます。 |
| 会話を残さない | Delete permanently | 選んだ会話全体を削除します。内容を保つ最適化とは異なります。 |
~/.codex の中身
会話は、Codex がロールアウトと呼ぶファイルです。アクティブな会話は ~/.codex/sessions に、アーカイブした会話は ~/.codex/archived_sessions にあります。会話は最初 .jsonl ファイルとして保存されます。検証した codex-cli 0.155.1 の環境では、7 日間使われていない会話を同じ名前の .jsonl.zst として保存し直します。Codex がそのまま開ける圧縮版で、それより新しい会話は .jsonl のままです。これは検証環境の動作で、すべてのクライアントの初期設定を保証するものではありません。標準の圧縮はバージョンと設定に依存します。Codex で会話をアーカイブしても、ファイルが片方のフォルダからもう片方に移るだけなので容量は戻りません。
スクリーンショットはデータとしてファイルに書き込まれます。長いセッションがコンテキストを compaction すると同じスクリーンショットがもう一度書き込まれ、計測した Mac では 1.76 GB の会話 1 件のうち 1.57 GB が重複でした。
このフォルダには thread_history_1.sqlite（その Mac では 1.74 GB）と logs_2.sqlite（1.13 GB）のほか、worktree やプラグインも入っています。2 つの SQLite ファイルは Codex 自身のインデックスとログです。会話のデータとは別物で、手で編集するためのものでもありません。
手作業で容量を空ける場合
Codex は会話のインデックスを自分で管理していて、ファイルは Codex を通して変わる前提になっています。できる操作は Codex の中で行いましょう。
- 不要になった会話は Codex の中で削除し、インデックスを正しい状態に保ちます。
- キャッシュやランタイムを消す前に Codex を終了します。
- 会話のファイルを自分で編集する前に、ほかの会話がそのファイルに依存していないか確認します。
- 依存している場合は、ファイルに手を付けないでください。短くすると、依存する会話が開けなくなることがあります。
Mint でできること
Mint Direct 1.1.0 は、通常の .jsonl 形式と圧縮された .jsonl.zst 形式の会話を読み取れます。「ディスク」の Yours · Codex で、会話ごとのサイズ、最終使用日時、画像数を確認でき、「Last used」メニューで絞り込めます。Optimizable · Codex には、対応する最適化と計測した削減量が表示されます。ここで説明するのは Direct 1.1.0 の機能です。Mac App Store 版と Setapp 版の機能は、それぞれ公開されているバージョンによって異なります。
対応する .jsonl 形式の会話では、Optimize（最適化）が重複スクリーンショットの保存容量を減らし、画像のピクセルを変えずに小さく保存できます。会話を続けるときに Codex が読む画像は残ります。必要な元データと履歴が利用できる間は、対応する画像の最適化を取り消せます。
対象となる .jsonl.zst 形式の会話では、Optimize が既存の会話をより効率よく圧縮します。展開後の会話は、テキストや埋め込みメディアを含め、すべてのバイトが元の内容と一致します。この圧縮のみの最適化には取り消し機能はありません。スキャンで対象の会話をさらに小さくできると確認された場合にだけ表示されます。
Yours · Codex の Keep text only（テキストだけ残す／Remove media）は、会話のテキストを残し、埋め込みの画像・音声・動画を完全に取り除きます。小さなプレビューは残らず、代わりにプレースホルダーが入ります。取り除いたメディアは復元できません。Delete permanently は、選んだ会話全体を Codex を通して削除します。
Mint は会話を変更する前に、選んだ操作に対応しているかを確認します。形式、使用状況、会話間の依存関係によって利用できる操作が変わるため、お使いのエディションの確認画面を読んでください。SQLite ファイルはサイズを測るだけで、編集することはありません。
操作デモを見る (0:33): Where did my Mac storage go? What AI agents leave behind
最初に確かめる：ファイルを残して容量を減らす
初回スキャン後は Optimizable を見ます。名前、場所、内容を保ったまま保存容量を減らせる対象が表示されます。すでに効率よく保存されている Mac では、対象が少ないこともあります。
- 一つの最適化と対象ファイルを確認します。Codex の会話では、インストールした版が対応する場合に Optimize を選びます。Remove media と Delete は別の操作で、削除は元に戻せません。
- 完了後、処理結果とディスクの空き容量を比べ、必要なファイルや会話を開いて確かめます。スキャンの見積もりと空き容量の変化は一致しない場合があります。
- 結果を確かめたら、継続したい処理やフォルダの Auto Care を有効にします。Mint の起動中、選んだ範囲と時間で実行されます。会話ごとの操作はアプリの説明に従って確認します。
古い会話を整理しても容量があまり空かない理由
重複したスクリーンショットは、スクリーンショットの多い最近の長いセッションにたまります。計測した Mac では重複の 92% が直近 6 日以内に使った会話にあったので、1 週間より古い会話だけを選ぶと大部分を取りこぼします。
取り戻せる容量は操作によって変わります。Optimize は Codex が読む内容を保つ、対応した最適化だけを提案します。Keep text only は一度しか出てこない画像も取り除けますが、その画像は永久に失われます。サンプルの Mac の合計値ではなく、自分が選んだ項目の計測値を確認してください。
よくある質問
Codex の会話をアーカイブすると容量は空きますか？
空きません。ファイルが sessions から archived_sessions に移るだけです。容量を戻すには、会話を最適化するか削除してください。
~/.codex や archived_sessions をまとめて削除しても大丈夫ですか？
まとめて消すのはやめましょう。~/.codex を消すとすべての会話、設定、Codex のローカルの状態がなくなるので、Codex か Mint から会話を 1 件ずつ削除してください。
thread_history_1.sqlite を小さくできますか？
手作業では安全にできません。これは Codex のインデックスで、Mint もサイズを測るだけで整理や編集はしません。
最適化した会話は Codex でどう見えますか？
Direct 1.1.0 の Optimize は、対応する会話を続けるときに Codex が読む画像を残します。通常の .jsonl の画像最適化を取り消すには、必要な元データと履歴が利用できる必要があります。一方、.jsonl.zst の圧縮のみの最適化では、展開後の会話がバイト単位で一致しますが、取り消し機能はありません。Keep text only は別の、元に戻せない操作です。テキストを残して埋め込みの画像・音声・動画を取り除き、小さなプレビューも残しません。
まず Codex の会話ごとのサイズを確認しましょう
スキャンしてから「ディスク」タブで Yours を開き、Codex チップを選んでください。操作する前に、会話ごとのサイズと画像の数を確認できます。