Présentation de l'application de bureau
📚 Navigation de la série : Le chapitre précédent 06 · Exécuter une première tâche a guidé la formulation de votre premier prompt d'édition. Ce chapitre détaille l'interface de bureau, considérée comme le canal d'accès privilégié de l'agent. Nous y présentons l'organisation visuelle, les configurations clés, les raccourcis clavier et les fonctionnalités avancées. Le chapitre 08 · Premiers pas avec la CLI complètera ce panorama en abordant l'interface en ligne de commande.
Bien qu'OpenAI propose plusieurs interfaces d'accès pour Codex, l'application de bureau reste au centre des démonstrations et des ressources de documentation.
La documentation officielle y consacre de nombreux chapitres spécifiques : features, commands, settings, review, worktrees, automations, browser, computer-use, local-environments, chrome-extension... Cet investissement témoigne de l'importance de ce canal d'accès.
Certains développeurs considèrent l'application graphique comme une version simplifiée réservée aux novices de la ligne de commande. En réalité, l'application de bureau constitue l'interface la plus riche, intégrant la gestion de tâches parallèles, l'isolation par Worktree, les outils de revues graphiques et les workflows d'automatisation.
Ce chapitre décrit l'organisation de l'interface, la gestion des contextes de travail et les raccourcis de navigation indispensables.
À la fin de ce chapitre, vous obtiendrez :
- Le plan détaillé de l'interface à trois volets (navigation, dialogue, panneau de revue)
- L'analyse comparative des trois modes d'exécution (Local, Worktree et Cloud)
- L'utilisation du panneau de revue visuel (annotations, commits et Pull Requests intégrés)
- Les avantages de l'interface graphique : terminal partagé, boutons Actions et Automations
- Une table de référence des raccourcis clavier et commandes slash, complétée par un exercice pratique
⚠️ Note : Les raccourcis clavier et paramètres mentionnés font référence à la documentation officielle. Les raccourcis Windows sont configurables dans le menu Settings > Keyboard Shortcuts de votre application.
01 Positionnement de l'application de bureau
Pour appréhender l'interface riche de l'application, il convient d'en cerner la logique centrale.
En synthèse : l'application de bureau de Codex est un environnement optimisé pour le multitâche. La documentation la définit comme « a focused desktop experience for working on Codex threads in parallel » (un espace dédié au traitement parallèle de sessions de dialogue). Chaque session d'échange est désignée sous le terme de thread (fil de discussion).
Analogie : L'atelier de production multi-postes. La CLI s'apparente à un poste de travail unique sur lequel vous traitez les tâches séquentiellement. L'application de bureau s'apparente à une supervision d'atelier : vous gérez plusieurs tâches en parallèle (correction de bug sur un module, rédaction de tests unitaires sur un autre, exécution d'un traitement lourd en tâche de fond) et basculez d'un contexte à l'autre en fonction des besoins de validation.
Elle s'appuie sur le même moteur Codex que la CLI ou les extensions IDE, partageant le fichier AGENTS.md (conventions du projet, voir chapitre 02), les configurations MCP et les compétences (Skills). Elle se distingue uniquement par son habillage graphique optimisé pour le multitâche.
Cas d'usage types :
- Gestion de plusieurs correctifs distincts en parallèle sans risque de collision de code.
- Refactorisation d'une application frontend en observant le rendu en temps réel via le navigateur intégré.
- Planification d'une tâche automatique pour générer chaque matin un résumé des commits de la veille.
Ces opérations, complexes à orchestrer en ligne de commande, sont prises en charge nativement par l'application graphique.
💡 En résumé : L'application de bureau est un atelier graphique optimisé pour l'exécution parallèle et la revue de code, partageant les mêmes configurations sous-jacentes que la CLI.
02 Disponibilité et authentification
Note : l'application de bureau n'est pas disponible sous Linux.
Les environnements Linux doivent s'orienter vers l'usage de la CLI en attendant une future publication officielle.
Synthèse des versions disponibles (voir détails d'installation au chapitre 03) :
| Système | Canal d'obtention | Point de vigilance |
|---|---|---|
| macOS (Apple Silicon) | Téléchargement du binaire par défaut | Veiller à ne pas utiliser la version Intel |
| macOS (Intel) | Sélectionner le profil Intel build | Veiller à ne pas utiliser la version Apple Silicon |
| Windows | Microsoft Store ou via winget install Codex -s msstore | Configuration de la sandbox (voir chapitre 03) |
| Linux | Indisponible, s'inscrire sur la liste d'attente | Utiliser la CLI |
Note importante concernant l'authentification :
L'authentification via un compte ChatGPT garantit l'accès à l'intégralité des fonctions. L'usage d'une clé API peut restreindre certains services (la documentation mentionnant « some functionality might not be available »). Privilégiez la connexion par votre compte ChatGPT Plus/Pro pour exploiter pleinement l'application.
💡 En résumé : L'application de bureau cible macOS et Windows (choisissez la version correspondant à votre architecture de processeur). Utilisez un compte ChatGPT pour déverrouiller l'ensemble des fonctionnalités.
03 Organisation de l'interface
L'interface s'articule autour de trois volets principaux : la navigation à gauche, la zone d'échange au centre et la visualisation des résultats à droite.
Le flux d'activité s'effectue de gauche à droite : choix du projet/thread → saisie du prompt → analyse des modifications dans le panneau de droite.
Volet gauche : Navigation et accès
Le volet regroupe les fonctions d'organisation des sessions (les intitulés dépendent de la version installée) :
- New Thread : Initialisation d'une nouvelle session de dialogue.
- Search : Recherche historique au sein des threads et des projets.
- Plugins : Activation des modules complémentaires (navigateur, intégrations GitHub).
- Automations : Gestion des planifications automatiques (voir section 05).
- Projects : Liste des répertoires projets connectés.
- Chats : Discussions hors projets (recherche de documentation, questions générales).
Note : Distinguez les concepts de Project et de Chat.
Analogie : Le collaborateur interne vs le visiteur de passage. Un projet connecte Codex à un répertoire physique local pour y effectuer des écritures de fichiers ou compiler du code. Un chat s'exécute de manière isolée au sein du sous-dossier ~/.codex/threads/ ; il est adapté aux recherches documentaires n'exigeant pas d'accès à vos sources.
Comparatif d'usage :
- Modifier l'implémentation de
~/code/my-app→ Utiliser Project. - Rechercher une règle de syntaxe Rust → Utiliser Chat.
Volet central : Zone de dialogue
La zone centrale affiche le fil de discussion et d'action de l'agent. La zone de saisie inférieure intègre trois sélecteurs à contrôler avant de valider votre prompt :
- Mode d'exécution : Local / Worktree / Cloud (détaillé à la section 04).
- Modèle : Sélection du modèle active.
- Niveau d'approbation : Politique d'autorisation d'écriture.
Volet droit : Panneaux de contrôle
Ce volet escamotable (bouton en haut à droite) regroupe les fonctions de revue :
- Diff Review : Revue visuelle des lignes modifiées.
- Terminal : Console partagée avec l'agent.
- Preview : Rendu des pages web, images ou documents sources.
04 Modes d'exécution : Local, Worktree ou Cloud
Le mode d'exécution sous la zone de saisie définit l'isolation des écritures de l'agent :
| Mode | Environnement | Cible des écritures | Cas d'usage |
|---|---|---|---|
| Local | Répertoire de travail actif | Modifications directes sur votre dossier local | Développement courant avec application immédiate |
| Worktree | Dossier git worktree temporaire | Écritures isolées sans altération du répertoire actif | Tâches parallèles ou modifications exploratoires |
| Cloud | Environnement cloud OpenAI | Sandbox distante (livraison par Pull Request) | Tâches de fond de longue durée préservant les ressources locales |
Note : Les modes Local et Worktree s'exécutent localement sur votre machine. Seul le mode Cloud s'appuie sur une infrastructure distante.
Le mode Worktree assure l'isolation des processus parallèles.
Analogie : Travailler sur des calques séparés. Si vous modifiez simultanément plusieurs fichiers dans le répertoire Local, les écritures peuvent entrer en collision. Le mode Worktree s'appuie sur le mécanisme git worktree pour créer des répertoires de copie isolés. Chaque tâche s'exécute de manière étanche ; vous validez l'intégration du code dans votre branche principale une fois les tests validés.
L'activation du mode Worktree évite les collisions de code lors de l'exécution simultanée de tâches sur un même projet.
Règles d'utilisation du mode Worktree :
- Réservé aux dépôts Git : s'appuie sur le mécanisme natif
git worktree. - N'importe que les fichiers versionnés : les éléments exclus par le fichier
.gitignore(ex. variables d'environnement.env, dossiers de dépendancesnode_modules) ne sont pas recopiés. Configurez des scripts d'initialisation pour ces environnements (voir section 05). - Stockage local : Les répertoires sont créés dans
$CODEX_HOME/worktrees(par défaut~/.codex/worktrees/) en mode « detached HEAD ». - Handoff (Bascule) : L'option Hand off en tête de session permet de transférer les modifications d'un répertoire Worktree vers votre dossier Local principal.
- Nettoyage automatique : Par défaut, Codex conserve les 15 derniers répertoires Worktree et archive les versions antérieures (paramètre configurable).
💡 En résumé : Le mode Local modifie le répertoire principal, le mode Worktree crée des copies isolées, le mode Cloud délègue sur le cloud. Privilégiez le mode Worktree pour les développements parallèles.
05 Avantages de l'interface de bureau
L'interface graphique apporte plusieurs outils visuels absents de la CLI.
1. Le panneau de revue graphique (Review Pane)
Au lieu d'analyser le diff sous forme de texte brut en console, le volet Review Pane permet de parcourir visuellement les modifications, de commenter le code à la ligne et de valider ou rejeter les blocs individuellement.
Analogie : Le passage au mode révision. Valider un diff en CLI s'apparente à la lecture d'une modification textuelle brute ; l'interface graphique offre le confort d'un outil de traitement de texte avec commentaires margés — vous sélectionnez une ligne pour y inscrire une consigne de retouche.
Caractéristiques du panneau de revue :
- Affichage des modifications non commises : inclut l'ensemble des écarts locaux de votre répertoire.
- Filtres de visualisation : permet de cibler les modifications de la dernière étape (Last turn changes), de l'ensemble de la branche (All branch changes), ou de filtrer par état (Staged / Unstaged).
- Commentaires à la ligne : au survol d'une ligne, cliquez sur le bouton + pour ajouter une annotation. Demandez ensuite à Codex d'appliquer les corrections correspondantes.
- Actions granulaires : validation (stage) ou réversion (revert) applicable au niveau d'un bloc de code (hunk), d'un fichier ou de l'ensemble des modifications.
审完还能直接发出去 : Les modifications validées peuvent faire l'objet de commits, de pushs ou de Pull Requests directement depuis l'interface.
Note : La revue de Pull Requests GitHub exige l'installation et la connexion de l'utilitaire GitHub CLI (gh) sur votre machine.
2. Le terminal intégré
Chaque thread dispose d'une console dédiée s'exécutant dans son répertoire (bouton terminal ou raccourci Cmd + J sous macOS).
Cette console partage le contexte de l'agent. Les commandes de test ou de contrôle s'exécutent sur la version active du code, et Codex peut analyser les retours de la console pour diagnostiquer un échec de compilation.
Attention : le raccourcis
Cmd + Kouvre le menu de commandes. UtilisezCtrl + Lpour vider le terminal.
3. Les boutons Actions
Configurez vos scripts récurrents (lancement de tests, build) sous forme d'Actions accessibles par boutons graphiques.
Ces raccourcis exécutent les scripts déclarés au sein de la console intégrée.
Les Actions se configurent dans le répertoire .codex du projet (section Local Environments), aux côtés des scripts d'initialisation de Worktree. Versionnées, elles se partagent entre développeurs du projet.
4. Les tâches automatisées (Automations)
La section Automations permet de planifier des tâches de fond récurrentes.
Exemples d'automations courantes :
- Résumé d'activité quotidien analysant les commits de la veille.
- Diagnostic régulier et résolution automatique de rapports d'erreurs.
- Réactivation planifiée de sessions de travail pour poursuivre des analyses de fond.
Prérequis : L'application Codex doit rester ouverte et le répertoire accessible localement pour exécuter les automations.
💡 En résumé : Le panneau de revue, le terminal intégré contextuel, les boutons Actions et les planifications Automations constituent les forces de l'interface de bureau.
06 Raccourcis et commandes slash de référence
Prenez note de la remarque d'architecture clavier suivante :
Les raccourcis Windows de l'application sont listés et configurables dans le menu Settings > Keyboard Shortcuts.
Raccourcis clavier recommandés sous macOS (source : document de référence Commands) :
| Raccourci macOS | Action | Intérêt |
|---|---|---|
Cmd + Shift + P ou Cmd + K | Ouvrir le menu de commandes | Accès global à l'ensemble des fonctions |
Cmd + N ou Cmd + Shift + O | Créer un thread | Lancement rapide d'une nouvelle session |
Cmd + J | Ouvrir/Fermer le terminal | Accès rapide à la console de test |
Cmd + B | Masquer/Afficher le volet gauche | Optimisation de l'espace de dialogue |
Cmd + Option + B | Masquer/Afficher la revue diff | Contrôle visuel rapide |
Cmd + G | Rechercher dans l'historique | Retrouver une ancienne session |
Cmd + F | Rechercher dans le thread | Recherche textuelle dans la session active |
Cmd + , | Ouvrir les paramètres | Configuration globale (MCP, Git, apparence) |
Ctrl + L | Vider la console | Nettoyage de l'écran du terminal |
Ctrl + M | Dictée vocale | Saisie vocale convertie en texte |
Les commandes slash (saisie du caractère / dans la zone de prompt) configurent la session :
| Commande slash | Action |
|---|---|
/status | Affiche l'ID de session, la taille du contexte et le quota |
/review | Active la revue des modifications locales |
/plan | Active/Désactive la rédaction d'un plan d'action |
/goal | Assigne un objectif de fond persistant |
/mcp | Liste l'état des serveurs MCP connectés |
/feedback | Soumission de rapport d'anomalie |
💡 En résumé : Raccourcis prioritaires :
Cmd + K(actions) etCmd + N(nouveau thread). Commandes slash prioritaires :/status(mesure du quota) et/review(revue).
07 Exercice pratique : exécution de tâches parallèles
Exercice pour manipuler les Worktrees et le Review Pane de l'application :
Prérequis : Codex doit être connecté via un compte ChatGPT Plus/Pro sur un répertoire géré par Git.
Étape 1 : Ouvrir le projet et sélectionner le mode Worktree
Ouvrez le projet et sélectionnez le mode Worktree sous la zone de saisie.
✅ Validation : L'application propose d'indiquer la branche git de départ. Si une alerte exige un dépôt, lancez git init dans le répertoire.
Étape 2 : Lancer le premier thread
Saisissez la consigne suivante :
找一处 TODO 注释，把它实现掉Ou :
给这个项目的 README 补一段「如何本地运行」的说明L'agent crée une instance git worktree isolée et y applique les écritures. Votre répertoire local actif reste inchangé.
Étape 3 : Lancer un second thread en parallèle
Cliquez sur New Thread, configurez-le également en mode Worktree et lancez :
把项目里所有 console.log 调试输出清理掉✅ Résultat attendu : Deux threads distincts s'exécutent simultanément sur des répertoires de copie isolés. Vous pouvez basculer de l'un à l'autre pour suivre l'avancement.
Étape 4 : Valider avec le Review Pane
Sélectionnez une session terminée et ouvrez le panneau Diff Review (Cmd + Option + B sous macOS) pour analyser les modifications :
Actions de test :
- Survoler une ligne et cliquer sur + pour ajouter une remarque (ex. « ajoute un commentaire ici »). Renvoyez ensuite le prompt pour appliquer l'ajustement.
- Valider (stage) ou annuler (revert) des blocs spécifiques.
✅ Résultat attendu : Les écritures restent cantonnées au répertoire de copie temporaire tant que vous ne validez pas les commits, sécurisant votre branche principale.
Étape 5 (Optionnelle) : Handoff vers le dossier Local
Si les modifications d'un Worktree sont validées, cliquez sur le bouton Hand off pour réintégrer les modifications au sein de votre répertoire Local actif.
✅ Résultat attendu : Le code est réintégré au répertoire de travail principal pour poursuite des développements sous votre IDE.
💡 En résumé : Initialiser des threads en mode Worktree, relire les propositions via le Review Pane, commenter à la ligne et valider l'intégration sécurise votre workflow de développement.
08 Résumé
Ce chapitre a présenté les concepts clés de l'application de bureau de Codex :
- Positionnement : atelier graphique optimisé pour le multitâche et les revues de code, s'appuyant sur les mêmes configurations locales que la CLI.
- Compatibilité : macOS et Windows (Linux non supporté) ; authentification par compte ChatGPT recommandée.
- Organisation : trois volets principaux (navigation, dialogue et revue). Distinction stricte entre projets (droits d'écriture) et chats (analyse libre).
- Modes d'isolation : modifications directes (Local), copies isolées via
git worktree(Worktree) ou exécutions distantes (Cloud). - Outils graphiques : volet de revue interactif, console intégrée, raccourcis Actions et tâches planifiées.
- Raccourcis et commandes slash : usage de
Cmd + K,Cmd + N,/statuset/reviewpour fluidifier le travail.
Le chapitre suivant 08 · Premiers pas avec la CLI décrit l'usage de Codex en ligne de commande, indispensable pour les exécutions headless sur serveurs, l'intégration dans des scripts et les pipelines de CI/CD.