Le plugin Codex d’OpenAI pour Claude Code

• Il est désormais possible d’appeler directement OpenAI Codex dans Claude Code pour effectuer des revues de code et déléguer des tâches
• Appel via des commandes slash comme /codex:review, /codex:adversarial-review
• La gestion des tâches en arrière-plan (/codex:rescue, /codex:status, /codex:result, /codex:cancel) permet de traiter de manière asynchrone les tâches longues
• Sans runtime séparé, le plugin réutilise tel quel le CLI Codex local et le serveur d’app Codex, en conservant le même environnement d’authentification, de configuration et de dépôt
• Utilisable avec un abonnement ChatGPT (y compris gratuit) ou simplement une clé API OpenAI (l’usage est comptabilisé dans les quotas d’utilisation de Codex)
• Plugin open source public publié sous licence Apache-2.0

Détail des fonctionnalités proposées (commandes slash)

• /codex:review : exécute une revue Codex générale en lecture seule sur le travail en cours
  • Revue possible des modifications non commit ou comparaison entre branches avec --base <ref>
  • Prend en charge les options --background et --wait, l’exécution en arrière-plan étant recommandée pour les changements sur plusieurs fichiers
  • Pas de texte de focalisation personnalisé, aucune modification du code n’est effectuée
• /codex:adversarial-review : exécute une revue orientable qui remet en question les choix d’implémentation et de conception
  • Met sous pression les hypothèses, compromis, modes de défaillance et approches alternatives
  • Peut se concentrer sur des zones de risque spécifiques comme l’authentification, la perte de données, le rollback, les race conditions ou la fiabilité
  • Accepte un texte de focalisation supplémentaire après la commande, sans modifier le code
• /codex:rescue : délègue une tâche à Codex via le sous-agent codex:codex-rescue
  • Permet d’enquêter sur un bug, de tenter un correctif, de reprendre une tâche Codex précédente ou d’exécuter un passage rapide avec un petit modèle
  • Prend en charge les options --background, --wait, --resume, --fresh
  • Si --model et --effort ne sont pas spécifiés, Codex choisit lui-même ses valeurs par défaut
  • La saisie de spark est automatiquement mappée vers gpt-5.3-codex-spark
  • Une demande de délégation en langage naturel est aussi possible (ex. : "Ask Codex to redesign...")
• /codex:status : affiche l’état des tâches Codex en cours d’exécution ou récentes dans le dépôt actuel
• /codex:result : affiche la sortie finale d’une tâche terminée ; avec un identifiant de session Codex, reprise directe possible via codex resume <session-id>
• /codex:cancel : annule une tâche Codex active en arrière-plan
• /codex:setup : vérifie l’installation de Codex et l’état de l’authentification ; si Codex n’est pas installé, propose une installation via npm

Fonction de Review Gate

• S’active avec /codex:setup --enable-review-gate
• Une fois activée, elle utilise un hook Stop qui exécute automatiquement une revue Codex ciblée à partir de la réponse de Claude
• Si la revue détecte un problème, l’arrêt est bloqué afin que Claude le corrige d’abord
• Attention : cela peut créer une boucle longue Claude/Codex et épuiser rapidement les quotas d’utilisation ; activation recommandée uniquement si la session est activement surveillée

Flux d’usage général

• Revue avant mise en production : exécuter simplement /codex:review
• Déléguer un problème à Codex : /codex:rescue investigate why the build is failing in CI
• Lancer une tâche longue puis vérifier : exécuter avec --background → /codex:status → /codex:result

Architecture d’intégration de Codex

• Le plugin encapsule le serveur d’app Codex et utilise le binaire global codex installé dans l’environnement
• Sans runtime séparé, il partage la même installation Codex, la même authentification, le même dépôt et le même environnement local
• Le modèle par défaut et l’effort de raisonnement peuvent être configurés via ~/.codex/config.toml (niveau utilisateur) ou .codex/config.toml (niveau projet)
  • Exemple : model = "gpt-5.4-mini", model_reasoning_effort = "xhigh"
  • La configuration au niveau projet ne s’applique que si le projet est dans un état de confiance (trusted)
• Les tâches déléguées terminées peuvent être reprises directement dans Codex avec codex resume <session-id>

Authentification et compte

• Si Codex est déjà connecté sur cette machine, l’utilisation est immédiate sans configuration supplémentaire
• Les personnes n’ayant pas encore utilisé Codex doivent exécuter !codex login avec un compte ChatGPT ou une clé API
• Les paramètres existants de clé API et de base URL sont conservés ; en cas d’utilisation d’un autre endpoint, openai_base_url peut être défini dans la configuration Codex