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

場所

これは何か

CodexはOpenAIのコーディングエージェントで、ユーザごとのデータを ~/.codex に保存します。構成は config.toml に、サインイン情報は auth.json に、自分で書いたグローバルの指示は AGENTS.md に入っています。

大きくなるのは作業の記録の部分です。sessions フォルダにはセッションごとのファイルが日付別に整理されて保持され、その横に履歴とログのファイルがあります。Codexの使い方によっては、プラグイン、ダウンロードしたパッケージ、そしてリポジトリの作業コピーが入った worktrees フォルダが含まれることもあります。

worktrees を除けば、ここにあるものをプロジェクトが必要とすることはありません。このフォルダを使うのはCodex自身だけです。

どのくらい大きくなるか

通常は数十MBから数百MBで、古いセッションが保持されるため、長く使うとさらに大きくなります。

手動で消去する方法

1. 下記のコマンドを実行して、どの部分が最も大きいかを確認します。サイズを読み取るだけです。
2. 実行中のCodexのセッションがあれば閉じ、Codexアプリを終了します。
3. Finderで ~/.codex/sessions を開き、日付の古いフォルダをゴミ箱に入れます。
4. worktrees フォルダがある場合は、自分の作業の成果として扱います。それぞれの作業コピーにマージしていない変更がないか確認し、確実に終わっているものだけを削除します。
5. config.toml、auth.json、AGENTS.md は残しておきます。auth.json は秘密情報として扱い、共有したりアップロードしたりしないでください。

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

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

削除したセッションは再開できなくなります。ワークツリーを削除すると、マージしていない変更も一緒に失われます。auth.json またはフォルダ全体を削除した場合は、もう一度サインインすることになり、Codexはデフォルトの構成に戻ります。

Diskzyでの扱い

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

関連ガイド

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