Codex : l'installer et le maintenir, pas à pas

← Retour au guide des agents IA

Codex est l’agent d’OpenAI pour travailler dans un dossier de votre ordinateur : il lit vos fichiers, écrit de petits programmes, les lance et vous rend compte. Ici, le cas concret est un rapprochement : vous avez un relevé bancaire et une liste de factures clients, tous deux en CSV, et vous voulez savoir quelles factures sont payées, lesquelles ne le sont pas, et quels virements ne correspondent à rien. À la fin, vous avez un rapport des écarts, et un programme de contrôle relu par la fonction de revue de Codex.

En bref

Avant de commencer

Un compte ChatGPT. Toute offre ouvre l’application de bureau. Le cloud et la revue de code GitHub demandent Plus ou plus. Les offres Business (de 2 utilisateurs) ajoutent l’authentification unique SAML, l’authentification multifacteur et, par défaut, pas d’entraînement sur vos données. Détail dans la page des prix.

Trois décisions à prendre avant d’installer.

• Quel compte. Un compte professionnel, au nom de la personne responsable de l’outil. Les identifiants de connexion sont gardés dans un fichier auth.json du dossier .codex de l’ordinateur (ou dans le trousseau du système, selon la configuration) : traitez-le comme un mot de passe et ne le copiez dans aucune sauvegarde partagée. Sur une offre Business ou Enterprise, un administrateur peut imposer le compte et l’espace de travail autorisés.
• Quel dossier. Codex travaille dans le dossier que vous lui ouvrez. Créez un dossier pour la tâche (ici rapprochement-octobre) et n’y mettez que les deux fichiers nécessaires.
• Quelles données restent hors de portée. Un relevé bancaire est une donnée sensible. Avant de le copier dans le dossier, supprimez les colonnes inutiles : numéro de compte, IBAN, soldes. Le script n’a besoin que de la date, du libellé et du montant. Aucun numéro de carte, jamais.

Le piège du démarrage en lecture seule. Au lancement, Codex regarde si le dossier est suivi par git (le programme qui garde les points de retour). Si oui, il recommande le mode Auto : il peut écrire dans le dossier et demande avant de sortir de ce cadre. Sinon, il recommande read-only : il lit, mais n’écrit rien. La documentation ajoute qu’il peut aussi démarrer en lecture seule tant que vous n’avez pas validé la confiance accordée au dossier. La première commande du cas, git init, évite ce piège.

Installer

On tape certaines commandes dans un terminal : une fenêtre où l’on écrit des instructions à l’ordinateur au lieu de cliquer.

1. Ouvrez le terminal.

   • Sur Mac : Cmd + Espace, tapez Terminal, Entrée.
   • Sous Windows : Win + X, puis Windows PowerShell (ou Terminal).

2. Vérifiez que git est présent (le programme des points de retour).

   git --version

   Ce que vous devez voir : un numéro de version. Sur un Mac neuf, une fenêtre peut proposer d’installer les outils de développement Apple : acceptez, patientez quelques minutes, puis relancez la commande. Sinon, installez git depuis git-scm.com (sous Windows, cochez l’ajout au PATH). Git refuse d’enregistrer un point de retour sans savoir qui vous êtes. Une seule fois :

   git config --global user.name "Votre Nom"
   git config --global user.email "vous@votre-entreprise.fr"

3. Créez le dossier de travail et activez git.

   Mac :

   cd ~/Documents
   mkdir rapprochement-octobre
   cd rapprochement-octobre
   mkdir donnees scripts resultats
   git init

   Windows PowerShell :

   cd ~\Documents
   mkdir rapprochement-octobre
   cd rapprochement-octobre
   mkdir donnees, scripts, resultats
   git init

   Ce que vous devez voir : un message disant que git a initialisé un dépôt vide. Si votre dossier Documents est ailleurs (OneDrive par exemple), choisissez un autre emplacement. Gardez ce terminal ouvert dans le dossier.

