Claude Code et Codex peuvent travailler sur le même code, et trois montages existent pour les réunir.
Le premier est un fichier d'instructions commun : un AGENTS.md que les deux agents lisent au démarrage. Le deuxième est le plugin Codex officiel d'OpenAI, qui ajoute à Claude Code des commandes de relecture et de délégation. Le troisième est counterpoint, un outil open source qui fait relire par Codex chaque tâche de Claude, avec un test exécutable pour chaque bug grave.
Commencez par l'AGENTS.md dans tout dépôt où passent les deux outils. Prenez le plugin pour une relecture ponctuelle avant un commit, et installez counterpoint si chaque tâche doit passer par un second modèle. Les trois montages tournent sur vos abonnements Claude et ChatGPT, sans clé d'API OpenAI à payer au jeton.
Pourquoi faire travailler Claude Code et Codex ensemble
Les comparatifs « Claude Code ou Codex » occupent presque toute la première page de Google sur le sujet. Ils posent mal la question pour une équipe qui paie déjà les deux abonnements : l'intérêt est de faire relire le travail de l'un par l'autre.
Deux labos, deux types d'erreurs
Un modèle qui relit son propre travail garde ses angles morts. Il a écrit le code avec les mêmes poids que ceux qui le relisent, donc il passe à côté des mêmes erreurs. Un modèle entraîné par un autre labo se trompe ailleurs, et il voit ce que le premier rate.
Une étude publiée en juillet 2026 précise ce gain, et son sens compte. Zuodong Xiang et trois coauteurs ont mesuré la relecture croisée entre Claude et Codex sur 116 tâches de code de niveau moyen et difficile :
- Claude qui relit les brouillons de Codex fait passer le taux de réussite de 71,6 % à 89,7 %.
- Codex qui relit ses propres brouillons les monte à 84,5 %.
- Codex qui relit les brouillons de Claude fait baisser le taux de 91,4 % à 82,8 %.
- Claude qui relit son propre travail laisse le taux à 91,4 %.
Dans cette étude, le relecteur voyait le problème et le brouillon, sans pouvoir lancer de tests. Ses conseils s'appliquaient tels quels. Une critique non vérifiée peut donc dégrader un code correct. Le bon montage fait vérifier chaque remarque de Codex avant de la suivre, et c'est le principe de counterpoint.
Le prix de la collaboration : deux abonnements et du temps
Faire travailler les deux agents demande un compte Claude pour Claude Code et un compte ChatGPT pour Codex. Le plugin officiel accepte aussi le plan ChatGPT Free ou une clé d'API OpenAI, et chaque appel compte dans vos limites d'usage Codex. Le coût réel se mesure en minutes : une relecture de Codex dure de quelques dizaines de secondes à plusieurs minutes selon la taille du changement.
Quand un seul agent suffit
Une question, une explication de code ou un renommage de variable ne justifient pas un second avis. Gardez la relecture croisée pour les changements qui coûtent cher en cas d'erreur : une migration de données, une authentification, un calcul de facturation, un script qui tourne en production sans surveillance.
Un seul AGENTS.md pour Claude Code et Codex
Les deux agents lisent un fichier d'instructions au début de chaque session. Si vos consignes vivent dans deux fichiers différents, l'un des deux finit par dériver, et Codex relit le code de Claude sans connaître les règles que Claude a suivies.
Comment Codex lit AGENTS.md
Codex lit d'abord ~/.codex/AGENTS.md pour vos consignes globales, puis chaque AGENTS.md de la racine du dépôt jusqu'au dossier courant. Les fichiers les plus proches du dossier courant passent en dernier, donc leurs consignes l'emportent. Codex s'arrête à 32 Kio de consignes cumulées par défaut (réglage project_doc_max_bytes).
Pour qu'il lise aussi un CLAUDE.md, ajoutez ce nom à la liste de repli dans ~/.codex/config.toml :
project_doc_fallback_filenames = ["CLAUDE.md"]
Codex lit un seul fichier par dossier : un AGENTS.md présent passe avant le CLAUDE.md du même dossier.
Comment Claude Code lit AGENTS.md
Depuis la version 2.1.277, Claude Code lit un AGENTS.md directement quand le dépôt n'a pas de CLAUDE.md, selon la documentation mémoire de Claude Code. Un dépôt déjà préparé pour Codex marche donc tel quel. En session interactive, Claude Code affiche une ligne du type no CLAUDE.md found; AGENTS.md loaded.
Si le dépôt contient aussi un CLAUDE.md ou un CLAUDE.local.md, Claude Code ne lit que ceux-là par défaut. Le réglage Project instructions de /config change ce comportement : la valeur claude-md-and-agents-md charge les deux familles de fichiers.
Un dépôt avec un CLAUDE.md : l'import @AGENTS.md
Gardez AGENTS.md comme source unique et réduisez CLAUDE.md à un import, suivi des consignes propres à Claude :
@AGENTS.md
## Claude Code
Utilise le mode plan pour toute modification sous src/billing/.
Sans consigne propre à Claude, un lien symbolique suffit : ln -s AGENTS.md CLAUDE.md. Ce fichier commun sert aussi de base aux deux autres montages, puisque Codex relit le travail de Claude d'après les mêmes règles. Pour aller plus loin, lisez notre guide des skills Claude Code et notre méthode pour faire d'AGENTS.md l'index d'un second cerveau IA.
Appeler Codex à la main avec codex exec
Avant d'installer quoi que ce soit, Claude Code peut déjà lancer Codex comme n'importe quelle commande du terminal. codex exec exécute une tâche sans interface et renvoie la réponse finale sur la sortie standard.
Une passe de relecture en lecture seule
Par défaut, codex exec tourne dans un bac à sable en lecture seule : Codex lit les fichiers et ne peut rien modifier. Pour une relecture, gardez ce réglage. L'option --sandbox workspace-write autorise les modifications quand vous déléguez une correction.
Demandez par exemple à Claude :
Lance codex exec pour relire le diff de la branche en cours contre main,
écris sa réponse dans review.md, puis vérifie chaque remarque avant de corriger.
Codex dispose aussi d'une commande dédiée, codex review, qui relit un changement sans interface.
Le prompt en stdin, la réponse dans un fichier
Passez les longues consignes à Codex par l'entrée standard plutôt qu'en argument : codex exec - < consigne.md. Un prompt de plusieurs centaines de lignes dépasse vite la taille maximale d'une ligne de commande. L'option -o review.md (--output-last-message) écrit la réponse finale dans un fichier que Claude relit ensuite. L'option --json sort chaque étape de Codex en JSON Lines, utile pour un script.
La limite : le contexte à recopier
Avec codex exec, Codex sait seulement ce que vous lui passez. S'il relit un diff sans la demande d'origine ni les consignes du projet, il juge le code sur son propre goût et propose des changements hors sujet. Donnez-lui à chaque appel la demande telle que vous l'avez écrite, l'AGENTS.md et le diff. Les deux montages suivants font ce travail pour vous.
Le plugin Codex officiel pour Claude Code
OpenAI a publié le 30 mars 2026 codex-plugin-cc, un plugin qui appelle Codex depuis une session Claude Code. Le dépôt, sous licence Apache 2.0, dépasse 34 000 étoiles sur GitHub début novembre 2026. Le plugin passe par le Codex CLI installé sur votre machine : il reprend votre connexion, votre configuration et vos serveurs MCP Codex.
Installer le plugin en quatre commandes
Le plugin demande Node.js 18.18 ou plus récent. Dans Claude Code, tapez :
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
/codex:setup vérifie l'installation et la connexion de Codex, et propose de l'installer avec npm s'il manque. Si vous avez installé Codex sans vous connecter, lancez !codex login depuis Claude Code.
/codex:review et /codex:adversarial-review
D'après le README du plugin, /codex:review lance la même relecture que /review dans Codex, sur vos changements non commités ou sur une branche avec --base main. Cette relecture n'accepte pas de consigne : elle cherche les défauts en général.
/codex:adversarial-review accepte un texte libre après les options, pour viser un risque précis :
/codex:adversarial-review --base main vérifie les accès concurrents sur la file d'attente et conteste le choix des nouvelles tentatives
Les deux commandes restent en lecture seule. Sur un changement de plusieurs fichiers, ajoutez --background, puis suivez avec /codex:status et /codex:result.
/codex:rescue et /codex:transfer pour déléguer
/codex:rescue confie une tâche à Codex via un sous-agent, codex:codex-rescue, visible dans /agents. Servez-vous-en pour un bug que Claude n'arrive pas à cerner, un test qui échoue au hasard, ou une passe rapide avec un modèle plus léger (--model gpt-5.4-mini --effort medium). L'option --resume reprend la dernière tâche confiée à Codex dans le dépôt.
/codex:transfer crée un fil Codex à partir de la session Claude Code en cours et affiche une commande codex resume <id>. Vous poursuivez la même conversation dans Codex, avec l'historique.
La review gate et son hook Stop
/codex:setup --enable-review-gate ajoute un hook Stop. À la fin de chaque réponse de Claude, Codex lance une relecture ciblée, et Claude doit traiter les problèmes trouvés avant de rendre la main. Le README prévient que cette boucle peut tourner longtemps et vider vite vos limites d'usage. Activez-la seulement pendant une session que vous suivez. Notre article sur les hooks Claude Code détaille leur fonctionnement.
counterpoint : la relecture croisée automatique
counterpoint est un skill Claude Code open source, sous licence MIT, qui fait passer chaque tâche par Claude puis par Codex. La version 3.0, publiée le 3 novembre 2026, part du résultat de l'étude citée plus haut : Codex relit, mais Claude vérifie chaque remarque avant d'y toucher.
Claude écrit, Codex relit, Claude tranche
En mode small, celui par défaut, Claude fait la tâche comme d'habitude. Codex relit le travail en arrière-plan pendant que Claude lance ses propres tests. Chaque problème soulevé arrive avec un emplacement précis, une preuve et une correction proposée. Claude vérifie chaque remarque contre le code et les tests, puis l'applique ou la rejette avec une raison. Le tour se termine sur une ligne de décision par remarque :
F1 applied (bug test now passes)
F2 rejected: the cited input is rejected earlier by parse_args (line 40)
Lancez-le avec /counterpoint suivi de la tâche : /counterpoint corrige la lecture du timeout dans config.sh.
Un test pour chaque bug grave
Pour les problèmes graves sur du code exécutable, Codex écrit un petit test qui échoue tant que le bug existe. counterpoint lance ce test en quelques secondes sur une copie du projet. Le résultat REPRODUCED prouve le bug. NOT reproduced signale une fausse alerte probable, ou un test mal écrit. Après la correction, counterpoint verify relance les tests, et le tour ne peut pas se clore tant qu'un bug prouvé garde un test en échec.
L'étude citée plus haut privait son relecteur de tests. counterpoint corrige ce point : une remarque de Codex devient un fait vérifié ou une fausse alerte, au lieu d'un avis à croire sur parole.
Mode small et mode full
Le dépôt publie ses temps, mesurés avec Codex le 3 novembre 2026 :
| Mode | Déroulé | Temps mesuré |
|---|---|---|
| small, tests de bug coupés | Claude produit, Codex relit | 22 à 31 s |
| small, tests de bug actifs | idem, 3 bugs trouvés et 3 tests écrits | 40 à 47 s |
| full | deux plans, deux juges, production, relecture, contre-vérification | 349 s sur une tâche complète |
En mode full (/counterpoint full <tâche>), Claude et Codex écrivent chacun un plan sans voir celui de l'autre.
Deux juges notent les deux plans à l'aveugle sur cinq critères : Codex, et une session Claude neuve sans outils ni souvenir des plans. Les plans arrivent sous les noms A et B, dans un ordre tiré au hasard.
Si le plan de Codex mène de 2 points par juge, Codex écrit et Claude relit, le sens que l'étude trouve le plus utile. Sinon, Claude écrit et Codex relit avec ses tests de bug. Codex contre-vérifie enfin les corrections dans son fil de relecture.
Réservez le mode full aux travaux où une mauvaise approche coûte cher : une architecture, un long document, une refonte en plusieurs étapes.
La parité de contexte
counterpoint donne à Codex la demande d'origine mot pour mot, les fichiers de contraintes (--context AGENTS.md, le skill, la spécification) et le travail à relire. Un relecteur qui n'a jamais lu une contrainte ne peut pas la vérifier. C'est le défaut de la relecture faite à la main avec codex exec, et counterpoint le règle à chaque appel.
La mémoire des fausses alertes
Chaque remarque rejetée reste en mémoire pour le projet, hors du dépôt, dans ~/.counterpoint/projects/. Les relectures suivantes reçoivent les rejets récents, et Codex arrête de soulever les mêmes faux problèmes. counterpoint stats montre la part de remarques retenues par catégorie, et counterpoint forget vide l'historique.
Installer counterpoint
Il vous faut Claude Code et le Codex CLI connecté à votre compte ChatGPT (npm i -g @openai/codex, puis codex login). Ensuite :
git clone https://github.com/tns-research/counterpoint
mkdir -p ~/.claude/skills
ln -s "$PWD/counterpoint/skills/counterpoint" ~/.claude/skills/counterpoint
counterpoint/skills/counterpoint/bin/counterpoint doctor
doctor vérifie l'installation. Pour passer chaque tour par counterpoint sans taper la commande, déclarez les deux hooks du dépôt (hooks/prompt.sh et hooks/stop.sh) dans ~/.claude/settings.json, puis choisissez counterpoint mode small, full ou off. Le hook Stop refuse une première fois la fin d'un tour ni relu ni écarté avec counterpoint skip. La deuxième tentative passe et s'inscrit dans ~/.counterpoint/escapes.log, pour qu'une session ne reste jamais bloquée.
Côté sécurité, Codex démarre avec un environnement vide : vos clés exportées ne lui parviennent pas, sauf celles que vous listez. Il tourne avec --ignore-user-config, donc sans vos serveurs MCP. La relecture, le plan et la contre-vérification restent en lecture seule, et les tests de bug tournent dans une copie jetable du projet avec une limite de 30 secondes. counterpoint marche sous Linux et macOS, Mac d'origine compris.
Plugin officiel ou counterpoint : le tableau de choix
| Critère | codex exec | Plugin Codex officiel | counterpoint |
|---|---|---|---|
| Déclenchement | à la main, par Claude | une commande /codex:... |
/counterpoint ou chaque tour avec les hooks |
| Contexte donné à Codex | ce que vous recopiez | votre arbre de travail ou une branche | demande, contraintes et travail, à chaque appel |
| Vérification des remarques | à faire vous-même | à faire vous-même | Claude vérifie chaque remarque, tests de bug à l'appui |
| Délégation à Codex | --sandbox workspace-write |
/codex:rescue, /codex:transfer |
en mode full, si le plan de Codex gagne |
| Garde-fou de fin de tour | aucun | review gate (hook Stop), optionnelle | hook Stop, et le tour ne se clôt pas sans décision |
| Durée ajoutée | variable | de quelques secondes à plusieurs minutes | 22 à 47 s en small, environ 6 min en full |
Prenez le plugin pour une relecture avant commit ou pour passer une tâche bloquée à Codex. Prenez counterpoint pour que chaque tâche sensible passe par les deux modèles, avec une décision écrite pour chaque remarque. Les deux cohabitent dans la même installation de Claude Code.
Cinq erreurs fréquentes
Appliquer une critique de Codex sans la vérifier. L'étude sur 116 tâches montre une baisse de 91,4 % à 82,8 % quand Codex relit Claude et que ses conseils passent tels quels. Lisez la ligne citée, lancez l'entrée qui pose problème, puis décidez.
Laisser la review gate tourner sans surveillance. La boucle entre Claude et Codex peut durer et consommer vos limites des deux côtés. Coupez-la avec /codex:setup --disable-review-gate quand vous quittez la session.
Relire sans le contexte. Une relecture sans la demande ni l'AGENTS.md produit des remarques de goût et passe à côté des contraintes écrites du projet. Passez toujours les deux.
Garder deux fichiers de consignes. Un CLAUDE.md et un AGENTS.md écrits à part finissent par se contredire. Faites de l'un un import ou un lien vers l'autre.
Lancer Codex dans un conteneur sans vérifier son bac à sable. Dans certains conteneurs, le bac à sable de Codex ne démarre pas. Codex lit alors les fichiers et renvoie un rapport « bloqué », sans code d'erreur. Lisez la sortie, pas seulement le code de retour. counterpoint teste le bac à sable avant d'écrire et refuse d'écrire hors bac à sable sans l'option --allow-bypass.
Le guide Claude Code couvre les bases de l'agent d'Anthropic, et notre article sur ChatGPT Work explique comment Work et Codex partagent le même moteur et les mêmes crédits.
Deux agents qui relisent le travail de l'autre attrapent plus d'erreurs qu'un seul, à condition qu'un des deux vérifie chaque remarque avant d'y toucher.
FAQ
Peut-on utiliser Codex dans Claude Code ?
Oui. Le plugin officiel codex-plugin-cc d'OpenAI ajoute à Claude Code des commandes de relecture (/codex:review, /codex:adversarial-review) et de délégation (/codex:rescue, /codex:transfer). Claude Code peut aussi lancer codex exec comme n'importe quelle commande, et counterpoint fait relire chaque tâche par Codex automatiquement.
Faut-il une clé API OpenAI ?
Non. Le plugin et counterpoint passent par le Codex CLI connecté à votre compte ChatGPT avec codex login, et l'usage compte dans les limites de votre abonnement. Le plugin accepte aussi une clé d'API si vous préférez payer au jeton.
Codex peut-il lire le CLAUDE.md de Claude Code ?
Oui, si vous ajoutez project_doc_fallback_filenames = ["CLAUDE.md"] dans ~/.codex/config.toml. Codex lit alors le CLAUDE.md d'un dossier quand ce dossier n'a pas d'AGENTS.md. Le plus simple reste un AGENTS.md unique que les deux agents lisent, avec un CLAUDE.md qui l'importe via @AGENTS.md.
Codex peut-il utiliser les plugins de Claude Code ?
Pas directement : chaque outil a son propre système de plugins. Le sens inverse existe pourtant. Le plugin open source cc-plugin-codex de Sendbird s'installe dans Codex et appelle Claude Code pour relire ou reprendre une tâche, avec des commandes comme $cc:review et $cc:rescue.
Faut-il choisir entre Claude Code et Codex ?
Non, si vous payez déjà les deux abonnements. D'après l'étude de juillet 2026 sur 116 tâches, la relecture de Codex par Claude fait passer la réussite de 71,6 % à 89,7 %. Gardez un agent principal pour écrire et l'autre pour relire, avec une vérification de chaque remarque.
