Guide de développement collaboratif Claude Code et Codex

Pourquoi les associer ainsi ?

En une phrase : laissez le modèle cher réfléchir, laissez le modèle moins cher exécuter, et évitez que la facture explose.

Claude est très bon pour comprendre les besoins, planifier l'architecture et raisonner sur des problèmes complexes, mais son prix est aussi bien réel : l'utiliser pour écrire beaucoup de code brûle les Tokens très vite. Codex a de solides capacités de code, il est rapide, et surtout beaucoup moins cher.

La combinaison la plus raisonnable est donc :

• Claude planifie : comprendre votre besoin, découper la tâche, prendre les décisions d'architecture et clarifier la méthode
• Codex exécute : prendre en charge les tâches de codage concrètes via /codex:rescue, écrire le code, corriger les bugs et lancer les tests
• Codex relit : effectuer une code review du code de Claude via /codex:review, comme une deuxième paire d'yeux

La logique centrale est la suivante : les Tokens de Claude ne sont dépensés que pour « réfléchir clairement », tandis que le codage et la relecture concrets sont confiés à Codex, moins cher. Pour les personnes qui utilisent Claude Code intensivement tous les jours, cela peut réduire nettement le coût global.

Ce guide suppose que l'installation et la configuration de Claude Code et Codex sont déjà terminées. Sinon, consultez d'abord :

• Configuration Claude Code : Guide de démarrage rapide yycode
• Configuration Codex : Guide de démarrage rapide yycode × Codex

1. Installer le plugin Codex

Une fois les deux côtés configurés, installez un plugin dans Claude Code pour les relier :

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

/codex:setup détecte automatiquement si Codex est installé et authentifié. Si une connexion est demandée, exécutez !codex login pour terminer l'authentification.

Après l'installation, saisissez /codex pour voir les nouvelles commandes slash.

2. Commandes principales

Ce plugin a trois familles de capacités : revue, délégation de tâches et gestion de tâches.

Revue (lecture seule, ne modifie pas le code)

# Relire les modifications non commit
/codex:review

# Relire la différence entre la branche courante et main
/codex:review --base main

# Exécuter en arrière-plan sans bloquer la conversation actuelle
/codex:review --background

# Revue contradictoire, avec axe d'attention
/codex:adversarial-review --background vérifier s'il existe des conditions de course et remettre en question le choix de la stratégie de cache

Délégation (confier une tâche à Codex)

C'est la commande centrale pour réaliser « Claude planifie, Codex exécute ». Vous pouvez confier à Codex les tâches planifiées par Claude, une par une :

# Demander à Codex d'enquêter sur un bug
/codex:rescue investigate why the tests started failing

# Demander à Codex de corriger un bug
/codex:rescue fix the failing test with the smallest safe patch

# Demander à Codex d'implémenter une fonctionnalité
/codex:rescue implémenter la logique de validation du formulaire d'inscription utilisateur

# Exécution en arrière-plan, adaptée aux tâches longues
/codex:rescue --background refactoriser le pool de connexions à la base de données

# Choisir un modèle moins cher pour économiser davantage
/codex:rescue --model gpt-5.4-mini écrire une suite de tests unitaires couvrant utils.ts
/codex:rescue --model spark corriger rapidement cette erreur lint

# Reprendre la tâche précédente
/codex:rescue --resume appliquer la correction proposée lors de la tâche précédente

💡 Astuce d'économie : --model gpt-5.4-mini ou --model spark permet d'exécuter les tâches simples avec un modèle moins cher et plus rapide.

Gestion de tâches

3. Flux recommandé : Claude planifie, Codex exécute

Flux quotidien de développement

Vous exprimez le besoin → Claude analyse et découpe → /codex:rescue exécute étape par étape → /codex:review relit → commit

1. Décrivez le besoin en langage naturel pour que Claude comprenne ce que vous voulez
2. Claude planifie : découpage, choix de solution, ordre d'exécution ; c'est ce que Claude fait le mieux
3. Confiez les tâches de codage à Codex avec /codex:rescue : quand Claude a planifié « faire A, B, C », utilisez rescue pour les donner à Codex une par une
4. Relisez après écriture : /codex:review --background, pour une revue indépendante par Codex
5. Corrigez selon les avis de revue, puis committez

L'avantage est que les Tokens de Claude servent seulement à la planification et à la compréhension, tandis que le gros du codage passe par le quota moins cher de Codex.