4. Copiez vos deux fichiers dans donnees, avec le Finder ou l’Explorateur : le relevé sous le nom releve-banque.csv (colonnes Date;Libelle;Montant, un encaissement est positif, un débit négatif) et la liste de factures sous le nom factures.csv (colonnes Numero;Client;Date_echeance;Montant_TTC). Séparateur point-virgule, dates JJ/MM/AAAA. Vos exports auront sans doute d’autres noms de colonnes : l’étape d’exploration plus bas sert à les repérer, et le script s’adaptera.

5. Installez Codex. Deux voies, au choix.

   L’application, sans terminal supplémentaire.

   • Mac : téléchargez l’application sur chatgpt.com/download, ouvrez-la et connectez-vous avec votre compte ChatGPT.
   • Windows : installez l’application « ChatGPT » depuis le Microsoft Store (ou, en ligne de commande, winget install --id 9PLM9XGG6VKS -s msstore). Elle fonctionne nativement dans PowerShell avec un bac à sable Windows (une zone qui limite ce que l’agent peut toucher), ou dans WSL2 si vous le choisissez dans Settings.
   • Puis, dans le menu déroulant ChatGPT, choisissez Codex, cliquez New chat et ouvrez le dossier rapprochement-octobre.
   • Sous Windows, sélectionnez Ask for approval sous la zone de saisie avant d’envoyer un message : c’est ce qui applique les protections du bac à sable.

   La ligne de commande.

   Mac :

   curl -fsSL https://chatgpt.com/codex/install.sh | sh

   Windows PowerShell :

   powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

   Vérifiez ensuite :

   codex --version

   Ce que vous devez voir : un numéro de version. La documentation lue ne liste pas d’erreurs d’installation : si la commande n’est pas reconnue, ouvrez un nouveau terminal, puis consultez la page de la ligne de commande. Sous Windows, une alternative est npm (npm install -g @openai/codex). WSL1 n’est pas supporté ; en WSL2, gardez les dossiers de travail sous ~/code/... et pas sous /mnt/c.

6. Connectez-vous. Dans le terminal, dans le dossier rapprochement-octobre :

   codex

   Choisissez Sign in with ChatGPT et suivez la fenêtre du navigateur. Si le navigateur ne peut pas s’ouvrir, quittez et tapez codex login --device-auth. codex login status vérifie la connexion, codex logout la ferme.

   Ce que vous devez voir : la zone de saisie de Codex. Dans la ligne de commande, tapez /status : la réponse donne l’identifiant de la conversation, l’usage du contexte et les limites, et indique quels dossiers font partie de l’espace de travail. Tapez /permissions pour voir le mode actif.

7. Créez les fichiers de la section suivante (AGENTS.md dans le dossier, config.toml dans votre dossier .codex, default.rules dans .codex/rules), puis relancez Codex pour qu’il les charge.

Configurer ce qui compte

AGENTS.md : les consignes permanentes

AGENTS.md est lu au début de chaque session, au niveau du projet et, si vous le créez, dans ~/.codex/AGENTS.md pour tous vos projets. Les fichiers placés plus près du dossier de travail l’emportent. La lecture s’arrête à 32 Kio cumulés par défaut : ce fichier doit rester très court.

Mac, dans le terminal ouvert dans rapprochement-octobre, copiez tout le bloc (de cat à EOF) :

cat > AGENTS.md <<'EOF'
# Consignes pour l'agent : rapprochement banque et factures (Entreprise Exemple, PME)

## Qui je suis
Je dirige l'entreprise. Je ne suis pas développeur. Explique-moi en français simple,
sans jargon. Si tu emploies un terme technique, définis-le en une phrase.

## Où sont les choses
- `donnees/` : relevé de banque et factures. Ne jamais modifier ces fichiers.
- `resultats/` : fichiers produits par les scripts.
- `scripts/` : les petits programmes que tu écris.

