Lorsque Codex n’exécute pas les règles dans AGENTS.md, vérifiez d’abord le répertoire de démarrage et la hiérarchie des fichiers, et évitez de modifier à plusieurs reprises l’invite. Codex commence par la configuration globale et lit depuis le répertoire racine du projet jusqu’au répertoire de travail courant ; Les règles plus proches du répertoire actuel ont la priorité, et la chaîne d’instructions est reconstruite à chaque exécution ou début d’une session TUI.
D’abord, assurez-vous que le fichier est bien dans le chemin de recherche
Les règles de projet doivent être placées dans le répertoire racine du dépôt Git ou dans le répertoire parent du répertoire de travail en cours. Si vous partez de l’extérieur du dépôt, ou si le répertoire de travail est dans un autre sous-répertoire, Codex ne passera peut-être jamais à travers les fichiers que vous éditez. Vous pouvez commencer par le répertoire cible :
codex --cd services/api "列出当前生效的指令文件"Si le projet n’est pas un dépôt Git, Codex ne vérifie généralement que le répertoire courant, donc ne placez pas AGENTS.md dans un répertoire parent non pertinent et ne vous attendez pas à ce qu’il prenne effet automatiquement.
Ensuite, vérifiez les relations de couverture
Dans le même répertoire, AGENTS.override.md prime sur AGENTS.md, et Codex peut lire au maximum un fichier par couche. Le ~/.codex global du répertoire peut également contenir des fichiers de dérogation ; C’est adapté à une suppression temporaire, mais oublier de le supprimer fait paraître les règles du projet invalides. Les règles dans les annuaires imbriqués sont classées selon les règles des répertoires racines ; en cas de conflit, le contenu le plus proche du répertoire actuel prévaut.
Si le contenu est trop long, il sera également coupé
Le codex ne charge que les instructions de projet de taille limitée par défaut. Une fois que le contenu fusionné atteint sa limite, les règles suivantes peuvent ne pas entrer dans le contexte. Garder la spécification générale dans le répertoire racine et placer des commandes spécifiques au service dans le sous-répertoire correspondant est généralement plus fiable que de regrouper toutes les exigences dans un seul grand fichier.
Après modification, vous devez le relancer
AGENTS.md Ce n’est pas une configuration qui fait des mises à jour continues pendant l’exécution. Après avoir modifié le fichier, redémarrer Codex, ou terminer la session TUI en cours avant de recommencer ; Si vous changez un nom de fichier personnalisé, assurez-vous aussi qu’il a été écrit dans le project_doc_fallback_filenames. Enfin, faites réitéré Codex les règles en vigueur et vérifiez le répertoire racine du projet, le CODEX_HOME global et le fichier de dérogation le plus proche. Ce n’est qu’après que les trois soient cohérents que la tâche formelle peut commencer.
