Résolution des problèmes

Questions fréquentes

Des fichiers que Codex n’a pas modifiés apparaissent dans le panneau latéral

Si votre projet se trouve dans un dépôt Git, le panneau de révision affiche automatiquement les modifications en fonction de l’état Git de votre projet, y compris celles que Codex n’a pas effectuées.

Dans le volet de révision, vous pouvez basculer entre les modifications indexées et celles qui ne le sont pas encore, et comparer votre branche à main.

Si vous souhaitez afficher uniquement les modifications du dernier tour de Codex, basculez le volet de différences vers la vue Dernier tour.

En savoir plus sur l’utilisation du volet de révision.

Supprimer un projet de la barre latérale

Pour retirer un projet de la barre latérale, survolez son nom, sélectionnez les trois points, puis choisissez Retirer. Pour le rétablir, ajoutez à nouveau le projet à l’aide du bouton Ajouter un nouveau projet à côté de Conversations ou du raccourci

Cmd+O.

Retrouver les chats archivés

Les chats archivés se trouvent dans les Paramètres. Lorsque vous désarchivez un chat, il réapparaît à son emplacement d’origine dans la barre latérale.

Une conversation Work n’apparaît pas sur un autre appareil

• Vérifiez que vous êtes connecté avec ChatGPT au même compte et au même espace de travail sur chaque appareil.
• Demandez au propriétaire de votre espace de travail de vérifier que Work Cloud et Autoriser l’accès à l’ordinateur local sont activés. Si enforce_residency est activé dans une politique cloud, Autoriser l’accès à l’ordinateur local est désactivé pour Work comme pour dots. Cette mesure de protection ne configure pas la résidence des données de l’espace de travail et ne désactive pas, à elle seule, Work Cloud ou dots.
• Vérifiez la date de création de la tâche. La synchronisation s’applique aux nouvelles tâches créées après son activation. Les tâches existantes, y compris celles des projets, ne sont pas migrées et conservent leur fonctionnement initial : uniquement en local ou dans le cloud sans accès aux fichiers locaux.

Pour les entreprises, le sélecteur Local/Cloud de l’application et son réglage par défaut restent inchangés au lancement. La position du sélecteur ou le mode par défaut ne suffisent pas à confirmer qu’une conversation peut se synchroniser. Lorsque vous recherchez une conversation Work, distinguez-la de l’historique Codex. Consultez Accès à l’ordinateur local pour Work Cloud et dots pour la configuration et la FAQ d’administration de Work pour les questions courantes.

Une tâche synchronisée ne peut pas utiliser les fichiers ou les outils de l’ordinateur

Gardez l’ordinateur en ligne et connecté. S’il est indisponible au début d’un nouveau tour, une tâche synchronisée admissible peut se poursuivre dans un conteneur cloud sans accès aux fichiers ou aux outils de l’ordinateur. Un tour en cours ne passe pas automatiquement de l’ordinateur au cloud.

Un tour s’est arrêté après la désactivation de l’accès à l’ordinateur local avec Work Cloud

La désactivation de l’accès à l’ordinateur local avec Work Cloud interrompt les tours en cours. Si vous avez toujours accès à Work, envoyez un nouveau message pour lancer un autre tour. Dans une conversation cloud existante, ce tour utilise automatiquement Work Cloud sans accès aux fichiers locaux.

Les mises à jour automatisées des politiques sont absentes

Utilisez l’API de gestion des politiques pour gérer les paramètres Global. Pour gérer les paramètres Local ou Codex Cloud, utilisez l’interface Agent Security. Les workflows existants utilisant l’API pour Global restent disponibles après la migration. Testez vos scripts et vos intégrations Terraform, puis vérifiez que les affectations et l’ordre des politiques sont inchangés.

Seuls certains chats apparaissent dans la barre latérale

La barre latérale vous permet de filtrer les chats en fonction de l’état d’un projet. Si des chats sont absents, sélectionnez l’icône de filtre à côté de Chats, puis sélectionnez Chronologique. Si le chat n’apparaît toujours pas, ouvrez les Paramètres et consultez les Chats archivés.

Le code ne s’exécute pas dans un worktree

Les worktrees sont créés dans un répertoire distinct et héritent par défaut des fichiers suivis dans Git. Selon la façon dont vous gérez les dépendances et les outils de votre projet, vous devrez peut-être exécuter des scripts de configuration dans votre worktree à l’aide d’un environnement local ou copier des fichiers de configuration ignorés avec .worktreeinclude. Vous pouvez également récupérer les modifications dans votre projet local habituel. Consultez la documentation sur les worktrees pour en savoir plus.

L’application ne détecte pas l’environnement local partagé d’un membre de l’équipe

La configuration de l’environnement local doit se trouver dans le dossier .codex à la racine de votre projet. Si vous travaillez dans un monorepo contenant plusieurs projets, veillez à ouvrir le projet dans le répertoire qui contient le dossier .codex.

Codex demande l’accès à Apple Music

Selon votre tâche, Codex peut avoir besoin de parcourir le système de fichiers. Certains répertoires de macOS, notamment Musique, Téléchargements ou Bureau, nécessitent une autorisation supplémentaire de votre part. Si Codex doit lire votre répertoire personnel, macOS vous invite à autoriser l’accès à ces dossiers.

Les tâches planifiées créent de nombreux worktrees

Les tâches planifiées fréquentes peuvent créer de nombreux worktrees au fil du temps. Archivez les exécutions planifiées dont vous n’avez plus besoin et évitez d’épingler des exécutions, sauf si vous souhaitez conserver leurs worktrees.

