Guide Codex CLI pour une vraie codebase
Un workflow Codex CLI pour lire un repo, modifier du code, verifier les tests et garder des changements propres.
Reponse rapide
Un bon workflow Codex CLI est simple : lire les instructions projet, inspecter le chemin de code, faire le plus petit changement utile, lancer les checks locaux et resumer les fichiers touches.
La boucle de travail
Commence par une recherche rapide dans le repo, puis lis les fichiers proches avant d'editer. Apres chaque changement, lance le check le plus etroit qui prouve le comportement.
Ce qui rend le workflow fiable
La fiabilite vient de changements bornes, d'hypotheses explicites, d'un git non destructif et du refus de masquer tests, migrations ou checks securite en erreur.
FAQ
Codex doit-il editer avant de lire le repo ?
Non. L'agent doit lire les patterns locaux puis faire des changements alignes avec l'architecture existante.
Quel check lancer apres un edit ?
Lance d'abord le check le plus proche : test unitaire, type-check, pSEO check ou lint selon ce qui a change.
Lire le workflow
Guides associés
Claude Code Plan Mode : guide pratique
Le Plan Mode de Claude Code te laisse voir et ajuster le plan d'exécution avant qu'un seul fichier soit touché. Quand l'utiliser et comment en tirer le maximum.
Beaucoup de gens utilisent Claude Code comme un chat : ils décrivent la tâche et regardent l'exécution. Pour une petite modification, ça passe. Pour tout ce qui touche plusieurs fichiers, je préfère mettre un arrêt avant le diff. Le Plan Mode. Ce que fait le Plan Mode Quand tu actives le Plan Mode, Claude lit ton codebase et produit un plan d'exécution étape par étape, sans modifier de fichier. Tu vois ce qu'il compte faire avant qu'une ligne soit écrite. C'est un point de contrôle : tu valides le plan, tu le réorientes, ou tu corriges une hypothèse incorrecte avant qu'elle ne se propage en 15 mauvaises modifications. Comment l'activer Deux façons : Raccourci clavier : appuyer sur Shift+Tab avant d'envoyer ton message. L'input affiche un indicateur "Plan". Préfixe dans le message : commencer ton message par Plan: (P majuscule). Claude détecte l'intention et passe en mode plan uniquement. Claude…
Lire le guideMes 5 hooks Claude Code utiles
Les hooks Claude Code lancent des commandes au bon moment : démarrage de session, écriture de fichier, appel d'outil. Voici ceux que je garde activés.
La plupart des gens arrivent sur Claude Code pour l'agent. Ils découvrent les hooks plus tard, alors que c'est souvent là que le setup devient sérieux. Un hook est une commande qui s'exécute quand un événement arrive dans ta session : démarrage, appel d'outil, écriture de fichier, arrêt de Claude. Tu les définis dans .claude/settings.json . Ensuite ils tournent en arrière plan. Voici ceux que je garde dans mon setup. À quoi ressemblent les hooks Les événements disponibles : SessionStart , UserPromptSubmit , PreToolUse , PostToolUse , Stop . Hook 1 : injection automatique de la date Événement : UserPromptSubmit Claude n'a pas de conscience du temps réel. Chaque prompt reçoit automatiquement la date du jour. Utile pour tout ce qui est sensible au temps : changelogs, deadlines, logique de planification. Hook 2 : notification push quand Claude s'arrête Événement : Stop Les longues tâches (refactos, exécution de tests, analyses)…
Lire le guideCLAUDE.md : le guide de tout développeur
Un fichier markdown pour donner à Claude Code les conventions réelles de ton codebase et obtenir du code cohérent dès la première session.
Claude Code peut écrire du code propre dans un projet, puis sortir du code générique dans le suivant. Dans mon expérience, la différence vient souvent de CLAUDE.md . C'est le fichier qui évite de répéter les mêmes conventions à chaque session, et c'est une grosse partie de mon gain avec Claude Code. Ce que c'est CLAUDE.md est un fichier markdown que Claude Code lit au début de chaque session. Pense y comme le doc d'onboarding que tu donnerais à un prestataire senior le premier jour : stack, conventions, règles, contexte. Sans ça, Claude infère les patterns depuis ce qu'il voit dans le codebase. Parfois il tombe juste. Souvent non, surtout pour les conventions implicites que ton équipe connaît sans les avoir écrites. Avec un bon CLAUDE.md , Claude produit du code qui suit tes règles sans avoir besoin de le répéter à chaque fois. Quoi y mettre 1. Stack et…
Lire le guide