## Règles de travail
- Avant de modifier quoi que ce soit : dis-moi en deux phrases ce que tu vas faire.
- Fais une petite étape à la fois, puis montre-moi le résultat avant de continuer.
- Ne supprime jamais un fichier sans me le demander.
- Ne paie rien, n'envoie rien (e-mail, relance, message) : prépare des listes et des brouillons, c'est moi qui décide.
- N'utilise jamais Internet. N'ouvre aucun fichier hors de ce dossier.
- Ne fais pas `git push` ni `git commit` : c'est moi qui enregistre les points de retour.

## Données
- Le relevé est une donnée bancaire sensible : n'en recopie aucune ligne dans un exemple de test ;
  utilise des données inventées pour les tests.
- Format des fichiers CSV : séparateur point-virgule, UTF-8, dates JJ/MM/AAAA, montants à virgule décimale.
- Les montants se calculent en Decimal (jamais en nombres à virgule flottante).

## Vérification
- Après chaque script : donne les totaux avant et après, 5 exemples de lignes traitées,
  et la liste de ce qui n'a pas pu être rapproché, avec la raison.
EOF

Sous Windows, ouvrez le Bloc-notes, collez le contenu entre cat et EOF (sans ces deux lignes), puis Fichier > Enregistrer sous dans le dossier, nom "AGENTS.md" entre guillemets, encodage UTF-8.

Pour vérifier : la documentation propose cette commande, à taper dans le terminal à la racine du dossier. Codex doit citer le contenu du fichier.

codex --ask-for-approval never "Summarize the current instructions."

Dans l’application, demandez simplement « Résume les consignes que tu as chargées ». Si elles sont tronquées, la clé project_doc_max_bytes du fichier config.toml relève la limite. Voir AGENTS.md.

config.toml : les réglages de sécurité

Le fichier se range dans ~/.codex/config.toml (Windows : %USERPROFILE%\.codex\config.toml) et vaut pour tous vos projets. Un fichier .codex/config.toml dans un projet n’est chargé que si le projet est approuvé. Pour l’ouvrir dans un éditeur de texte (il est créé s’il n’existe pas), tapez sur Mac mkdir -p ~/.codex && touch ~/.codex/config.toml && open -e ~/.codex/config.toml, et sous Windows PowerShell mkdir $HOME\.codex -Force; notepad $HOME\.codex\config.toml (le Bloc-notes propose de créer le fichier). Collez-y le bloc suivant, puis enregistrez.

approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = false

Si le fichier existe déjà, ajoutez ces lignes au lieu de le remplacer, en plaçant les deux premières avant toute ligne entre crochets : une clé en double est une erreur.

Le fichier ne contient volontairement pas de ligne model : sans elle, Codex utilise un modèle recommandé, ce qui évite de rester sur un modèle retiré. Si vous en fixez un, mettez-le à jour quand OpenAI en retire un (voir « Le maintenir »). Le fichier est valide au format TOML. La liste complète des clés : configuration de base.

Ne mettez jamais untrusted comme politique d’approbation : cette valeur est retirée, et Codex peut ne plus démarrer si elle traîne dans une vieille configuration.

Les règles de commande

Un fichier de règles ajoute un verrou sur des commandes précises. La documentation les classe comme expérimentales : elles peuvent changer. Pour l’ouvrir, tapez sur Mac mkdir -p ~/.codex/rules && touch ~/.codex/rules/default.rules && open -e ~/.codex/rules/default.rules, et sous Windows PowerShell mkdir $HOME\.codex\rules -Force; notepad $HOME\.codex\rules\default.rules. Collez-y le bloc suivant, enregistrez, puis redémarrez Codex :

prefix_rule(
    pattern = ["git", "push"],
    decision = "forbidden",
    justification = "Pas de publication sans validation humaine.",
    match = ["git push origin main"],
    not_match = ["git status"],
)

