Mémoires

Consignez les directives obligatoires de votre équipe dans AGENTS.md ou dans la documentation du dépôt. Les mémoires servent d’aide-mémoire. Pour les règles qui doivent toujours s’appliquer, évitez de vous appuyer uniquement sur elles.

Dans l’application de bureau ChatGPT, utilisez /memories pour choisir si une discussion peut utiliser les mémoires locales ou contribuer à la création de nouvelles mémoires. Dans Paramètres > Personnalisation, utilisez Activer les mémoires Codex pour activer ou désactiver la fonctionnalité sur la machine sélectionnée. Le réglage Autoriser les mémoires issues de discussions utilisant des outils vous permet de choisir si les discussions qui utilisent des outils MCP ou la recherche web peuvent contribuer à la création de nouvelles mémoires.

Pour réinitialiser le stockage des mémoires de la machine sélectionnée, choisissez Supprimer les mémoires Codex, puis confirmez. Sur la machine locale, cette opération efface également l’historique de l’ordinateur lorsque cette fonctionnalité est disponible.

Gérez la mémoire de ChatGPT dans Paramètres > Personnalisation. ChatGPT Work utilise les paramètres de mémoire disponibles pour votre compte et votre espace de travail. Il n’utilise ni le stockage local des mémoires de Codex ni les réglages locaux de mémoire.

Dans une session interactive de Codex CLI, utilisez /memories pour choisir si la discussion en cours peut utiliser les mémoires locales existantes ou servir de source à de nouvelles mémoires. Si la commande n’est pas disponible, consultez la section Configuration des mémoires locales.

L’extension pour IDE utilise les mémoires stockées localement sur l’hôte Codex auquel elle est connectée. Si les mémoires sont activées sur cet hôte, utilisez les mêmes réglages par discussion que dans Codex CLI.

L’historique de l’ordinateur est une fonctionnalité de l’application de bureau pour macOS. À partir de votre activité dans les applications et sur les sites web autorisés, elle crée des mémoires et une chronologie que ChatGPT et Codex peuvent consulter.

Fonctionnement des mémoires locales de Codex

Une fois les mémoires activées, Codex peut extraire des éléments de contexte utiles de discussions antérieures admissibles et les enregistrer dans des fichiers de mémoire locaux. Codex ignore les sessions actives ou de courte durée et masque les secrets dans les champs de mémoire qu’il génère. Il met à jour les mémoires en arrière-plan plutôt que de le faire immédiatement à la fin de chaque discussion.

La mise à jour des mémoires peut prendre du temps après la fin d’une discussion. Codex attend que la discussion soit restée inactive suffisamment longtemps pour éviter de résumer un travail encore en cours.

Codex peut aussi sauter un cycle de génération des mémoires en arrière-plan si le pourcentage de quota restant est inférieur au seuil configuré. Il évite ainsi de consommer du quota lorsque vous approchez de votre limite de débit.

Stockage local des mémoires

Codex stocke les mémoires dans votre répertoire de base Codex. Par défaut, il s’agit de ~/.codex. Consultez la section Emplacements des fichiers de configuration et d’état pour savoir comment Codex utilise CODEX_HOME.

Lorsque vous activez les mémoires dans un nouveau répertoire de base Codex, Codex CLI utilise $CODEX_HOME/memories_v2/ par défaut. Si $CODEX_HOME/memories/ existe déjà, Codex CLI continue d’utiliser ce répertoire par défaut. Pour choisir explicitement une version, définissez memories.version. En l’absence de version explicite, le réglage memories.dual_write = false maintient même un nouveau profil en v1.

Si vous utilisez l’application de bureau ChatGPT, recherchez les résumés générés et les éléments des discussions antérieures qui les étayent dans les deux répertoires : $CODEX_HOME/memories/ et $CODEX_HOME/memories_v2/. Pendant la migration, une nouvelle discussion locale pour laquelle les mémoires sont activées peut lire les mémoires dans memories/ et écrire dans les deux répertoires, même avec un nouveau profil.

Considérez ces fichiers comme des données d’état générées par Codex. Vous pouvez les examiner pour diagnostiquer un problème ou avant de partager votre répertoire de base Codex, mais évitez de gérer vos mémoires principalement en modifiant ces fichiers à la main.

Gestion des mémoires locales par discussion

Dans l’application de bureau ChatGPT et dans l’interface en mode texte de Codex, utilisez /memories pour gérer les mémoires de la discussion en cours. Vous pouvez choisir si la discussion peut utiliser les mémoires existantes et si Codex peut s’appuyer sur cette discussion pour en générer de nouvelles.

Ces choix s’appliquent à la discussion sans modifier vos paramètres globaux de mémoire.

Vérification des mémoires locales

Ne stockez pas de secrets dans les mémoires. Codex masque les secrets dans les champs de mémoire qu’il génère. Vérifiez tout de même les fichiers de mémoire avant de partager votre répertoire de base Codex ou des artefacts issus de la génération des mémoires.

Configuration des mémoires locales

Les mémoires locales de Codex sont désactivées par défaut. Dans l’application de bureau ChatGPT, ouvrez Paramètres > Personnalisation, puis activez l’option Activer les mémoires Codex.

Pour activer la fonctionnalité depuis le fichier de configuration, ajoutez le paramètre suivant à config.toml :

[features]
memories = true

Pour connaître les emplacements des fichiers de configuration et la liste complète des paramètres de mémoire, consultez les principes de base de la configuration et la référence de configuration.

Parmi les paramètres courants propres aux mémoires figurent les suivants :

• memories.generate_memories détermine si les nouvelles discussions peuvent être enregistrées pour servir de source à la génération de mémoires.
• memories.use_memories détermine si Codex intègre les mémoires existantes au contexte des futures sessions.
• memories.disable_on_external_context, lorsqu’il vaut true, exclut de la génération de mémoires les discussions qui ont utilisé un contexte externe, par exemple via des appels à des outils MCP, une recherche web ou une recherche d’outils. L’ancienne clé memories.no_memories_if_mcp_or_web_search reste acceptée comme alias.
• memories.min_rate_limit_remaining_percent fixe le pourcentage minimal de quota Codex qui doit rester disponible pour que la génération de mémoires démarre.
• memories.extract_model remplace le modèle utilisé par défaut pour extraire les mémoires de chaque discussion.
• memories.consolidation_model remplace le modèle utilisé par défaut pour consolider l’ensemble des mémoires.