Un agent termine un correctif pendant la nuit. Le terminal annonce la fin, mais la branche doit encore être examinée. Nous voulons un second regard sur le diff réel, pas un nouveau résumé des intentions de son auteur.
Codex Code Review fournit une étape d’inspection ciblée dans le dépôt. Sur un VPS, la question utile n’est pas seulement « la revue a-t-elle eu lieu ? », mais « quels fichiers et quelle révision a-t-elle inspectés, et qui autorise leur publication ? ». Ce guide décrit un processus manuel avec Codex CLI, pas une fonction de fusion automatique d’Office Claws.
Codex Code Review : choisir le bon diff
La présentation de la CLI d’OpenAI décrit des revues dédiées aux modifications non validées, à un commit ou aux changements par rapport à une branche de base. Son guide de revue distingue la revue d’une copie de travail de celle d’une pull request. Nous utilisons notre propre copie sur le serveur d’exécution.
| Cible | Commande CLI | Usage adapté | Piège courant |
|---|---|---|---|
| Arbre de travail | codex review --uncommitted | Inspecter avant le commit | Un autre processus modifie encore les fichiers |
| Branche | codex review --base origin/main | Comparer une fonctionnalité à l’intégration | La référence distante n’est pas à jour |
| Un commit | codex review --commit <SHA> | Examiner un changement identifié | Confondre un commit avec toute la fonctionnalité |
Les définitions actuelles des arguments rendent ces cibles mutuellement exclusives. Elles interdisent aussi un prompt personnalisé positionnel avec ces sélecteurs. Consultez l’aide de la version installée plutôt que de combiner des options d’exemples différents. La cible non validée inclut les modifications indexées, non indexées et les fichiers non suivis ; recherchez les secrets avant de transmettre le contexte du dépôt au modèle.
Lancez votre premier agent en 3 minutes environ
Installez la CLI Office Claws, connectez votre compte Contabo et votre abonnement Codex : votre agent obtient son propre VPS et un bureau dans l'office.
curl -fsSL https://officeclaws.com/downloads/install.sh | sh4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau
Figer la livraison avant la revue
Nous terminons les modifications de l’agent constructeur et créons le commit prévu avant la revue de branche. Nous arrêtons les autres processus qui écrivent dans cette copie. Adaptez le chemin et la branche de base ; fetch actualise les références Git sans fusionner dans votre branche.
cd ~/work/product-api
codex --version
codex review --help
git fetch origin
git status --short
git rev-parse HEAD
git rev-parse origin/main
git diff --stat origin/main...HEAD
codex review --base origin/mainConservez les deux identifiants de commit affichés avec les résultats et la version de Codex. Le diff à trois points donne un aperçu des modifications depuis l’ancêtre commun, sans garantir que chaque implémentation de revue utilise exactement le même contexte interne. Si le diff est vide ou contient des travaux étrangers, corrigez la livraison avant de lancer une revue.
Avec plusieurs constructeurs, utilisez une copie ou un worktree séparé pour le candidat. Un worktree isole les fichiers, pas les identifiants Unix ni le réseau. Ne révisez pas une cible mouvante pendant qu’un autre processus rebase ou change de branche. Notre guide des processus parallèles traite des limites des tâches ; cette étape fixe l’identité du résultat inspecté.
Après une correction, les anciens résultats décrivent toujours l’ancien état. Relancez les tests pertinents et examinez le candidat actualisé. Si la branche d’intégration a changé, vérifiez aussi sa nouvelle relation avec la base : une ancienne revue sans problème ne prouve rien sur une fusion ultérieure.
Transformer les résultats en preuves, pas en feu vert
Une revue terminée n’est pas une approbation. Son code de sortie ne compte pas les défauts, et « aucun problème détecté » ne prouve pas la sûreté. Nous confrontons chaque alerte au code cité et au comportement attendu.
Pour chaque problème exploitable, conservez l’entrée déclenchante, le fichier et la ligne, le comportement attendu et observé, et si possible un test de régression. Si le défaut n’est pas reproductible, documentez pourquoi au lieu d’appliquer une réécriture spéculative. Gardez visibles les limites dues à des dépendances ou services inaccessibles.
Exécutez séparément les vérifications réelles du projet. Une bonne livraison comprend les identifiants du candidat et de la base examinés, les commandes et résultats des tests, les problèmes non résolus et la décision humaine de fusion. Authentification, migrations de schéma et gestion des identifiants méritent une attention particulière, même sans alerte de l’agent.
OpenAI décrit la revue dédiée comme une production de résultats sans modifier l’arbre de travail. Demander à l’agent d’appliquer les corrections constitue une autre étape d’édition. Cette distinction n’est pas une barrière du système d’exploitation : gardez des réglages d’isolation et d’approbation adaptés et n’ajoutez pas d’identifiants de déploiement en production au serveur uniquement pour examiner un diff.
Séparer revue et déploiement sur le VPS
Office Claws exécute des agents fondés sur Codex sur une infrastructure VPS que vous contrôlez et fournit la couche d’exploitation bureau/CLI. Il ne transforme pas ces commandes en moteur de politique garanti ni en approbation automatique de PR. Utilisez SSH pour inspecter la copie et gardez les journaux accessibles à l’opérateur.
Une seconde revue utilise elle aussi l’accès au modèle. Apporter un abonnement ChatGPT ne rend pas les revues illimitées et ne supprime pas les limites du forfait ; revue locale en CLI et revue hébergée de pull request sont des processus différents. Vérifiez vos droits actuels et notre guide des abonnements avant d’augmenter la concurrence.
Notre recommandation : commencer par une branche terminée, une base explicite, une paire de révisions consignée et une approbation humaine de fusion. Automatisez seulement lorsque vous pouvez expliquer ce qui est examiné, où résident les preuves et ce qui empêche une révision non contrôlée d’atteindre la production.