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 :
- Appeler le modèle de langage pour comprendre la tâche
- Exécuter les opérations indiquées par la sortie du modèle (lire des fichiers, modifier le code, exécuter des commandes)
- Renvoyer les résultats des opérations au modèle
- 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
| Principe | Description | Exemple |
|---|---|---|
| Inclure des étapes de vérification | Codex 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 complexes | Les 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 contexte | Ré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
| Type | Environnement d'exécution | Caractéristiques |
|---|---|---|
| Thread local | Votre machine (à l'intérieur du bac à sable) | Peut lire/écrire des fichiers, utiliser les outils existants et exécuter des commandes |
| Thread cloud | Environnement 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
/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
| Mode | Modification de fichiers | Accès réseau | Cas d'utilisation |
|---|---|---|---|
| Lecture seule | Refusé | Refusé | Analyse en lecture seule, revue de code |
| Workspace-write | Espace de travail uniquement | Refusé | Développement quotidien (par défaut) |
| Full-access | Autorisé | 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
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
| Politique | Description | Comportement |
|---|---|---|
ask | Demander à chaque fois | Demander confirmation avant les opérations sensibles (par défaut) |
approve | Approbation automatique | Exécuter automatiquement, aucune confirmation nécessaire (à utiliser avec prudence) |
deny | Rejet automatique | Rejeter toutes les opérations susceptibles d'avoir des effets secondaires |
Configurer la politique d'approbation
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