Comment faire travailler Claude Code et Codex ensemble sur un même projet?

Claude Code, d’Anthropic, et Codex, d’OpenAI, sont tous deux des agents de programmation : des outils qui lisent votre projet, modifient des fichiers et lancent eux-mêmes des commandes, comme des tests. Vous voudrez peut-être utiliser les deux, par exemple l’un pour une grosse restructuration du code et l’autre pour une série de petites corrections, ou simplement pour comparer leurs approches. Les faire travailler côte à côte sur le même projet fonctionne bien, mais seulement s’ils suivent les mêmes règles et ne modifient jamais les mêmes fichiers au même moment.

Trois éléments rendent cela possible : un seul fichier d’instructions que les deux agents lisent, un dossier de travail distinct pour chaque agent, et une répartition des tâches que vous décidez avant qu’ils commencent.

Étape 1 : un seul fichier d’instructions pour les deux agents

Chaque agent charge un fichier Markdown d’instructions de projet au début d’une session. Codex lit AGENTS.md; la documentation d’OpenAI indique qu’il lit ces fichiers avant tout travail, en combinant un fichier personnel dans ~/.codex avec les fichiers AGENTS.md trouvés de la racine du dépôt jusqu’au dossier où vous travaillez. Claude Code, lui, lit CLAUDE.md. La documentation d’Anthropic traite précisément de cette situation : si un dépôt contient déjà un AGENTS.md, créez un CLAUDE.md qui l’importe avec la ligne @AGENTS.md, pour que les deux outils chargent le même texte. Tout ce qui est propre à Claude peut aller sous l’importation.

Un AGENTS.md commun pour une petite boutique en ligne pourrait ressembler à ceci :

# AGENTS.md
## Project
Boutique en ligne : API Node.js dans api/, interface React dans web/.

## Rules for every agent
- Lancer `npm test` avant chaque commit. Ne jamais modifier ni supprimer des tests existants pour les faire réussir.
- Demander avant d'ajouter une nouvelle dépendance.
- Travailler seulement sur sa propre branche. Ne jamais fusionner dans main ni y pousser.
- Ne jamais modifier de fichiers hors des dossiers nommés dans la tâche.
- Écrire à la fin un résumé d'un paragraphe de ce qui a été changé.

Et le CLAUDE.md complet :

@AGENTS.md

## Claude Code only
Utiliser le mode plan avant de changer quoi que ce soit dans api/payments/.

Gardez le fichier commun court et concret. Anthropic suggère de rester sous environ 200 lignes et d’écrire des règles vérifiables (« Lancer npm test avant de faire un commit » plutôt que « teste tes modifications »), et prévient que lorsque deux règles se contredisent, l’agent peut choisir l’une ou l’autre. Codex limite par défaut l’ensemble des instructions à 32 Kio : la longueur compte donc là aussi.

Étape 2 : donner à chaque agent son propre worktree

Si les deux agents travaillent dans le même dossier, l’un peut écraser un fichier que l’autre est en train de modifier, ou lancer des tests sur une modification à moitié terminée. La solution est un worktree Git (arbre de travail) : un deuxième (ou troisième) dossier de travail relié au même dépôt, chacun avec sa propre branche et sa propre copie des fichiers, tout en partageant un seul historique. Le guide des bonnes pratiques d’Anthropic recommande les worktrees pour faire tourner plusieurs sessions de Claude à la fois, et la même approche fonctionne pour combiner des outils.

À partir du dossier principal du projet :

# Un dossier et une branche par agent
git worktree add ../shop-claude -b claude/checkout-form
git worktree add ../shop-codex  -b codex/order-history-api

# Onglet de terminal 1
cd ../shop-claude && claude

# Onglet de terminal 2
cd ../shop-codex && codex

Chaque agent voit maintenant un projet complet, travaille sur sa propre branche et ne peut pas toucher aux fichiers de l’autre. Quand une tâche est fusionnée, supprimez son dossier avec git worktree remove ../shop-claude.

Étape 3 : vérifier que les deux agents ont chargé les règles

Avant de confier du vrai travail, confirmez que le fichier commun est actif. Pour Codex, OpenAI décrit une vérification rapide : demandez-lui de résumer les instructions en vigueur, et il devrait citer votre AGENTS.md. Dans Claude Code, posez la même question au début d’une session. Si l’un des agents manque une règle, le fichier n’est pas au bon endroit ou la ligne d’importation est erronée, et il coûte bien moins cher de le découvrir maintenant.

Comment répartir le travail pour éviter qu’ils se marchent sur les pieds?

Répartissez par fichiers, pas par noms de fonctionnalités. Deux tâches qui semblent distinctes, comme « ajouter l’historique des commandes » et « corriger les totaux à la caisse », peuvent toucher le même module de calcul des prix. Avant de commencer, rédigez un court tableau qui nomme, pour chaque agent, les dossiers qu’il peut modifier :

Collez chaque ligne dans le premier message de l’agent concerné. Gardez les fichiers communs, comme la liste des dépendances (package.json), le schéma de la base de données ou les styles globaux, interdits aux deux, et modifiez-les vous-même dans une étape distincte. Ce sont ces fichiers qui causent la plupart des conflits, parce que tout en dépend.

Fusionnez une branche à la fois. Lancez la suite de tests complète sur la première branche, fusionnez-la dans main, puis mettez la deuxième branche à jour à partir de main et testez de nouveau avant de la fusionner. Si la deuxième fusion signale un conflit, c’est une information utile : la répartition se chevauchait. Résolvez-le à la main et resserrez le tableau la prochaine fois.

Enfin, révisez le travail des deux agents de la même façon, quel que soit l’outil qui l’a écrit. L’AGENTS.md commun fixe les mêmes attentes pour les deux, ce qui rend aussi leurs résultats faciles à comparer : quand l’un termine systématiquement un type de tâche avec moins de corrections, confiez-lui davantage de tâches de ce type.