Dossier ~/.codex sur Mac : c'est quoi, peut-on le supprimer ?

Où il se trouve

De quoi il s'agit

Codex, l'agent de programmation d'OpenAI, stocke ses données propres à chaque utilisateur dans ~/.codex. La configuration se trouve dans config.toml, votre connexion dans auth.json, et les instructions globales que vous avez écrites dans AGENTS.md.

La partie qui grossit est la trace de votre travail. Le dossier sessions conserve un fichier par session, classé par date, et des fichiers d'historique et de journalisation se trouvent à côté. Selon la façon dont vous utilisez Codex, le dossier peut aussi contenir des plugins, des paquets téléchargés et un dossier worktrees avec des copies de travail de vos dépôts.

En dehors de worktrees, vos projets n'ont besoin de rien de ce qui se trouve ici. Le dossier ne sert qu'à Codex lui-même.

Quelle taille il peut atteindre

En général de quelques dizaines à quelques centaines de Mo, et davantage après une longue utilisation, puisque les anciennes sessions sont conservées.

Comment le vider à la main

1. Exécutez la commande ci-dessous pour voir quelles parties sont les plus volumineuses. Elle se contente de lire les tailles.
2. Fermez les sessions Codex en cours et quittez l'app Codex.
3. Ouvrez ~/.codex/sessions dans le Finder et placez les dossiers datés les plus anciens dans la corbeille.
4. S'il existe un dossier worktrees, considérez-le comme votre travail. Vérifiez dans chaque copie de travail qu'il ne reste pas de modifications non fusionnées, et ne supprimez que celles dont vous êtes sûr qu'elles sont terminées.
5. Gardez config.toml, auth.json et AGENTS.md. Traitez auth.json comme un secret : ne le partagez pas et ne le téléversez nulle part.

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

Ce qui se passe ensuite

Les sessions que vous avez supprimées ne peuvent plus être reprises. Un worktree supprimé emporte avec lui toutes les modifications non fusionnées. Si vous supprimez auth.json ou le dossier entier, vous vous connectez à nouveau et Codex revient à sa configuration par défaut.

Comment Diskzy le traite

Diskzy affiche ~/.codex sur la carte du disque avec la taille de chaque sous-dossier, et la recherche peut lister ses fichiers les plus gros ou les plus anciens. Tout ce que vous supprimez avec Diskzy va d'abord dans la corbeille.

Guides associés

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