Glossaire
📚 Navigation de la série : Le chapitre précédent 〔37 FAQ et résolution des problèmes〕 décrivait comment diagnostiquer et corriger les erreurs d'environnement ou de droits d'accès courantes. Ce chapitre sert de lexique de référence : conçu comme un dictionnaire de consultation rapide, vous pouvez y rechercher les définitions des termes techniques de ce guide. Le chapitre suivant 〔39 Gestion d'entreprise〕 s'intéressera à la gouvernance et au déploiement de Codex à l'échelle d'une équipe.
Ce guide a introduit de nombreux concepts techniques au fil de sa lecture.
Agent autonome, sandbox, approbation, intensité du raisonnement, service_tier, MCP, sous-agents, compétences, hooks... Lors de la prise en main de ce type d'outil, l'accumulation de nouveaux termes peut être déroutante.
Il est tout à fait normal de devoir s'y référer à plusieurs reprises. La solution consiste à consulter les définitions selon vos besoins plutôt que de chercher à les mémoriser. C'est l'usage régulier qui permet d'assimiler ces concepts.
Ce chapitre rassemble les définitions des termes clés. Ils sont regroupés par thèmes sous forme de fiches explicites. Utilisez le raccourci Ctrl+F pour rechercher directement le terme recherché.
Ce que vous obtiendrez après avoir lu ce chapitre :
- Les définitions des concepts fondamentaux de l'IA (Agent, boucle d'agent, fenêtre de contexte, token).
- Les termes propres à Codex (
AGENTS.md,codex exec, sandbox, approbation, intensité du raisonnement, niveau de service, Chronicle). - Les distinctions des fonctionnalités d'extension (MCP, sous-agents, compétences, hooks, plugins).
- Le positionnement des modèles de la gamme GPT-5.x et la signification du statut de version.
⚠️ Les commandes, configurations et comportements décrits se réfèrent à la documentation officielle de Codex. Les noms de modèles et options pouvant évoluer selon les versions, fiez-vous aux affichages de votre terminal local.
01 Concepts fondamentaux : les bases de l'IA
Ces termes désignent les concepts communs aux outils de programmation par IA, et non spécifiques à Codex.
Agent (Agent autonome / Intelligent Agent) Un programme d'intelligence artificielle capable de décomposer une tâche complexe, de sélectionner et d'exécuter des outils système, d'analyser le résultat et d'ajuster sa stratégie en autonomie pour atteindre un objectif, par opposition aux interfaces de chat linéaires (questions/réponses). Dans Codex : Codex est l'agent de programmation d'OpenAI. Il peut lire la base de code, modifier les fichiers locaux et exécuter des tests de validation de manière autonome, sous votre supervision.
Boucle de l'agent (Agentic Loop) Le cycle d'exécution de l'agent autonome : Réfléchir (analyser l'état) → Agir (exécuter une modification ou un outil) → Observer (analyser le résultat), répété jusqu'à la résolution de la tâche. Analogie : Le plombier. Il n'établit pas un devis définitif au premier coup d'œil. Il analyse la fuite (réflexion), applique un joint (action), ouvre l'eau pour valider la réparation (observation), et adapte son intervention si la fuite persiste. Codex fonctionne de la même manière en modifiant le code et en validant le résultat par des tests jusqu'à résolution. Ce mécanisme est identique à celui de Claude Code.
Fenêtre de contexte (Context Window) La quantité maximale d'informations textuelles (consignes, historique de discussion, fichiers de code) que le modèle peut traiter simultanément lors d'une requête. Une fois cette limite atteinte, les informations les plus anciennes sont tronquées ou compressées. Analogie : La surface de votre bureau. Sa surface limite le nombre de documents que vous pouvez consulter en même temps. Y ajouter de nouveaux dossiers vous oblige à empiler ou à retirer les plus anciens. C'est pourquoi un historique trop long ou contenant des fichiers volumineux nuit à la précision des réponses de l'agent. Les sous-agents permettent d'isoler ces tâches pour désencombrer le contexte principal.
Token L'unité de base utilisée par les modèles d'IA pour segmenter et mesurer le texte (représentant environ un mot ou une syllabe). Les requêtes d'entrée et les réponses de sortie sont facturées en tokens. Dans Codex : le token influe sur les quotas d'abonnements ou les coûts de facturation de l'API. Les modèles phares consomment plus de crédits par token que les modèles légers. La capacité de la fenêtre de contexte se mesure également en tokens.
| Terme | Définition simplifiée |
|---|---|
| Agent | Un programme d'IA capable d'exécuter des actions en autonomie |
| Boucle de l'agent | Le cycle d'action de l'agent : Réfléchir → Agir → Observer |
| Fenêtre de contexte | La mémoire de travail maximale utilisable lors d'une requête |
| Token | L'unité de mesure et de facturation du traitement textuel |
02 Concepts propres à l'écosystème Codex
Ces termes désignent les options et les fichiers de configuration spécifiques à Codex.
AGENTS.md (Guide de projet) Fichier au format Markdown situé à la racine du projet ou dans l'espace utilisateur, contenant les conventions de code, les commandes utiles et les contraintes à respecter, lu automatiquement par Codex avant chaque tâche. Analogie : Les consignes d'intervention. C'est l'équivalent du fichier de consignes que vous laisseriez à un prestataire technique décrivant les procédures du projet (tests, build, style). Il remplace le fichier CLAUDE.md de Claude Code.
codex exec (Commande non interactive) Mode d'exécution de Codex permettant de lancer une tâche ponctuelle depuis le terminal sans entrer dans l'interface conversationnelle, utile pour l'intégration continue ou l'automatisation. Analogie : Un distributeur automatique. Contrairement au mode interactif (conversationnel), vous fournissez la consigne en entrée et obtenez directement le résultat ou le fichier modifié en sortie.
Sandbox (Isolation de sécurité) Le mécanisme de protection système limitant les actions autorisées de Codex (accès réseau, modification de fichiers système, périmètre d'écriture autorisé). Analogie : La barrière de sécurité. Elle définit le périmètre au sein duquel Codex peut agir de manière autonome. Le mode standard workspace-write autorise les écritures uniquement dans le dossier du projet et bloque l'accès réseau par défaut. Le mode danger-full-access lève toutes les restrictions (à utiliser avec prudence).
Politique d'approbation (Approval Policy) Le paramètre configurant les demandes de confirmation exigées par Codex avant d'exécuter une commande ou de modifier un fichier. Analogie : La politique de contrôle de sécurité. La sandbox définit ce qui est autorisé, la politique d'approbation définit à quel moment l'agent doit vous demander confirmation (ex. : on-request pour solliciter votre validation uniquement pour les actions hors sandbox).
Intensité du raisonnement (Reasoning Effort) Paramètre configurant le temps de réflexion alloué au modèle avant de répondre à une requête (valeurs : minimal, low, medium, high, xhigh). Analogie : Le temps de préparation à un examen. Un temps court (minimal) permet d'obtenir une réponse rapide pour une tâche simple (typos), tandis qu'un temps long (high ou xhigh) permet au modèle d'analyser les cas limites et l'architecture pour les refactorisations complexes.
Résumé du raisonnement (Reasoning Summary) L'option configurant le niveau d'affichage de la réflexion de l'agent dans la console (valeurs : auto, concise, detailed, none). C'est un paramètre d'affichage sans impact sur la qualité du code produit.
Niveau de service (Service Tier) L'option de routage de vos requêtes pour privilégier soit le coût (flex), soit la rapidité (fast). Le mode fast permet d'accélérer l'exécution en arrière-plan moyennant une facturation de crédits supplémentaire.
config.toml (Fichier de configuration) Le fichier de configuration principal au format TOML situé dans ~/.codex/config.toml regroupant vos préférences permanentes (modèle, sandbox, serveurs MCP).
Chronicle / Mémoire (Memory) Le système permettant à Codex de conserver en mémoire vos préférences de programmation ou le contexte de votre projet d'une session à l'autre. Le stockage est local et désactivé par défaut. Chronicle est une fonctionnalité expérimentale permettant d'intégrer le contenu de l'écran dans l'analyse du contexte.
03 Outils d'extension et d'intégration
Ces concepts décrivent les méthodes pour étendre les capacités de Codex ou structurer ses tâches.
MCP (Model Context Protocol) Protocole ouvert standardisant la connexion et l'échange de données entre Codex et des applications ou bases de données externes (bases SQL, outils de maquettage, services web). Analogie : Le port USB. Il fournit une interface de communication unique permettant d'étendre les capacités de l'agent sans avoir à réécrire de connecteurs spécifiques pour chaque application.
Sous-agent (Subagent) Processus de traitement secondaire instancié en arrière-plan par l'agent principal pour traiter une tâche isolée et en restituer la synthèse. Analogie : La délégation de tâche. L'agent principal gère la structure globale du projet et délègue l'écriture des cas de test ou l'analyse syntaxique de fichiers tiers à des sous-agents autonomes, libérant ainsi sa propre fenêtre de contexte.
Compétence (Skill / Agent Skill) Un script ou ensemble de consignes formalisé décrivant la résolution d'une tâche récurrente (ex. : génération de documentation de API), réutilisable par l'agent à la demande. Analogie : La fiche de procédure. C'est un guide pas à pas enregistré localement dans un répertoire dédié, permettant à l'agent d'appliquer une suite d'actions standardisées.
Hook (Script d'initialisation) Script exécuté automatiquement lors d'événements précis du cycle de vie de Codex (au démarrage, avant l'appel d'un outil, ou en fin de tâche). Analogie : Le capteur de présence. Il s'exécute de manière automatique dès que l'événement associé survient, sans confirmation manuelle de l'utilisateur.
Plugin (Kit d'extension) Package regroupant des compétences, des serveurs MCP et des configurations partagées pour simplifier leur déploiement et leur mise à jour.
| Concept | Rôle principal |
|---|---|
| MCP | Interface de connexion vers des outils externes |
| Sous-agent | Processus secondaire pour traiter des tâches isolées |
| Skill | Guide de procédure standardisé réutilisable |
| Hook | Automatisation déclenchée lors d'événements de session |
| Plugin | Package regroupant des Skills et des configurations MCP |
04 Modèles de traitement
Ce tableau détaille le positionnement des modèles d'OpenAI compatibles avec l'environnement Codex.
| Modèle | Rôle et caractéristiques | Cas d'usage recommandé |
|---|---|---|
gpt-5.5 | Modèle phare de référence, offrant les meilleures performances | Architecture, refactorisations, résolution d'anomalies complexes |
gpt-5.4 | Modèle intermédiaire équilibrant vitesse et coûts | Développement de fonctionnalités standards |
gpt-5.4-mini | Modèle léger optimisé pour la rapidité et l'économie | Tâches de routine, exécutions de sous-agents |
gpt-5.3-codex-spark | Version d'évaluation instantanée (formules ChatGPT Pro) | Pair-programming et questions-réponses interactives |
gpt-5.2 / gpt-5.3-codex | Modèles obsolètes (retirés du support standard) | Ne plus utiliser dans vos configurations |
Version d'évaluation (Research Preview) Statut appliqué aux modèles ou fonctionnalités en cours de test public. Ces versions sont sujettes à modification de comportement ou de disponibilité sans préavis.
Version obsolète (Deprecated) Modèles retirés du support officiel. Déclarer ces noms dans votre fichier de configuration ou vos options de lancement bloquera l'exécution du CLI.
05 Méthode de consultation du glossaire
Pour exploiter au mieux ce glossaire :
- Consultez-le en cas de doute de vocabulaire lors de la lecture d'autres guides ou de la configuration de vos options de session.
- Distinguez les concepts proches à l'aide de notre tableau récapitulatif (ex. : différencier sandbox et politique d'approbation).
- Validez les concepts par la pratique : en cas d'hésitation sur la portée d'une option (comme la sandbox), réalisez un test d'écriture rapide dans un répertoire de test Git (voir chapitre 02 Concepts fondamentaux).
💡 Résumé en une phrase : Ce glossaire sert de référence permanente pour clarifier les concepts et lever les doutes de vocabulaire lors de l'utilisation de Codex.
Synthèse
Ce glossaire a défini les termes techniques essentiels de Codex regroupés par catégories :
- Les bases de l'IA : définitions d'Agent, boucle d'agent, fenêtre de contexte et token.
- Les concepts Codex : configuration de
AGENTS.md, modes d'exécutioncodex exec, sandbox, approbation, raisonnement et gestion de la mémoire. - Les outils d'extension : distinction des serveurs MCP, sous-agents, compétences, hooks et plugins.
- Les modèles : positionnement de la gamme GPT-5.x et gestion de cycle de vie des modèles.
Vous disposez d'un lexique technique complet pour vous accompagner dans la configuration et l'utilisation quotidienne de Codex.
Le chapitre suivant 〔39 Gestion d'entreprise〕 aborde le déploiement, la gouvernance et la sécurisation des usages de Codex à l'échelle d'une organisation ou d'une équipe de développement.