Les décisions possibles sont allow, prompt et forbidden ; la plus restrictive l’emporte. Ces règles pilotent les commandes qui sortent du bac à sable. Voir les règles.

Ce qui n’existe pas dans la documentation lue : l’équivalent d’une règle qui interdirait à Codex de lire un fichier précis (comme le fait Claude Code avec Read(./.env)). Conséquence pratique : ne mettez rien de sensible dans le dossier de travail.

Votre premier agent utile : rapprocher la banque et les factures

Le principe : vous ne demandez jamais à l’agent de « rapprocher les fichiers » à la main. Vous lui demandez un script (un petit programme), vous le testez sur des données inventées dont vous connaissez la réponse, vous le faites relire par la revue, puis vous le lancez sur les vrais fichiers. Le script est reproductible et vos fichiers restent intacts.

Python doit être installé (sous Windows, cochez « Add python.exe to PATH » dans l’installateur). Vérifiez avec python3 --version (sous Windows, python --version). S’il est absent, installez-le depuis python.org.

Deux fichiers d’essai avec des données inventées

Créez ces deux fichiers dans donnees/, par la même méthode que pour AGENTS.md (Bloc-notes sous Windows, ou cat > donnees/essai-releve.csv <<'EOF' puis le contenu puis EOF sur Mac). Si Codex tourne déjà dans votre terminal, ouvrez-en un second (Mac : Cmd + N), puis tapez cd ~/Documents/rapprochement-octobre (Windows : cd ~\Documents\rapprochement-octobre).

donnees/essai-releve.csv :

Date;Libelle;Montant
02/10/2026;VIR SEPA ATELIER MARTIN FA-2026-101;1 200,00
03/10/2026;PRLV ASSURANCE;-85,40
05/10/2026;VIR BOULANGERIE SOLEIL REGLEMENT FA-2026-102;480,00
08/10/2026;VIR CABINET ROUX FA2026-103;1000,00
10/10/2026;VIR GARAGE NEUF;750,50
12/10/2026;VIR STUDIO NORD;300,00
14/10/2026;VIR DIVERS REMBOURSEMENT;42,00
15/10/2026;VIR PETIT SARL FA-2026-104 ET FA-2026-105;900,00
20/10/2026;CB FOURNISSEUR;-210,00

donnees/essai-factures.csv :

Numero;Client;Date_echeance;Montant_TTC
FA-2026-101;Atelier Martin;30/09/2026;1 200,00
FA-2026-102;Boulangerie Soleil;05/10/2026;480,00
FA-2026-103;Cabinet Roux;08/10/2026;1 250,00
FA-2026-104;Petit SARL;10/10/2026;400,00
FA-2026-105;Petit SARL;10/10/2026;500,00
FA-2026-106;Garage Neuf;12/10/2026;750,50
FA-2026-107;Studio Nord;15/10/2026;300,00
FA-2026-108;Bernard Conseil;01/10/2026;640,00
FA-2026-109;Atelier Nord;01/11/2026;300,00

Dans le terminal, enregistrez maintenant le point de départ : git add . puis git commit -m "départ".

Les fichiers contiennent les cas pièges : un virement qui porte le numéro de facture, un autre qui ne le porte pas mais dont le montant est unique, un paiement partiel (1 000 € pour une facture de 1 250 €), un virement qui règle deux factures d’un coup, un montant identique à deux factures, un remboursement sans facture, une facture oubliée.

Les prompts, dans l’ordre

Tapez-les dans Codex, un par un, et lisez chaque réponse avant de passer au suivant. Ces textes sont rédigés pour cette page et n’ont pas été exécutés de bout en bout, d’où le contrôle à chaque étape.

1. Explorer sans rien modifier.

Regarde donnees/releve-banque.csv et donnees/factures.csv. Dis-moi pour chacun : le nombre de lignes, les noms des colonnes, le format des dates et des montants, et les lignes qui te paraissent anormales (vides, doublons, montant illisible). Ne modifie rien.