Récupérer un prompt après avoir sélectionné la mauvaise cible

Si vous avez lancé par inadvertance un chat avec la mauvaise cible (Local, Worktree ou Cloud), vous pouvez annuler l’exécution en cours et récupérer votre prompt précédent en appuyant sur la touche fléchée vers le haut dans la zone de saisie.

L’option Approuver pour moi est absente ou désactivée

Pour utiliser la vérification automatique, sélectionnez Approuver pour moi dans le sélecteur d’autorisations sous la zone de saisie. Si ce mode est absent ou désactivé :

1. Mettez à jour l’application de bureau et consultez le menu des autorisations dans la conversation où vous souhaitez utiliser la vérification automatique. Les choix disponibles peuvent varier entre les environnements locaux et cloud.
2. Pour une exécution locale de Codex, vérifiez si votre configuration effective contient le paramètre explicite features.guardian_approval = false et examinez le profil d’autorisations, la politique d’approbation et le responsable de la vérification des approbations configurés. Consultez les Bases de la configuration pour connaître l’ordre de priorité des paramètres. La configuration locale ne contrôle pas un environnement d’exécution cloud géré.
3. Si un mode est désactivé ou absent dans un espace de travail géré, demandez à votre administrateur de vérifier les profils d’autorisations, les modes de sandbox, les politiques d’approbation et les responsables de la vérification des approbations autorisés. La politique de l’organisation ou de l’appareil peut restreindre ces choix ; les paramètres locaux ne peuvent pas y déroger.

Si le mode reste indisponible de manière inattendue, indiquez la version de votre application, le système d’exploitation, l’environnement d’exécution, ainsi que l’absence ou la désactivation de l’option dans votre retour.

Une fonctionnalité fonctionne dans Codex CLI, mais pas dans l’application de bureau ChatGPT

L’application de bureau ChatGPT et Codex CLI peuvent intégrer des versions différentes de Codex, de sorte que certaines fonctionnalités peuvent être disponibles dans une interface avant l’autre.

Pour obtenir la version de Codex CLI installée sur votre système, exécutez :

codex --version

Pour obtenir la version de Codex incluse dans votre application de bureau ChatGPT, utilisez le chemin conservé du bundle de compatibilité Codex.app :

/Applications/Codex.app/Contents/Resources/codex --version

Commentaires et journaux

Saisissez / dans la zone de saisie des messages pour envoyer des commentaires à l’équipe. Si vous déclenchez l’envoi de commentaires dans un chat existant, vous pouvez choisir de partager la session existante avec vos commentaires. Après leur envoi, vous recevrez un identifiant de session que vous pourrez communiquer à l’équipe.

Pour signaler un problème :

1. Recherchez les problèmes existants dans le dépôt GitHub de Codex.
2. Ouvrez un nouveau problème GitHub

D’autres journaux sont disponibles aux emplacements suivants :

• Journaux de l’application (macOS) : ~/Library/Logs/com.openai.codex/YYYY/MM/DD
• Transcriptions des sessions : $CODEX_HOME/sessions (par défaut : ~/.codex/sessions)
• Sessions archivées : $CODEX_HOME/archived_sessions (par défaut : ~/.codex/archived_sessions)

Si vous partagez des journaux, vérifiez-les d’abord afin de confirmer qu’ils ne contiennent aucune information sensible.

États bloqués et méthodes de récupération

Si un chat semble bloqué :

1. Vérifiez si Codex attend une autorisation.
2. Ouvrez le terminal et exécutez une commande simple telle que git status.
3. Démarrez un nouveau chat avec un prompt plus court et plus ciblé.

Si vous annulez par erreur la création d’un worktree et perdez votre prompt, appuyez sur la touche fléchée vers le haut dans la zone de saisie pour la récupérer.

Problèmes de terminal

Le terminal semble bloqué

1. Fermez le panneau du terminal.
2. Rouvrez-le avec Ctrl+`.
3. Exécutez de nouveau une commande simple telle que pwd ou git status.

Si les commandes ne se comportent pas comme prévu, vérifiez d’abord le répertoire et la branche actuels dans le terminal.

S’il reste bloqué, attendez que vos chats actifs soient terminés, puis redémarrez l’application.

Les polices ne s’affichent pas correctement

Codex utilise la même police dans le volet de révision, le terminal intégré et tous les autres extraits de code affichés dans l’application. Vous pouvez configurer cette police dans le volet Paramètres, sous Police du code.

Un environnement autorise l’accès au réseau, mais l’action est bloquée

Vérifiez la priorité des politiques avant de comparer les paramètres individuels. Une politique de priorité supérieure l’emporte sur une politique de priorité inférieure, même si cette dernière est plus spécifique. Au sein d’une même politique, les dérogations d’environnement propres à un système d’exploitation priment sur celles qui s’appliquent à tous les systèmes d’exploitation, puis viennent les paramètres Global.

Certaines exigences réseau comportent des règles de fusion propres à chaque champ et des limites d’exécution. L’environnement d’exécution cloud ne prend pas en charge les ports d’écoute HTTP/SOCKS gérés ni les points d’écoute de proxy sur des adresses autres que celles de bouclage ; la prise en charge des règles de socket dépend du chemin d’exécution. Le comportement de fusion pour l’exécution locale est distinct.

Comparez les politiques effectivement appliquées et testez les actions censées être autorisées ou bloquées. Consultez Configuration gérée pour les cas détaillés. N’élargissez pas les autorisations du socle global pour contourner l’échec d’un test.