Flux pour modifications à haut risque

Pour les migrations de base de données, l'authentification/autorisation ou les changements d'infrastructure, ajoutez une couche de revue contradictoire :

Claude planifie → /codex:rescue exécute → /codex:review → correction → /codex:adversarial-review → nouvelle correction → commit

La revue contradictoire questionne activement la conception : « pourquoi ce choix de cache ? », « le plan de rollback est-il prévu ? », « y a-t-il une condition de course ? ». Les modifications à haut risque méritent ce test de pression.

Quand Claude bloque

Si Claude tente plusieurs fois une tâche sans résultat satisfaisant, essayez directement avec Codex :

/codex:rescue corriger ce problème avec le plus petit changement possible

Changer de modèle permet souvent de débloquer une impasse.

4. Exécution en arrière-plan (recommandé)

Il est conseillé d'ajouter --background aux tâches de revue et de rescue afin de ne pas bloquer la conversation :

/codex:rescue --background implémenter la pagination
# Continuez à discuter d'autre chose avec Claude...
/codex:status          # Voir la progression à tout moment
/codex:result          # Récupérer le résultat une fois terminé

/codex:result renvoie un session ID ; vous pouvez utiliser codex resume <session-id> dans Codex pour continuer cette tâche.

5. Barrière de revue (facultatif)

Après activation, Claude Code déclenche automatiquement une revue Codex avant de terminer une tâche. Si un problème est trouvé, le flux est interrompu pour corriger d'abord :

/codex:setup --enable-review-gate    # Activer
/codex:setup --disable-review-gate   # Désactiver

⚠️ Attention : la barrière de revue augmente nettement la consommation de Tokens et peut créer de longues boucles entre Claude et Codex. Il est recommandé de l'utiliser seulement sur les projets critiques ; au quotidien, lancez manuellement /codex:review.

6. Configuration du modèle Codex

Pour changer le modèle par défaut de Codex ou son effort de raisonnement, configurez le fichier de configuration.

Configuration utilisateur : ~/.codex/config.toml
Configuration projet : .codex/config.toml à la racine du projet

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

Vous pouvez aussi spécifier temporairement --model et --effort à chaque appel :

/codex:rescue --model spark --effort medium corriger rapidement une erreur lint

7. Quand ne pas utiliser Codex

Dans les cas suivants, il est recommandé d'utiliser Claude de bout en bout :

8. Conseils pratiques

• Utilisez un modèle moins cher pour les tâches simples : --model spark convient aux corrections lint, au code boilerplate et aux tâches sans raisonnement profond
• Review avant adversarial-review : ne commencez pas par une revue contradictoire ; faites d'abord une revue normale pour les problèmes de base
• Utilisez --resume : /codex:rescue --resume permet de continuer la dernière tâche Codex sans repartir de zéro
• Surveillez les usages des deux côtés : même si l'ensemble coûte moins cher, suivez les consommations Claude et OpenAI pour éviter un dépassement inattendu d'un côté
• Gestion des conflits de Skill : si votre Skill personnalisé entre en conflit avec un mot déclencheur du plugin Codex, ajoutez priority: low dans ce Skill

Questions fréquentes

Q : après installation du plugin, je ne vois pas la commande /codex ?
A : exécutez /reload-plugins pour recharger les plugins.

Q : /codex:review renvoie une erreur d'authentification ?
A : cela signifie que l'authentification Codex n'est pas configurée correctement. Consultez le Guide de démarrage rapide yycode × Codex pour reconfigurer, ou exécutez !codex login pour vous reconnecter.

Q : quelle différence entre /codex:rescue et demander directement à Claude d'écrire le code ?
A : rescue confie la tâche à Codex pour une exécution indépendante. Cela consomme le quota OpenAI, pas les Tokens Claude. C'est adapté aux tâches de codage standardisées. Mais Codex n'a pas le contexte de votre conversation avec Claude ; la description de tâche doit donc être claire.

Q : que faire si le résultat de revue contredit le jugement de Claude ?
A : c'est précisément la valeur d'une collaboration à deux modèles. En cas de désaccord, vous prenez la décision finale en tant que développeur.

Q : combien peut-on économiser ?
A : cela dépend de la part de codage confiée à Codex. Si votre flux contient beaucoup de génération de code (par exemple tests ou CRUD), déléguer ces tâches via rescue peut réduire fortement la consommation de Claude.