Votre premier task Codex — Codex — Développement Assisté par IA

Lancer votre première tâche

Vous avez configuré votre compte, connecté GitHub, et créé votre AGENTS.md. Il est temps de lancer votre première tâche Codex et de voir l’agent en action.

Depuis l’app web

Rendez-vous sur codex.openai.com. Sélectionnez votre repository, puis tapez votre tâche dans le champ de saisie.

Commençons par quelque chose de simple :

Tâche : "Ajoute un fichier .gitignore adapté à un projet 
         Node.js/TypeScript si ce n'est pas déjà fait."

Codex va :

Cloner votre repository dans son sandbox
Vérifier si un .gitignore existe déjà
Si oui, vérifier qu’il couvre Node.js et TypeScript
Créer ou compléter le fichier avec les entrées manquantes
Vous montrer le résultat sous forme de diff

Vous voyez le journal d’exécution en temps réel. Chaque étape est documentée : les fichiers lus, les commandes exécutées, les décisions prises.

Depuis l’IDE

Ouvrez votre projet dans VS Code, puis utilisez la palette de commandes :

Ctrl+Shift+P → "Codex: New Task"

Ou utilisez le raccourci direct (configurable dans les paramètres). Tapez votre tâche :

"Ajoute la validation d'email dans le formulaire 
 de contact src/components/ContactForm.tsx"

L’extension affiche le résultat directement dans l’éditeur. Vous pouvez accepter les modifications, les modifier, ou les rejeter.

Depuis le CLI

# Se placer dans le répertoire du projet
cd mon-projet

# Lancer une tâche simple
codex "Ajoute un README.md avec la description du projet, 
       les instructions d'installation et les commandes disponibles"

# Voir le résultat
codex --show-diff

Le CLI affiche le diff dans le terminal. Vous pouvez l’appliquer avec codex --apply ou le rejeter.

Anatomie d’un résultat Codex

Quand Codex termine une tâche, il vous fournit :

Le diff des modifications

Chaque ligne ajoutée, modifiée ou supprimée, fichier par fichier.

Le journal d'exécution

Toutes les étapes : fichiers lus, commandes lancées, raisonnement de l'agent.

Les résultats des tests

Si des tests existent, Codex les exécute pour vérifier que rien n'est cassé.

Les actions possibles

Approuver, modifier, créer une PR, ou relancer avec des instructions différentes.

Écrire de bonnes instructions

La qualité du résultat dépend directement de la qualité de vos instructions. Voici la différence entre une bonne et une mauvaise instruction :

Trop vague :

"Améliore le code"

Précise et actionnable :

"Dans src/lib/auth.ts, remplace la gestion manuelle des JWT 
par la bibliothèque jose. Conserve la même interface publique 
(signToken, verifyToken). Mets à jour les tests correspondants."

Bonnes pratiques pour les instructions :

Indiquez les fichiers concernés quand vous les connaissez
Précisez le résultat attendu (comportement, interface, format)
Mentionnez les contraintes (ne pas casser les tests, garder la rétrocompatibilité)
Donnez du contexte métier si nécessaire (« c’est un formulaire de paiement, la sécurité est critique »)

Exercice pratique

Prenez un de vos projets existants et lancez ces trois tâches successivement :

Tâche d’analyse : « Liste tous les fichiers TypeScript qui n’ont pas de tests associés »
Tâche de génération : « Génère un test unitaire pour [un fichier spécifique] »
Tâche de correction : « Corrige les warnings ESLint dans src/utils/ »

Observez comment Codex navigue dans votre codebase, comprend le contexte, et produit des résultats adaptés à votre projet.

Points clés à retenir

Lancez vos premières tâches avec des demandes simples et ciblées
Codex fournit un journal d’exécution complet pour chaque tâche
La qualité du résultat dépend de la précision de vos instructions
Vous gardez toujours le contrôle : approuver, modifier ou rejeter
Commencez par des tâches de faible risque avant de passer aux modifications critiques