Concepts fondamentaux de Codex

Avant d'utiliser Codex, il est très important de comprendre quelques concepts de base. Ces concepts constituent le fondement du fonctionnement de Codex.


Prompt

Vous interagissez avec Codex en envoyant des invites, en décrivant la tâche que vous souhaitez qu'il accomplisse.

Boucle de travail des invites

Après avoir soumis une invite, Codex travaille selon la boucle suivante :

  1. Appeler le modèle de langage pour comprendre la tâche
  2. Exécuter les opérations indiquées par la sortie du modèle (lire des fichiers, modifier le code, exécuter des commandes)
  3. Renvoyer les résultats des opérations au modèle
  4. Répéter la boucle jusqu'à ce que la tâche soit terminée ou que vous annuliez.

Codex utiliseboucle d'agentcomme mode de fonctionnement — le modèle produit des instructions pour les actions, les résultats sont renvoyés au modèle, et le cycle se répète jusqu'à ce que la tâche soit terminée.

Principes des invites efficaces

PrincipeDescriptionExemple
Inclure des étapes de vérificationCodex produit une sortie de meilleure qualité lorsqu’il peut vérifier son travail"Écrire une fonction, incluant des cas de test pour vérifier qu’elle gère une liste vide"
Décomposer les tâches complexesLes tâches plus petites sont plus faciles à tester et à examiner"Étape 1 : Créez le modèle ; une fois terminé, prévenez-moi avant de passer à l’étape 2"
Fournir du contexteRéférencer les fichiers et images pertinents"Référez-vous au style de src/auth.py pour implémenter une fonctionnalité similaire"

Codex est plus performant lorsqu’il traite de petites tâches ciblées. Les tâches importantes doivent être décomposées en petites étapes et exécutées de manière incrémentielle.


Fil

Un fil est une session de tâche unique : vos prompts ainsi que les sorties du modèle et les appels d’outils qui en résultent.

Types de fils

TypeEnvironnement d'exécutionCaractéristiques
Thread localVotre machine (à l'intérieur du bac à sable)Peut lire/écrire des fichiers, utiliser les outils existants et exécuter des commandes
Thread cloudEnvironnement cloud isoléCloner le dépôt et exécuter, adapté aux tâches parallèles, à la délégation multi-appareils

Règles d'utilisation des threads

Les threads en cours d'exécution peuvent être concurrents, mais attention :

  • Éviter que deux threads modifient le même fichier en même temps
  • Un thread peut être repris plus tard en continuant avec une autre invite
  • Les tâches de longue durée peuvent automatiquement compacter le contexte

Contexte

Lorsque vous soumettez un prompt, il inclut le contexte que Codex peut utiliser — des références à des fichiers et images pertinents.

Sources de contexte

  • extension IDE: inclut automatiquement la liste des fichiers ouverts et les plages de texte sélectionnées
  • Spécification manuelle: référencez les chemins de fichiers dans le prompt ou joignez des images
  • Historique de conversation: contenu de la conversation précédente dans le fil

Fenêtre de contexte

Toutes les informations d'un fil doivent tenir dans la fenêtre de contexte du modèle.

Codex surveille et signale l'espace restant. Vous recevrez une invite lorsque vous approcherez de la limite.

Compactage automatique

Pour les tâches plus longues, Codex peut compacter automatiquement le contexte.

Le mécanisme de compactage résume les informations pertinentes, écarte les détails moins importants et libère de l'espace pour continuer le traitement.

Gestion du contexte

# Démarrer une nouvelle session pour libérer du contexte
/nouveau

# Voir l'utilisation actuelle du contexte
/status

Lorsque Codex signale une utilisation élevée du contexte, envisagez de démarrer une nouvelle session ou de réduire les messages historiques.


Bac à sable

Le sandbox est le mécanisme d'isolation de sécurité de Codex qui empêche toute modification accidentelle des fichiers en dehors de l'espace de travail.

Modes du sandbox

ModeModification de fichiersAccès réseauCas d'utilisation
Lecture seuleRefuséRefuséAnalyse en lecture seule, revue de code
Workspace-writeEspace de travail uniquementRefuséDéveloppement quotidien (par défaut)
Full-accessAutoriséAutoriséEnvironnement de confiance totale (à utiliser avec prudence)

Mécanisme d'approbation

Certaines opérations nécessitent votre confirmation avant exécution :

  • Exécution de commandes shell (notamment rm, kill, etc.)
  • Modification ou suppression de fichiers
  • Accès à des répertoires sensibles (p. ex., ~/.ssh/, /etc/)
  • Requêtes réseau

Définition du mode sandbox

# Changer le mode sandbox dans la CLI
codex --sandbox workspace-write

# Ou spécifier dans le prompt
"Analyse ce code, ne modifie aucun fichier"

La sandbox est la première ligne de défense de la politique de sécurité de Codex, garantissant que les opérations de l'IA ne dépassent pas le périmètre attendu.


Politique d'approbation

La politique d'approbation détermine si une confirmation est nécessaire avant que Codex n'exécute des opérations.

Types de politiques

PolitiqueDescriptionComportement
askDemander à chaque foisDemander confirmation avant les opérations sensibles (par défaut)
approveApprobation automatiqueExécuter automatiquement, aucune confirmation nécessaire (à utiliser avec prudence)
denyRejet automatiqueRejeter toutes les opérations susceptibles d'avoir des effets secondaires

Configurer la politique d'approbation

# ~/.codex/config.toml

approval_policy = "ask"

Résumé

Après avoir compris ces concepts fondamentaux, vous pouvez utiliser Codex plus efficacement :

  • Invite: Décrire clairement la tâche, y compris les étapes de vérification
  • Thread: Gérer les sessions de tâches, faire attention aux règles de concurrence
  • Context: Fournir un contexte pertinent, surveiller l'utilisation de la fenêtre
  • Sandbox: Comprendre les mécanismes de sécurité, choisir le mode approprié

Questions fréquentes

Q : Les prompts doivent-ils être en chinois ou en anglais ?

Codex prend en charge plusieurs langues, mais l'anglais fonctionne généralement mieux. Lorsque vous utilisez le chinois, assurez-vous que la description est suffisamment détaillée et claire.

Q : Comment puis-je consulter l'état actuel du thread ?

Utiliser/statuscommande pour afficher l'ID du thread, l'utilisation du contexte et les informations de configuration.

Q : Que dois-je faire si la fenêtre de contexte est pleine ?

Démarrez une nouvelle session (/new), ou laissez Codex compacter automatiquement l'historique.

Q : Le mode sandbox peut-il être changé dynamiquement ?

Vous pouvez le spécifier au démarrage de la CLI, ou définir une valeur par défaut dans le fichier de configuration.

Autres extensions