Avec vos vrais fichiers, c’est ici que vous découvrez leurs vrais noms de colonnes ; reprenez-les dans le prompt suivant.

2. Faire proposer la méthode.

Propose-moi comment rapprocher un paiement d'une facture : quels critères, dans quel ordre, et ce que tu fais quand deux factures ont le même montant. Je choisirai.

3. Choisir et faire écrire le script. Sous Windows, remplacez python3 par python dans la ligne « Commande ». Si vos fichiers ont d’autres noms de colonnes, changez la ligne « Colonnes ».

Applique cette méthode et pas d'autre. Écris le script scripts/rapprocher.py, en Python, sans bibliothèque à installer.
Commande : python3 scripts/rapprocher.py RELEVE.csv FACTURES.csv
Colonnes : relevé = Date, Libelle, Montant ; factures = Numero, Client, Date_echeance, Montant_TTC.
Règles :
1) Seuls les montants positifs du relevé sont des encaissements. Les débits sont ignorés mais comptés.
2) Passe 1 : si le numéro d'une facture figure dans le libellé (sans tenir compte des espaces, des tirets ni de la casse), c'est un rapprochement. Montant identique : rapproché. Montant différent : écart de montant, avec la différence. Plusieurs numéros dans un libellé : ambigu, ne choisis pas.
3) Passe 2, pour les encaissements restants : même montant au centime qu'une seule facture non rapprochée : rapproché, marqué « À CONFIRMER ». Même montant que plusieurs factures : ambigu, ne choisis pas.
4) Ce qui reste : encaissement sans facture, et facture non payée avec son nombre de jours de retard (0 si l'échéance n'est pas passée), calculé à la date du dernier encaissement du relevé.
5) Montants en Decimal, jamais en float. Montants à virgule décimale et espaces dans les milliers acceptés.
6) Sorties dans resultats/ : rapprochements.csv, ecarts.csv (une ligne par écart, avec le type et le détail) et rapport.txt. UTF-8 avec BOM, séparateur point-virgule.
7) Le rapport donne : lignes du relevé, encaissements, débits ignorés, factures, rapprochées (dont à confirmer), écarts par type, factures non payées avec leur total, et un contrôle « encaissements = rapprochés + en écart ».
8) Ne modifie jamais les fichiers d'entrée.

Codex vous montre le script. Lisez le haut et la partie qui écrit les fichiers : elle ne doit écrire que dans resultats/.

4. Tester sur les données inventées.

Lance le script sur donnees/essai-releve.csv et donnees/essai-factures.csv et montre-moi le rapport et ecarts.csv.

Si votre script suit les règles ci-dessus, vous devez obtenir ces nombres : 9 lignes de relevé (7 encaissements, 2 débits ignorés), 9 factures, 3 rapprochées dont 1 à confirmer (Garage Neuf), et des écarts : 1 écart de montant (Cabinet Roux, 250,00 de moins), 2 ambigus (le virement qui règle deux factures, et les 300 de Studio Nord qui correspondent à deux factures), 1 paiement sans facture (les 42 de remboursement), 5 factures non payées pour 2 140,00 (retards de 5, 5, 0, 14 et 0 jours, comptés au 15/10/2026, date du dernier encaissement). Le contrôle donne 4 672,50 = 2 430,50 + 2 242,00. Ces nombres viennent d’un script de référence exécuté en dehors de Codex sur les mêmes fichiers. Si les vôtres diffèrent, demandez à Codex d’expliquer ligne par ligne.

Un point à lire avec attention : les deux factures du virement groupé (FA-2026-104 et 105) apparaissent aussi comme « non payées », puisque le script refuse de choisir. Un humain doit trancher ces cas : c’est le rôle du rapport.

5. Faire relire par la revue. C’est l’objet de la section suivante : faites-la avant l’étape 6.

