Où Codex range tes sessions, et comment les retrouver

Le CLI Codex garde chaque conversation sur ton Mac, rangée par date. Comment la reprendre, l'archiver, et la mettre à l'abri avant un changement de machine.

Publié le 29 septembre 2026 · 5 min de lecture

Comme Claude Code, le CLI Codex d'OpenAI enregistre tes conversations en local pour que tu puisses les reprendre. Voici où elles sont et ce que tu peux en faire.

Le dossier : `~/.codex/sessions`

La documentation de Codex indique que les conversations sont rangées dans ~/.codex/sessions. En pratique, sur un Mac avec Codex 0.148, on y trouve une arborescence par date, avec un fichier JSONL par session :

~/.codex/sessions/2026/09/02/rollout-2026-09-02T10-14-03-<id>.jsonl

Le nom du fichier donne la date et l'heure de début, suivies de l'identifiant de la session. Chaque ligne décrit un événement : ton message, la réponse, un appel d'outil, son résultat.

À côté, dans ~/.codex :

archived_sessions/ reçoit les sessions que tu archives (voir plus bas), au même format.
history.jsonl garde l'historique de tes demandes. Deux réglages de ~/.codex/config.toml le contrôlent : history.persistence ("save-all" ou "none") et history.max_bytes, qui plafonne sa taille en supprimant les entrées les plus anciennes.

La variable CODEX_HOME déplace l'ensemble hors de ~/.codex.

Reprendre une session

Commande	Ce qu'elle fait
`codex resume`	Ouvre le sélecteur des sessions récentes du dossier courant
`codex resume --last`	Reprend la session la plus récente, sans sélecteur
`codex resume --all`	Montre les sessions de tous les dossiers, avec leur dossier de travail
`codex resume <id ou nom>`	Reprend une session précise
`codex exec resume --last "…"`	Reprend une session sans interface, pour un script
`codex fork`	Repart d'une session passée dans une nouvelle branche

Archiver sans perdre

codex archive <id ou nom> range une session pour qu'elle ne t'encombre plus, et codex unarchive la fait revenir. Archiver n'est pas supprimer : la session reste sur ton Mac, dans archived_sessions/.

Combien de temps elles restent

Contrairement à Claude Code, qui supprime ses sessions après 30 jours par défaut, la documentation de Codex ne décrit pas de suppression automatique de ~/.codex/sessions à ce jour. Sur notre Mac de test, des sessions de mars sont toujours là en septembre. Seul history.jsonl peut être plafonné, et seulement si tu règles history.max_bytes.

Deux situations peuvent quand même te les faire perdre :

Un changement de Mac ou un nettoyage du dossier personnel. ~/.codex est un dossier caché : vérifie qu'il fait partie de ce que tu transfères.
Un changement de format. Les versions récentes de Codex ajoutent codex migrate-rollouts, qui inspecte ou migre les « anciennes sessions locales » vers un historique paginé. Sans l'option --apply, la commande se contente d'un rapport. Avant d'appliquer une migration, fais une copie.

Une copie tient en une ligne :

rsync -a ~/.codex/sessions/ ~/Archives/codex/sessions/

Relancée régulièrement, elle ne recopie que les nouvelles sessions.

Sources

Documentation Codex : le CLI Codex (codex resume, codex exec resume, emplacement des sessions)
Documentation Codex : référence de configuration (history.persistence, history.max_bytes, CODEX_HOME)
Aide intégrée de codex resume, codex archive, codex fork et codex migrate-rollouts, codex-cli 0.148.0

Vérifié sur codex-cli 0.148.0, le 29 septembre 2026. L'arborescence par date est celle observée sur cette version ; elle peut changer.