ChatGPT · Codex sur GitHub et dans l'IDE
Vous pouvez confier une issue GitHub à Codex, passer à autre chose, et revenir trouver une pull request testée qui attend votre validation. C'est le workflow que nous mettons en place dans cette leçon : Codex comme un coéquipier de développement qui vit dans votre dépôt et dans votre éditeur, et non une fenêtre de chat dans laquelle vous faites des copier-coller.
Codex est l'agent de software engineering d'OpenAI. Il tourne à trois endroits qui nous intéressent ici :
- le cloud, dans un environnement sandboxé connecté à vos dépôts GitHub
- votre IDE, via l'extension officielle
- la CLI dans votre terminal
Les trois reposent sur le même agent. Ils diffèrent par le degré d'autonomie que vous lui accordez. Commencez par la présentation officielle dans la documentation Codex.
Les deux surfaces : cloud et local
Il y a une distinction à bien fixer avant tout le reste.
Codex cloud exécute chaque tâche dans un conteneur isolé. Il clone votre dépôt, dispose de son propre système de fichiers et, par défaut, n'a pas d'accès à internet pendant que l'agent travaille. C'est là que se joue le flux « assigner une issue, obtenir une PR ».
Codex local (l'extension IDE et la CLI) tourne sur votre machine, sur votre arborescence de travail réelle. Il voit vos modifications non commitées et vos outils locaux. C'est là que vous travaillez en binôme sur quelque chose en direct, en suivant chaque diff.
Même agent, rayon d'impact différent. Le cloud sert à déléguer un travail autonome. Le local sert à collaborer sur le moment.
Connecter Codex à GitHub
Dans ChatGPT, ouvrez Codex et connectez votre compte GitHub. Puis accordez l'accès à des dépôts précis (pas à toute votre organisation). Codex installe une GitHub App aux permissions limitées. Une fois la connexion faite, vous pouvez pointer une tâche vers n'importe quelle branche et Codex peut ouvrir des pull requests sur ce dépôt.
Chaque dépôt dispose aussi d'un environnement Codex. Dans les paramètres de l'environnement, vous définissez le script de setup (par exemple pip install -e ".[dev]"), les variables d'environnement, les secrets, et si l'accès à internet est autorisé. Codex exécute le script de setup avant chaque tâche, ce qui permet aux tests de tourner dans le conteneur.
Dans votre éditeur, installez l'extension Codex pour VS Code (elle fonctionne aussi dans des forks comme Cursor et Windsurf). Connectez-vous avec votre compte ChatGPT. Une tâche lancée depuis l'IDE peut être envoyée dans le cloud et consultée plus tard dans le dashboard Codex.
Mise en pratique : prendre une issue, ouvrir une PR
Voici le flux concret. Imaginons que votre dépôt contienne cette issue :
#214: Login form accepts whitespace-only passwords Users can submit a password that is just spaces. Add validation and a test.
1. Assigner la tâche
Dans la vue cloud de Codex, sélectionnez le dépôt et la branche, puis décrivez la tâche. Le plus efficace est de coller l'issue et de citer de vrais fichiers :
Fix issue #214. Insrc/auth/validators.py, reject passwords that are empty or whitespace-only. Match the existingValidationErrorpattern used byvalidate_email. Add a unit test intests/test_validators.py.
Codex démarre un conteneur, exécute votre script de setup, lit les fichiers concernés et planifie. Comme l'environnement est sandboxé, il peut lancer votre suite de tests au fil de son travail.
2. Le laisser travailler, puis lire le diff
Codex modifie les fichiers, lance les tests et itère si quelque chose échoue. Quand il a terminé, vous recevez un résumé : ce qu'il a changé, les commandes exécutées et la sortie des tests. Lisez le diff. Traitez-le exactement comme la PR d'un développeur junior. L'agent est rapide et infatigable, et il fait quand même des erreurs.
3. Ouvrir la pull request
Si le diff vous convient, ouvrez une PR directement depuis Codex. Il rédige un titre et une description, référence l'issue #214 et pousse une branche. Vos protections de branche, vos reviewers obligatoires et votre CI s'appliquent toujours. Rien n'est mergé tant que vos règles existantes ne sont pas respectées.
Voilà la boucle : une issue en entrée, une PR relue en sortie, avec vous comme point de contrôle.
Travailler depuis GitHub
Vous pouvez aussi partir de GitHub. Une fois Codex connecté, commentez @codex review sur une pull request et Codex publie une code review, en signalant les bugs et les changements risqués comme le ferait un reviewer. Mentionnez @codex avec une instruction (par exemple @codex fix the failing test in tests/test_validators.py) et il lance une tâche cloud dans l'environnement de ce dépôt. Vous pouvez aussi activer les reviews automatiques pour un dépôt dans les paramètres de Codex, pour que chaque nouvelle PR reçoive une première passe avant qu'un humain ne la regarde.
Apprendre votre projet à Codex avec AGENTS.md
Codex ne connaît pas vos conventions par magie. Vous les lui apprenez une fois, dans un fichier qu'il lit automatiquement : `AGENTS.md` à la racine du dépôt. C'est du Markdown simple, un README écrit pour l'agent et non pour des humains. Il n'y a pas de schémamaUtiliser un logiciel pour automatiser les tâches et campagnes marketing répétitives, afin de personnaliser à grande échelle sur des canaux comme l'email, le web et le social.Voir la définition complète → particulier. Des titres et des puces courtes fonctionnent le mieux.
Un bon AGENTS.md indique à Codex comment lancer les vérifications, quelles conventions suivre et ce à quoi il ne doit pas toucher. Restez bref et factuel.
# AGENTS.md
## Testing and checks
- Run tests with `pytest -q`.
- Lint with `ruff check .` and type-check with `mypy src/`.
- All three must pass before you propose a PR.
## Conventions
- Follow PEP 8; format with ruff.
- New functions need type hints and a docstring.
- Tests go in tests/ and mirror the src/ path.
## Off-limits
- Never edit files under migrations/ by hand.Avec ce fichier en place, Codex lance vos vraies vérifications et reste en dehors des répertoires que vous avez exclus. Si pytest échoue, il voit l'échec et réessaie avant de vous remettre la PR. Vous recevez moins de PR qui cassent la CI dès leur arrivée.
Deux détails piègent souvent. L'installation des dépendances pour les tâches cloud relève du script de setup de l'environnement, pas d'AGENTS.md. Et dans un monorepo, vous pouvez placer des fichiers AGENTS.md imbriqués dans des sous-répertoires : celui qui est le plus proche du fichier modifié prévaut. Le même fichier est lu par l'extension IDE et par la CLI, donc les exécutions locales et cloud suivent les mêmes règles.
Codex dans l'IDE : le binôme en direct
Le flux cloud, c'est de la délégation. Le flux IDE, c'est de la collaboration, et vous y recourez quand vous voulez voir le travail se faire.
Dans VS Code avec l'extension Codex, ouvrez la barre latérale Codex et décrivez une modification sur votre projet ouvert. Une tâche locale typique :
RefactorOrderService.processto extract the discount logic into aDiscountCalculatorclass. Keep behavior identical and update the existing tests.
La différence avec le cloud tient aux validations. Codex local fonctionne selon des modes qui déterminent ce qu'il peut faire sans demander :
- Read only : il lit et propose, et vous décidez de ce que vous appliquez.
- Agent (par défaut) : il modifie les fichiers et exécute des commandes dans le workspace, et demande avant d'en sortir ou d'utiliser le réseau.
- Full access : il modifie, exécute des commandes et accède au réseau sans demander.
Au quotidien, le mode Agent par défaut est le bon compromis. Codex fait ses modifications et lance vos tests, et s'arrarrL'Annual Recurring Revenue (ARR) est le revenu normalisé et prévisible qu'une entreprise par abonnement attend de ses contrats actifs sur une année.Voir la définition complète →ête pour demander avant toute action hors du workspace. Vous restez dans la boucle sans valider chaque frappe.
L'IDE est aussi utile pour comprendre du code. Sélectionnez une fonction tordue, demandez à Codex de l'expliquer ou d'écrire des tests pour elle, et il travaille sur le fichier en direct avec tout le contexte du projet. Si une tâche devient plus grosse que prévu, transférez-la vers le cloud depuis l'extension et continuez à travailler en local.
Vérification des acquis
1. Quelle est la distinction fondamentale entre Codex cloud et Codex local décrite dans la leçon ?
2. Selon la leçon, dans quel cas vaut-il mieux privilégier Codex cloud plutôt que Codex local ?
3. La leçon souligne que le plus efficace, quand vous assignez une tâche, est de coller l'issue et de citer de vrais fichiers. Pourquoi est-ce important ?
4. Sélectionnez TOUTES les affirmations qui décrivent correctement la connexion de Codex à GitHub et à l'IDE.
Sélectionnez toutes les réponses correctes.
5. Sélectionnez TOUTES les caractéristiques qui s'appliquent à Codex local (l'extension IDE et la CLI).
Sélectionnez toutes les réponses correctes.
Les garde-fousgarde-fousRègles et contrôles qui maintiennent un système d'IA dans des limites sûres, légales et conformes à la marque, en bloquant les sorties et actions hors cadre.Voir la définition complète → à vraiment utiliser
Codex est livré avec des réglages par défaut prudents, que vous pouvez assouplir en connaissance de cause. Voici les vrais leviers.
Sandboxing et réseau
Les tâches cloud tournent sans accès à internet pendant la phase agent, sauf si vous l'activez pour cet environnement. Une tâche ne peut pas exfiltrer du code en douce ni récupérer des packages non fiables. Si votre build doit télécharger quelque chose en cours de tâche, activez l'accès et limitez-le à une liste de domaines autorisés (des registres de packages, par exemple). Un accès internet large doit être une décision délibérée.
Les validations sont votre coupe-circuit
En mode local, la demande de validation est la fonction de sécurité la plus importante dont vous disposez. Les commandes qui sortent du workspace ou touchent au réseau remontent pour confirmation. Évitez de tout passer en full access sur un dépôt qui compte. Réservez l'autonomie totale aux branches jetables et aux expérimentations.
La protection de branche fait l'essentiel du travail
Codex respecte votre configuration GitHub. Chaque changement arrive sous forme de PR sur une branche, donc vos reviews obligatoires, status checks et règles CODEOWNERS conditionnent toujours le merge. L'agent peut ouvrir une PR. Il ne peut pas contourner une branche main protégée. C'est pour cela que le modèle de la PR est plus sûr que de laisser un outil pousser directement : votre processus de review humaine reste inchangé. Un commentaire @codex review ajoute un reviewer. Il ne remplace pas vos reviewers humains.
Les secrets restent hors du prompt
Ne collez pas de clés d'APIAPIApplication Programming Interface : une interface standardisée qui permet aux applications de communiquer et d'échanger des données sans connaître leur fonctionnement interne respectif.Voir la définition complète → ni d'identifiants dans les descriptions de tâches ou dans AGENTS.md. Pour les environnements cloud qui ont besoin de secrets, utilisez les paramètres de secrets de l'environnement. Les secrets sont accessibles au script de setup et retirés avant que l'agent commence à travailler, raison de plus pour les garder là.
Limiter le périmètre de la GitHub App
Vous avez accordé l'accès à des dépôts précis lors de la connexion à GitHub. Gardez-le ainsi. Passez en revue les dépôts autorisés dans vos paramètres GitHub tous les quelques mois et retirez ceux auxquels Codex ne touche jamais.
Le modèle mental : cloud, sandbox et review de PR pour le travail délégué que vous ne surveillerez pas ; local et validations pour celui que vous suivrez. Dans les deux cas, le point de contrôle du merge reste vos règles GitHub existantes. Ne les affaiblissez jamais pour accélérer l'agent.
Quelle surface pour quel usage
Un guide de décision rapide :
- Une issue bien définie et autonome : Codex cloud. Assignez-la, occupez-vous d'autre chose, relisez la PR.
- Un refactoring exploratoire que vous voulez piloter : l'extension IDE en mode Agent.
- Une tâche scriptable et répétable en CI ou dans un workflow terminal : la CLI Codex (
codex execl'exécute en mode non interactif). - Un second avis sur la PR d'un collègue : commentez
@codex reviewsur GitHub. - Une série de petites corvées (montée de versions, corrections de lint sur plusieurs fichiers) : le cloud, une tâche pour chacune, puis relisez la pile de PR.
La compétence consiste à choisir la surface en fonction de la confiance que vous accordez à la tâche pour tourner sans surveillance. Les options et limites des environnements évoluent souvent, gardez donc la documentation Codex et le centre d'aide à portée de main.
Points clés
- Pilotez la boucle, pas le clavier. Assignez une issue GitHub avec des références de fichiers précises, laissez Codex cloud produire une PR, et relisez-la comme le travail d'un collègue.
- Rédigez un
AGENTS.mden Markdown simple : comment tester et linter, quelles conventions suivre, quels répertoires sont interdits. Placez l'installation des dépendances dans le script de setup de l'environnement. - Passez directement par GitHub quand c'est plus rapide :
@codex reviewsur une PR pour une code review, ou@codexsuivi d'une instruction pour lancer une tâche. - Choisissez la surface selon l'autonomie. Le cloud pour les tâches déléguées et autonomes ; l'extension IDE pour le binôme en direct, où vous suivez et validez.
- Gardez les tâches cloud hors ligne sauf si elles ont besoin d'un accès, conservez les secrets dans les paramètres de secrets, et réservez le full access aux branches jetables. Vos règles de protection de branche restent le point de contrôle final sur
main.
Questions fréquentes
Qu'est-ce que Codex et où s'exécute-t-il ?
Codex est l'agent de software engineering d'OpenAI. Il s'exécute à trois endroits : dans le cloud, au sein d'un conteneur isolé (sandbox) connecté à vos dépôts GitHub ; dans votre IDE, via l'extension officielle VS Code (qui fonctionne aussi dans des forks comme Cursor et Windsurf) ; et dans votre terminal via la CLI. Les trois reposent sur le même agent et diffèrent surtout par le degré d'autonomie que vous lui accordez.
Quelle est la différence entre Codex cloud et l'extension IDE de Codex ?
Codex cloud exécute chaque tâche dans un conteneur isolé qui clone votre dépôt, sans accès à internet par défaut pendant la phase agent. L'extension IDE tourne sur votre machine, sur votre working tree réel : elle voit les modifications non commitées et votre outillage local. Utilisez le cloud pour déléguer un travail autonome que vous ne surveillerez pas, et l'IDE pour travailler en binôme en direct sur un sujet que vous voulez piloter diff par diff.
Comment faire ouvrir une pull request à Codex à partir d'une issue GitHub ?
Connectez votre compte GitHub dans Codex, donnez accès au dépôt concerné, puis créez une tâche cloud qui sélectionne le dépôt et la branche et décrit le travail. Le prompt le plus efficace colle le texte de l'issue et nomme de vrais fichiers, par exemple le fichier du validateur à modifier et le fichier de tests à compléter. Codex exécute votre script de setup, fait les modifications, lance la suite de tests, et quand le diff vous convient, vous ouvrez la PR depuis Codex.
Que mettre dans un fichier AGENTS.md ?
AGENTS.md se place à la racine du dépôt. C'est du Markdown simple, sans schéma particulier : comment lancer les tests et les linters, les conventions à respecter, les répertoires à ne pas toucher. Restez bref, avec des titres et des puces. L'installation des dépendances relève du script de setup de l'environnement Codex, pas d'AGENTS.md. Dans un monorepo, vous pouvez imbriquer des fichiers AGENTS.md dans des sous-répertoires : celui le plus proche du fichier modifié l'emporte.
Codex peut-il merger du code dans main sans review ?
Non. Codex livre ses modifications sous forme de pull request sur une branche, donc vos reviews obligatoires, vos status checks et vos règles CODEOWNERS continuent de conditionner le merge. L'agent peut ouvrir une PR, il ne peut pas contourner une branche main protégée. Un commentaire `@codex review` ajoute un reviewer de plus sur une PR, il ne remplace pas vos reviewers humains.
Quel mode d'approbation utiliser pour Codex dans VS Code ?
Le mode Agent, celui par défaut, est le bon réglage au quotidien : Codex modifie les fichiers et exécute des commandes dans le workspace, et demande votre accord avant d'en sortir ou d'accéder au réseau. Le mode lecture seule sert quand vous voulez des propositions que vous appliquez vous-même. Réservez l'accès complet, où il modifie et accède au réseau sans demander, aux branches jetables et aux expérimentations.
À faire, tiré de cette leçon
Ces actions sont compilées dans le plan d'action du rôle.
- Rédiger un AGENTS.md avec l'installation, les tests, le lint et les répertoires interdits
- Mettre en place la protection de branche exigeant PR, review et checks au vert avant de lancer Codex