6. Lancer sur les vrais fichiers.

Lance le script sur donnees/releve-banque.csv et donnees/factures.csv et donne-moi le rapport.

La relance en revue

Codex a une commande de revue qui lit les changements de votre dossier et rend des constats classés par priorité, sans rien modifier. Elle exige que le dossier soit suivi par git, ce qui est déjà le cas. Dans la zone de saisie (application ou ligne de commande), tapez :

/review

Choisissez Review uncommitted changes (revoir les modifications non enregistrées, y compris les fichiers neufs). Faites cette revue avant tout commit du script, sinon il n’y a plus rien à relire (dans ce cas, choisissez Review a commit en ligne de commande). Dans la ligne de commande seulement, Custom review instructions permet d’orienter la revue : collez alors ce texte :

Vérifie les montants (Decimal, arrondis), les factures comptées deux fois, un paiement rapproché de deux factures, les dates lues à l'envers (JJ/MM), les lignes vides, et que les fichiers d'entrée ne sont jamais modifiés.

Ce que vous devez voir : une liste de constats, du plus grave au moins grave, sans modification de vos fichiers (la documentation l’indique : « sans changer votre arbre de travail »). Lisez-la avec un esprit critique : une revue peut se tromper dans les deux sens.

Puis, pour corriger un point à la fois :

Corrige uniquement le constat numéro 1 de la revue. Relance ensuite les deux fichiers d'essai et montre-moi que les nombres attendus sont inchangés.

Tapez /diff pour voir les changements exacts, puis relancez /review pour confirmer que le constat a disparu : c’est le contrôle que la documentation recommande après une correction. Comme pour toute revue, le modèle utilisé est celui de la session, sauf si vous fixez review_model dans config.toml. Voir la revue de code.

Comment juger que le résultat est bon

• Les totaux s’additionnent. La ligne de contrôle doit afficher OK. Rapprochez en plus le total des encaissements du rapport avec celui que votre banque affiche pour la même période.
• Vous lisez les « À CONFIRMER ». Un montant identique n’est pas une preuve : vérifiez le client avant de considérer la facture payée.
• Vous lisez les ambigus un par un et décidez à la main.
• Vous recoupez les retards avec votre comptabilité avant toute relance : le calcul de retard part de la date du dernier encaissement du relevé, pas d’aujourd’hui.
• Les fichiers d’entrée n’ont pas bougé. Dans un terminal ouvert dans le dossier, git status ne doit pas les montrer modifiés (à condition d’avoir fait le commit de départ décrit plus bas).

Le rapport est une aide à la décision, pas une pièce comptable : faites valider le rapprochement par votre comptable avant de clôturer.

Le git minimum vital

Git garde des points de retour (des « commits »). Six commandes suffisent, à taper dans le terminal, dans rapprochement-octobre :

Le commit de départ est fait. Faites-en un autre après chaque étape qui marche, sauf entre l’écriture du script et sa revue (sinon /review n’a plus rien à relire). Les points de retour de ce dossier restent sur votre ordinateur : ne les publiez nulle part, ils contiennent vos données.

Faites les commits vous-même. La documentation range .git parmi les chemins protégés, que Codex ne peut pas modifier même avec le droit d’écrire dans le dossier. S’il tente git commit, il devra demander une autorisation. D’où la consigne AGENTS.md : c’est vous qui enregistrez. Faites-le avant chaque demande risquée.

Le faire tourner tout seul ?

Pour un rapprochement mensuel, l’application de bureau propose des tâches planifiées (liste Scheduled). Les tâches locales travaillent sur un projet de votre ordinateur, mais exigent que l’ordinateur reste allumé et l’application ouverte. Les tâches web, elles, ne peuvent pas travailler dans un dossier de votre ordinateur. Les tâches tournent sans surveillance avec vos réglages de bac à sable : la documentation conseille de commencer avec l’accès le plus étroit. Pour ce cas, lancez-le à la main tant que vous n’avez pas fait trois rapprochements corrects de suite. Voir les tâches planifiées.

