Tutoriel Codex en mode terminal

Codex : déléguer tes tâches techniques à ChatGPT

Un outil en ligne de commande qui lit ton code, modifie tes fichiers, exécute des commandes et gère tes commits — pour automatiser la maintenance de tes plugins WordPress et de tes sites.

Durée : 45 min Niveau : Intermédiaire Outil : Codex (CLI / IDE / Cloud / GitHub)

🎯 Objectif de ce tutoriel

Comprendre ce qu’est Codex, l’installer, et l’utiliser pour automatiser des tâches techniques répétitives sur un projet (correction d’erreurs, mise à jour de fichiers, gestion Git) — sans qu’une action ne soit exécutée sans ton accord.

✅ Avant de commencer

  • Un abonnement ChatGPT (Plus, Pro, Business ou Enterprise) ou un compte API OpenAI
  • Un terminal (macOS, Linux, Windows) — aucune compétence en ligne de commande poussée requise
  • Idéalement, un projet existant (site, plugin, script) sur lequel t’exercer

1. Qu’est-ce que Codex ?

Codex est un outil agentique : contrairement à un chat classique où tu copies-colles du code, il travaille directement dans le dossier de ton projet. Tu décris un objectif en langage naturel, et Codex :

  • lit les fichiers concernés pour comprendre le contexte
  • planifie une suite d’actions
  • modifie les fichiers, exécute des commandes, teste le résultat
  • corrige lui-même si une erreur apparaît

Il fonctionne dans le terminal (Codex CLI), en extension VS Code ou JetBrains, dans un agent cloud qui travaille dans un environnement distant isolé, ou directement via un bot GitHub qu’on invoque par simple mention.

Attention Par défaut, Codex expose plusieurs niveaux d’approbation, du plus prudent (il propose et attend ta validation à chaque étape) au plus autonome (il agit seul). Un sandbox limite en plus ce à quoi il peut accéder sur ta machine. C’est toi qui choisis le niveau de contrôle — pense à rester sur le mode prudent tant que tu ne connais pas bien l’outil, surtout sur un site en production.

2. Prise en main pas à pas

1
Découverte

Installer Codex CLI

Ouvre un terminal et installe Codex avec le gestionnaire de paquets de ton choix :

npm (nécessite Node.js 22+)npm install -g @openai/codex
Homebrew (macOS)brew install –cask codex
macOS / Linux, script directcurl -fsSL https://chatgpt.com/codex/install.sh | sh
Ce que tu dois observerUne fois installé, vérifie avec codex --version. Tape ensuite codex dans n’importe quel dossier de projet : tu es invité à te connecter avec ton compte ChatGPT (le même que sur chatgpt.com).
2
Découverte

Lancer ta première tâche

Place-toi dans le dossier d’un projet existant (par exemple un de tes plugins PHP) et décris ce que tu veux :

Terminalcd mon-plugin codex
PromptAnalyse ce plugin WordPress et liste les fonctions PHP qui utilisent encore des requêtes SQL brutes plutôt que des requêtes préparées.
Ce que tu dois observerCodex explore les fichiers du dossier tout seul, sans que tu aies à préciser lesquels : c’est la lecture agentique du projet.
3
Application

Faire corriger et modifier des fichiers

Demande une correction concrète. Codex te montrera le changement avant de l’appliquer, selon le niveau d’approbation choisi :

PromptRemplace les requêtes SQL brutes identifiées par des requêtes préparées avec $wpdb->prepare(), sans changer le comportement du plugin.
Ce que tu dois observerUne proposition de diff (avant/après) s’affiche ; en mode prudent, tu valides chaque changement avant que rien ne soit écrit sur le disque.
4
Application

Automatiser un commit Git

Codex travaille directement avec Git : il peut préparer, décrire et committer tes changements.

PromptCommit ces changements avec un message clair en français décrivant la correction de sécurité apportée.
5
Maîtrise

Donner des instructions permanentes avec AGENTS.md

Crée un fichier AGENTS.md à la racine d’un projet : Codex le lit automatiquement à chaque session, et fusionne aussi les fichiers AGENTS.md présents dans les sous-dossiers. Utile pour lui rappeler tes conventions (CSS scopé, couleurs de marque, structure de tes plugins, etc.).

AGENTS.md# Conventions A3iformations – Tout le CSS des pages tutoriels est scopé sous une classe unique (.a3i-xxx) avec !important pour résister au thème du site. – Couleurs de marque : navy #003A6C, azure #0078D4. – Les plugins WordPress suivent un préfixe PHP unique par plugin.
6
Maîtrise

Choisir un niveau d’approbation adapté

Trois niveaux existent, du plus prudent au plus autonome :

ModeComportement
SuggestionCodex propose chaque commande et chaque modification, et attend ta validation avant d’agir.
AutomatiqueCodex exécute lui-même le travail courant et ne s’arrête que si une action semble plus risquée ou qu’une commande échoue.
Totalement autonomeCodex agit sans demander, dans les limites du sandbox défini.
Exemple, exécution non-interactive contrôléecodex -a never -s workspace-write exec « Lance les tests et corrige les échecs »
Bon à savoirLe sandbox définit ce à quoi Codex peut accéder (fichiers modifiables, accès réseau), indépendamment du niveau d’approbation. Les deux réglages se combinent pour garder le contrôle.

🧩 Atelier A3I — Nettoyer un plugin

Mets-toi en situation avec un de tes propres plugins (ou un fichier PHP de test) :

  1. Installe Codex CLI et connecte-toi avec ton compte ChatGPT.
  2. Ouvre le dossier d’un de tes plugins WordPress dans le terminal.
  3. Demande un audit rapide : failles XSS potentielles, requêtes SQL non préparées, fonctions dépréciées.
  4. Fais corriger un seul point à la fois, en mode Suggestion, en validant chaque diff proposé.
  5. Termine par un commit Git avec message explicite.

📋 Récapitulatif des surfaces disponibles

SurfaceIdéal pour
Terminal (Codex CLI)Usage principal, contrôle total, scripts
VS Code / JetBrainsDiffs visuels intégrés à l’éditeur
Agent cloudTâches longues en parallèle, sans mobiliser ta machine, ouverture automatique de pull requests
Bot GitHubDéclenché par simple mention dans une issue ou une pull request

✅ Auto-évaluation

  • Je sais installer Codex CLI sur mon système.
  • Je sais lui confier une tâche d’analyse sur un projet existant.
  • Je sais valider ou refuser une modification proposée.
  • Je sais lui faire préparer un commit Git.
  • Je comprends l’utilité d’un fichier AGENTS.md et des niveaux d’approbation.