Comprendre Codex CLI : les grandes pièces d’un agent de terminal

Pour comprendre Codex CLI, suivez une requête depuis l’interface jusqu’au résultat : le programme construit le contexte, appelle un modèle, traite sa réponse et exécute éventuellement un outil autorisé. Cette boucle explique mieux le fonctionnement qu’une liste de fonctions isolées. Les noms de fichiers évoluent ; utilisez le dépôt officiel comme référence pour la version que vous consultez.

Commencer par le dépôt et la version

Le code source est publié dans le dépôt Codex. Le dépôt actuel sépare notamment codex-cli/ et codex-rs/. Repérez le README, les instructions de contribution et le commit avant d’explorer le code : l’architecture de la branche principale peut différer de celle de votre version installée.

Suivre la boucle de l’agent

Une session conserve les messages et l’état de la tâche. Le client prépare une requête, l’envoie au modèle et interprète la réponse. Si le modèle demande un outil, Codex vérifie le cadre d’exécution, lance l’action autorisée, puis renvoie son résultat au modèle. La boucle s’arrête lorsqu’une réponse finale est produite ou qu’une limite est atteinte.

Lire les responsabilités séparément

Dans un dépôt volumineux, cherchez les types de session, la construction des prompts, le client de modèle et les interfaces d’outils. Suivez une fonction d’entrée avec la recherche de symboles plutôt que de lire tous les fichiers dans l’ordre. Les tests et exemples montrent souvent les contrats attendus ; ils sont utiles pour distinguer une frontière stable d’un détail interne.

Ce que le code ne garantit pas

Le modèle peut se tromper, et l’accès aux fichiers ou aux commandes dépend de la configuration et des autorisations choisies. Le code d’un outil montre ce qui peut être demandé, pas qu’une tâche donnée est sans risque. Pour une expérience sûre, utilisez un dépôt jetable, inspectez les changements proposés et comprenez le mode de confirmation actif. Comparez les fichiers du commit choisi avec les notes de version pour relier une fonction à la version réellement publiée.