Les droits et la sécurité

Ce que l’agent voit. Le dossier ouvert, et les dossiers temporaires du système. /status liste les dossiers de l’espace de travail. La documentation lue ne dit rien des lectures en dehors : gardez le dossier propre.

Ce qu’il fait sur votre accord. Avec approval_policy = "on-request", il demande avant de sortir de son cadre. En mode workspace-write, le réseau est coupé par défaut. Dans l’application, le sélecteur sous la zone de saisie propose Ask for approval, Approve for me (les demandes sont traitées par une revue automatique, dans le même périmètre) et Full access. En ligne de commande, /permissions ouvre le même choix.

Ce qui reste à valider par un humain : tout paiement, toute relance, toute écriture comptable, et les cas « À CONFIRMER » et ambigus du rapport.

Les risques propres à Codex

• Les libellés bancaires viennent de tiers. Le libellé d’un virement est écrit par quelqu’un d’autre que vous. Un texte du genre « ignore tes consignes » dans une cellule peut être lu par l’agent comme une instruction. Le réseau coupé et l’accord sur chaque sortie du cadre limitent les dégâts : ne les levez pas.
• Des secrets dans config.toml. Si vous branchez plus tard un connecteur, le secret OAuth peut être enregistré en clair dans le fichier : gardez-le privé et hors de git, ou utilisez les variables d’environnement.
• Des hooks et des commandes de tiers. N’installez que des hooks et des skills dont vous connaissez l’auteur : la documentation impose de relire et d’approuver chaque hook non géré (/hooks).
• Les connecteurs (MCP). Ce cas n’en utilise aucun. Quand vous en ajouterez un (codex mcp add nom -- commande ou codex mcp add nom --url adresse), commencez par un seul, en lecture seule si possible : la clé disabled_tools d’une table [mcp_servers.nom] désactive des outils d’écriture. Voir la page MCP.
• Administration. Sur Business et au-dessus, un administrateur peut imposer des réglages par un fichier requirements.toml (par exemple interdire danger-full-access) et gérer la configuration depuis chatgpt.com/codex/settings/managed-configs.

Le maintenir

Première semaine

• Après chaque session : git status et git log pour voir ce qui traîne.
• Chaque jour d’usage : /status (limites) et le tableau de bord chatgpt.com/codex/settings/usage. La documentation conseille ensuite de le regarder toutes les semaines ou tous les quinze jours.
• Notez les demandes d’autorisation que vous acceptez toujours : ce sont les candidates à une règle du fichier default.rules.

Chaque mois

