Codex CLI ou Codex App : quelles différences et que choisir ?
Choisir entre Codex CLI et l'application de bureau selon le workflow, les tâches parallèles, les diffs et l'authentification.
Codex CLI convient lorsque le travail est déjà dans un terminal, sur une machine distante ou dans des scripts. L'application de bureau est plus adaptée à plusieurs tâches parallèles, à la relecture visuelle des diffs et au suivi des projets. Ce sont deux interfaces de Codex, pas deux modèles. Avec un fournisseur personnalisé, le client compte aussi pour l'authentification : CLI et Desktop App partagent un schéma, l'extension VS Code en utilise un autre.
Codex CLI ou Codex App : réponse rapide
OpenAI indique que l'application de bureau peut reprendre l'historique et la configuration de la CLI et de l'extension IDE. Cela facilite le passage d'une interface à l'autre, sans en faire le même environnement : variables d'environnement, redémarrage et vérification restent propres au client. Les subagents existent dans les deux interfaces; l'App se distingue par la gestion visuelle des fils, worktrees et diffs.
Où s'applique réellement un fournisseur personnalisé
BetterToken fournit un accès API aux outils compatibles OpenAI. Codex utilise le client officiel OpenAI, un fournisseur personnalisé, la Base URL https://www.bettertoken.ai/v1 et le protocole Responses. BetterToken ne remplace ni Codex, ni la connexion ChatGPT, ni l'installation : utilisez votre propre compte BetterToken et votre propre API Key.
Identifiez d'abord le point de départ :
- La commande
codexdans Terminal est la CLI. - Codex dans l'application de bureau est la Desktop App.
- Le panneau Codex dans VS Code est l'extension.
Les trois lisent ~/.codex/config.toml (sous Windows, %USERPROFILE%\.codex\config.toml), mais l'authentification diffère.
Les deux modes utilisent une seule section [model_providers.custom]. Ne créez pas deux sections de même nom dans le même TOML. Vérifiez les champs exacts et le Model ID actuel dans les guides Codex CLI/Desktop App et Codex VS Code Extension.
L'App et l'extension IDE peuvent ne pas recevoir une variable définie uniquement dans le profil shell. Si un nouveau processus ne voit pas BETTERTOKEN_API_KEY, suivez le guide actuel propre au client, redémarrez complètement le client et ouvrez une session neuve. Ne mettez jamais la clé dans un article, une capture ou un dépôt partagé.
Confirmer que le fournisseur est appliqué
Après redémarrage, envoyez une tâche courte. Dans la CLI, ouvrez /status et vérifiez le fournisseur. Après une réponse depuis CLI, Desktop App ou VS Code, trouvez dans le Dashboard BetterToken l'enregistrement correspondant à l'heure et au modèle : il confirme le passage de la requête par BetterToken. Une ancienne session ne teste pas proprement une configuration modifiée. L'absence de 401, 403 ou model not found ne suffit pas à identifier le fournisseur ou la Base URL.
Différences de workflow
CLI : terminal, SSH et commandes reproductibles
La CLI s'exécute dans le processus shell courant. Le mode interactif convient au dépôt, codex exec aux tâches et scripts non interactifs, et /agent permet d'inspecter ou de changer de subagent. Elle s'intègre facilement à SSH, un conteneur, un contrôle CI ou des commandes existantes. Le travail parallèle est possible, mais vous organisez généralement vous-même répertoires, processus et résultats; utilisez des worktrees distincts lorsque deux tâches ne doivent pas modifier la même copie.
Desktop App : projets, fils et diffs visuels
La Desktop App rassemble plusieurs tâches. Les fils isolent le contexte, les worktrees intégrés isolent les modifications, et le diff se relit à côté de la conversation. Elle est pratique lorsqu'un correctif, une fonctionnalité et une revue avancent simultanément. La disponibilité, les noms et les emplacements de l'interface de bureau peuvent changer avec les mises à jour ; consultez la page de téléchargement officielle avant toute installation ou mise à jour.
Quel choix pour votre cas ?
Choisissez la CLI si
- vous travaillez surtout dans Terminal, SSH ou un conteneur;
- vous avez besoin de
codex exec, de scripts shell et d'une planification externe; - une séquence de commandes reproductible compte;
- vous gérez vous-même les répertoires parallèles.
Choisissez la Desktop App si
- plusieurs tâches ou projets tournent en même temps;
- les diffs et commentaires sont plus simples à relire graphiquement;
- worktrees et files de résultats doivent rester visibles au même endroit;
- la tâche commence par un document, une recherche ou une opération plutôt que par une commande.
Utilisez les deux interfaces si
Utilisez la CLI pour les machines distantes et l'automatisation, l'App pour la gestion et la relecture. L'historique et la configuration partagés facilitent le passage, mais vérifiez avant chaque exécution le répertoire, les permissions, le fournisseur actif et l'authentification.
Erreurs fréquentes de fournisseur
Cela fonctionne en CLI, pas dans VS Code
CLI/Desktop App et l'extension n'utilisent pas les mêmes champs d'authentification. Ne copiez pas env_key dans l'extension comme solution complète et n'écrasez pas le auth.json officiel avec une BetterToken API Key. Consultez le guide de l'extension et lancez Reload Window.
Codex redemande la connexion officielle
Pour un fournisseur personnalisé dans CLI/Desktop App, vérifiez que le nouveau processus accède à BETTERTOKEN_API_KEY. Dans l'extension, la connexion officielle reste nécessaire et un champ séparé fournit la clé des requêtes de modèle.
Fournisseur introuvable
model_provider = "custom" doit correspondre à [model_providers.custom]. Supprimez les doublons et vérifiez wire_api = "responses".
La configuration est enregistrée, mais rien ne change
Quittez l'ancien processus, ouvrez un nouveau terminal ou lancez Reload Window, puis créez une nouvelle session. Si l'App ne voit pas la clé du shell, suivez le guide actuel du client et redémarrez complètement. Contrôlez ensuite, un par un, Model ID, API Key, Base URL et mode d'authentification.
Choix final
Choisissez Codex CLI pour le terminal, SSH, les scripts et la gestion directe des processus. Choisissez la Desktop App pour les tâches parallèles, les worktrees et la relecture visuelle. Avec un fournisseur personnalisé, choisissez d'abord le client, appliquez son schéma d'authentification et confirmez le résultat dans une nouvelle session courte.
Les paramètres BetterToken à jour figurent dans le guide Codex; pour VS Code, consultez le guide distinct de l'extension.