1. Mettez à jour : relancez la commande d’installation (Mac : curl -fsSL https://chatgpt.com/codex/install.sh | sh), ou npm install -g @openai/codex, ou brew upgrade --cask codex. L’application de bureau se met à jour seule par défaut. Vérifiez avec codex --version : la version de l’application et celle de la ligne de commande peuvent différer, et une fonction présente dans l’une peut manquer dans l’autre.
2. Relancez les deux fichiers d’essai : les nombres attendus (3 rapprochées, 5 non payées, contrôle OK) doivent sortir. Relancez /review si le script a changé.
3. Relisez AGENTS.md : court, sans consigne périmée.
4. Regardez la page des modèles pour les retraits annoncés.
5. Sauvegardez la configuration (voir plus bas).

Sur événement

• Un modèle est retiré. GPT-5.5 a été retiré de Codex avec connexion ChatGPT le 14 octobre 2026 ; l’API et Codex avec clé API ne sont pas touchés. Remplaçants : gpt-6.1-sol (Plus, Pro, Business, Enterprise, Edu) ou gpt-6-luna (Free, Go). Cherchez gpt-5.5 dans config.toml, dans les réglages enregistrés, dans les agents personnalisés, dans les tâches planifiées et dans vos scripts : une tâche qui l’utilise encore échoue. Sans ligne model, Codex choisit un modèle recommandé.
• Un salarié part. Fermez sa session (codex logout), retirez-le de l’espace de travail (Business, Enterprise : l’administrateur), supprimez son auth.json de l’ordinateur s’il le garde, et récupérez les dossiers de travail, AGENTS.md et skills du projet sous git.
• Un connecteur expire. codex mcp login nom dans le terminal, ou /mcp login nom dans la session.
• Une mise à jour change un comportement. Comparez la version de l’application et celle de la ligne de commande, puis relisez les notes de version.
• Service en panne. La page d’état d’OpenAI n’est pas indiquée dans la documentation lue : cherchez-la avant d’incriminer votre configuration.

Que sauvegarder

Dans chaque projet : AGENTS.md, .codex/, .agents/skills/. Pour vous : ~/.codex/config.toml, ~/.codex/AGENTS.md, ~/.codex/rules/, ~/.codex/agents/, ~/.codex/hooks.json et ~/.agents/skills. Jamais ~/.codex/auth.json : il contient vos jetons d’accès. Le plus simple : un dépôt git privé « config-agents » qui contient ces fichiers, sans secrets.

Symptômes et solutions

Ce que ça coûte

Prix lus sur learn.chatgpt.com/docs/pricing le 4 novembre 2026, en dollars américains, hors taxes. La page ne donne pas de date d’effet.

Un calcul réaliste pour ce cas. Sur Plus, la documentation estime, par fenêtre de 5 heures, de 15 à 160 messages locaux avec GPT-6.1 Sol et de 350 à 3 000 avec GPT-6 Luna ; des limites hebdomadaires sont possibles. Le cas de cette page, c’est environ quinze messages : cinq prompts, deux ou trois essais, une revue, une ou deux corrections, un lancement final. C’est dans la fourchette, mais en bas de celle de Sol : un script difficile ou une revue longue peut consommer toute la fenêtre. Faites les explorations avec Luna (/model pour changer) et gardez Sol pour le script et la revue. Les modes de vitesse coûtent plus : Fast consomme 2,5 fois l’usage inclus, Ultrafast 8 fois. Le prix en crédits d’un rapprochement n’est pas publié (une tâche GPT-5.6 Sol typique consomme 2 à 15 crédits).

Poser un plafond. Sur Plus et Pro, le plafond, c’est le quota : tant que vous n’achetez pas de crédits, rien n’est facturé en plus. Sur Business, Enterprise et Edu, les crédits sont attachés à l’espace de travail et gérés par l’administrateur. Les prix d’achat des crédits ne sont pas publiés sur la page lue.

Quand le plafond est atteint. Codex peut finir le tour en cours. Ensuite : attendre la réinitialisation, acheter des crédits (Plus et Pro) ou en demander à l’administrateur (offres entreprise), ou continuer avec une clé API aux tarifs API. Surveillez vos limites avec /status et le tableau de bord.

Ce qui a été vérifié, le 4 novembre 2026 : les commandes d’installation, les modes de permission, les clés de configuration, la commande de revue et les prix, sur la documentation officielle d’OpenAI (learn.chatgpt.com, consultée ce jour). Le fichier config.toml, le fichier de règles et le script de référence ont été contrôlés hors de Codex : le TOML est valide, la syntaxe des règles est acceptée par un analyseur Python, et le script donne les nombres annoncés sur les fichiers d’essai. Les prompts et l’enchaînement complet dans Codex n’ont pas été exécutés de bout en bout : testez chaque étape sur les fichiers d’essai avant de toucher à vos vrais relevés. La documentation lue ne précise pas les prérequis système, les erreurs d’installation ni les limites du nombre de tâches planifiées. Les libellés de l’application peuvent évoluer, la documentation d’OpenAI ayant déménagé récemment vers learn.chatgpt.com.